2017 © Pedro Peláez
 

library api-cielo30

Client for Cielo's 3.0 API

image

jlcd/api-cielo30

Client for Cielo's 3.0 API

  • Saturday, April 15, 2017
  • by jlcd
  • Repository
  • 1 Watchers
  • 2 Stars
  • 287 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 0 Forks
  • 1 Open issues
  • 3 Versions
  • 23 % Grown

The README.md

Client para API Cielo 3.0

Instalação

Via composer: composer require jlcd/api-cielo30, (*1)

Caso esteja utilizando Laravel (5+), sugiro trabalhar com o Provider criado especialmente para esse Client: jlcd/api-cielo30-laravel, (*2)

Versão mínima do PHP: 5.6, (*3)

Configuração

Merchant ID, Merchant Key e Environment deverão ser passados diretamente no construtor da classe Cielo., (*4)

Ex.:, (*5)

<?php

use jlcd\Cielo\Cielo;

$cielo = new Cielo(CIELO_ID, CIELO_KEY, CIELO_ENVIRONMENT);

Os valores aceitos para CIELO_ENVIRONMENT são:, (*6)

  • sandbox
  • production

Utilização

Os métodos atualmente desenvolvidos neste client são: - payment: Realiza pagamento (apenas via Cartão de Crédito ou token de Cartão de Crédito) - cancelPayment: Cancelamento de pagamento já realizado - capturePayment: Captura de pagamento já realizado - tokenizeCreditCard: Tokenização de Cartão, (*7)

Realizar pagamento

<?php

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

$cielo = new Cielo(CIELO_ID, CIELO_KEY, CIELO_ENVIRONMENT);

$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'); // Numero de identificacao personalizado

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

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

var_dump($payment);

Cancelar pagamento

<?php

use jlcd\Cielo\Cielo;
use jlcd\Cielo\Resources\CieloPayment;

$cielo = new Cielo(CIELO_ID, CIELO_KEY, CIELO_ENVIRONMENT);

$payment = new CieloPayment();
$payment->setId('PAYMENT_ID'); // Id retornado de um pagamento realizado na Cielo
$payment->setValue(1541);

$payment = $cielo->cancelPayment($payment);

var_dump($payment);

Capturar pagamento

<?php

use jlcd\Cielo\Cielo;
use jlcd\Cielo\Resources\CieloPayment;

$cielo = new Cielo(CIELO_ID, CIELO_KEY, CIELO_ENVIRONMENT);

$payment = new CieloPayment();
$payment->setId('PAYMENT_ID'); // Id retornado de um pagamento realizado na Cielo
$payment->setValue(1541);

$payment = $cielo->capturePayment($payment);

var_dump($payment);

Tokenizar Cartão

<?php

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

$cielo = new Cielo(CIELO_ID, CIELO_KEY, CIELO_ENVIRONMENT);

$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 = $cielo->tokenizeCreditCard($creditCard, $customer);

var_dump($token);

Realizar pagamento via Token de Cartão

<?php

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

$cielo = new Cielo(CIELO_ID, CIELO_KEY, CIELO_ENVIRONMENT);

$payment = new CieloPayment();
$payment->setValue(1541);

$creditCard = new CieloCreditCard();
$creditCard->setBrand('visa');
$creditCard->setToken('TOKEN_DO_CARTAO'); // Gerado via tokenizeCreditCard
$creditCard->setSecurityCode('888');
$payment->setCreditCard($creditCard);

$order = new CieloOrder();
$order->setId('123'); // Numero de identificacao personalizado

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

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

var_dump($payment);

Restrições

Versão mínima do PHP: 5.6, (*8)

Os valores aceitos para CieloCreditCard::brand são como vistos no campo CreditCard.Brand em https://developercielo.github.io/Webservice-3.0/?json#criando-uma-transação-simples ., (*9)


Para sugestões ou reportar bugs, utilize jlcd/api-cielo30/issues., (*10)

The Versions

15/04 2017

dev-master

9999999-dev

Client for Cielo's 3.0 API

  Sources   Download

Apache-2.0

The Requires

 

by Joao Drummond

api cielo

15/04 2017

dev-develop

dev-develop

Client for Cielo's 3.0 API

  Sources   Download

Apache-2.0

The Requires

 

by Joao Drummond

api cielo

15/04 2017

0.1.0

0.1.0.0

Client for Cielo's 3.0 API

  Sources   Download

Apache-2.0

The Requires

 

by Joao Drummond

api cielo