jlcd / api-cielo30-laravel by jlcd

Laravel Provider for Cielo's 3.0 API
224,480
16
2
Package Data
Maintainer Username: jlcd
Maintainer Contact: jldrummond@gmail.com (João Drummond)
Package Create Date: 2017-04-14
Package Last Update: 2019-10-11
Language: PHP
License: Apache-2.0
Last Refreshed: 2024-12-03 03:04:29
Package Statistics
Total Downloads: 224,480
Monthly Downloads: 0
Daily Downloads: 0
Total Stars: 16
Total Watchers: 2
Total Forks: 7
Total Open Issues: 1

Provider Laravel para API Cielo 3.0 (Client jlcd/api-cielo30)

Descrição

Este provider utiliza o client jlcd/api-cielo30, que por sua vez utiliza o sdk oficial da Cielo.

Qualquer issue referente à comunicação com a Cielo deverá ser tratado diretamente nos issues do client.

Versões do Laravel anteriores à 5.0 não foram testadas e o funcionamento não é garantido.

Instalação

Via Composer: composer require jlcd/api-cielo30-laravel

Laravel

Incluir o código abaixo na posição providers no arquivo boostrap/app.php

(...)

   'providers' => [

    (...)

        /*
         * Package Service Providers...
         */

        // Cielo
        jlcd\CieloLaravel\CieloServiceProvider::class,

    (...)

    ],

(...)

Executar php artisan vendor:publish no projeto.

Lumen

Criar o arquivo config/cielo.php:

<?php

return [

    'merchant_id'  => env('CIELO_ID', 'default_id'),
    'merchant_key' => env('CIELO_KEY', 'default_key'),
    'environment'  => env('CIELO_ENV', 'default_environment'), // production | sandbox

];

Incluir o código abaixo em bootstrap/app.php:

(...)

$app->configure('cielo');
$app->register(jlcd\CieloLaravel\CieloServiceProvider::class);

(...)

Configuração

As variáveis de ambiente CIELO_ID, CIELO_KEY e CIELO_ENV deverão ser configuradas no arquivo .env.

Os valores aceitos para CIELO_ENV são:

  • sandbox
  • production

Ex.:

CIELO_ID=123435678
CIELO_KEY=25fbb99341c739dd84a7b06ec78c2cac718838630f30b182d033ce2e621c34f3
CIELO_ENV=sandbox

Como alternativa, após vendor:publish, as configurações poderão ser incluídas diretamente no arquivo de configuração config/cielo.php.

Utilização

Exemplo utilizando o arquivo routes/web.php:

Realizar pagamento

<?php

use jlcd\Cielo\Resources\CieloPayment;
use jlcd\Cielo\Resources\CieloCreditCard;
use jlcd\Cielo\Resources\CieloCustomer;
use jlcd\Cielo\Resources\CieloOrder;

Route::get('/', function () {
    $payment = new CieloPayment();
    $payment->setValue(1541);

    $creditCard = new CieloCreditCard();
    $creditCard->setCardNumber('1234432112344321');
    $creditCard->setExpirationDate('12/2018');
    $creditCard->setBrand('visa');
    $creditCard->setSecurityCode('888');
    $creditCard->setHolder('Fulano');
    $payment->setCreditCard($creditCard);

    $order = new CieloOrder();
    $order->setId('123');

    $customer = new CieloCustomer();
    $customer->setName('Fulano');

    $payment = app()->cielo->payment($payment, $order, $customer);
    dd($payment);
});

Cancelar pagamento

<?php

use jlcd\Cielo\Resources\CieloPayment;

Route::get('/cancel/{id}', function ($id) {
    $payment = new CieloPayment();
    $payment->setId($id);
    $payment->setValue(1541);

    $payment = app()->cielo->cancelPayment($payment);
    dd($payment);
});

Capturar pagamento

<?php

use jlcd\Cielo\Resources\CieloPayment;
Route::get('/capture/{id}', function ($id) {
    $payment = new CieloPayment();
    $payment->setId($id);
    $payment->setValue(1541);

    $payment = app()->cielo->capturePayment($payment);
    dd($payment);
});

Tokenizar Cartão

<?php

use jlcd\Cielo\Resources\CieloCreditCard;
use jlcd\Cielo\Resources\CieloCustomer;

Route::get('/tokenize', function () {
    $creditCard = new CieloCreditCard();
    $creditCard->setCardNumber("1234432112344321");
    $creditCard->setHolder("Comprador T Cielo");
    $creditCard->setExpirationDate("12/2018");
    $creditCard->setBrand("Visa");

    $customer = new CieloCustomer();
    $customer->setName('Fulano');

    $token = app()->cielo->tokenizeCreditCard($creditCard, $customer);
    dd($token);
});

Realizar pagamento via Token de Cartão

<?php

use jlcd\Cielo\Resources\CieloPayment;
use jlcd\Cielo\Resources\CieloCreditCard;
use jlcd\Cielo\Resources\CieloCustomer;
use jlcd\Cielo\Resources\CieloOrder;

Route::get('/paymenttoken/{id}', function ($id) {
    $payment = new CieloPayment();
    $payment->setValue(1541);

    $creditCard = new CieloCreditCard();
    $creditCard->setBrand('visa');
    $creditCard->setToken($id);
    $creditCard->setSecurityCode('888');
    $payment->setCreditCard($creditCard);

    $order = new CieloOrder();
    $order->setId('123');

    $customer = new CieloCustomer();
    $customer->setName('Fulano');

    $payment = app()->cielo->payment($payment, $order, $customer);
    dd($payment);
});


Para maiores detalhes vide repositório do client utilizado (jlcd/api-cielo30) e a documentação oficial.