nibblelab / boletobancario-php
client for BoletoBancario's Boleto Fácil REST API
Requires
- php: ^7.1.0
- lib-curl: *
This package is auto-updated.
Last update: 2024-09-23 01:55:52 UTC
README
A especificação da API pode ser encontrada em https://www.boletobancario.com/boletofacil/integration/integration.html
Pré requisitos
- PHP >= 7.1.0
- libcurl
- composer
Instalação
Instale pelo composer
$ composer require nibblelab/boletobancario-php
Requisição de Pagamento
Para requisitar um pagamento primeiro crie os dados do mesmo, assim como quem está pagando
include './vendor/autoload.php';
use BoletoFacil\Payment\PaymentItem;
use BoletoFacil\Payment\Payer;
use BoletoFacil\BoletoFacil;
$item = new PaymentItem();
$item->setDescricao("Descrição"); # texto de descrição do pagamento
$item->setDataVencimento("99/99/9999"); # data de vencimento, no formato DD/MM/YYYY
$item->setValor(10.50); # valor do pagamento
$item->setReferencia("Id interno"); # referência do pagamento que me permita linkar o registro interno do meu sistema com o do boleto fácil
$pagador = new Payer();
$pagador->setNome("Teste de Teste"); # nome do pagador
$pagador->setCpfCnpj("099.999.999-99"); # CPF do pagador
Pagamento via Boleto
$token = "seu_token"; # token de produção ou sandbox
try
{
//$b = new BoletoFacil($token,"sua url de notificação",true); # modo sandbox
$b = new BoletoFacil($token,"sua url de notificação"); # modo produção
$url = $b->gerarBoleto($item, $pagador); # gera o boleto e obtem a URL de checkout
}
catch(Exception $ex)
{
echo $ex->getMessage();
}
Pagamento via Carnê
$item->setParcelas(2); # carnê possui duas ou mais parcelas
$token = "seu_token"; # token de produção ou sandbox
try
{
//$b = new BoletoFacil($token,"sua url de notificação",true); # modo sandbox
$b = new BoletoFacil($token,"sua url de notificação"); # modo produção
$urls = $b->gerarCarne($item, $pagador); # gera o boleto e obtem as URLs de checkout
}
catch(Exception $ex)
{
echo $ex->getMessage();
}
Pagamento via Cartão
$token = "seu_token"; # token de produção ou sandbox
try
{
//$b = new BoletoFacil($token,"sua url de notificação",true); # modo sandbox
$b = new BoletoFacil($token,"sua url de notificação"); # modo produção
$url = $b->gerarPagtoCartao($item, $pagador); # gera o pagamento e obtem a URL de checkout
}
catch(Exception $ex)
{
echo $ex->getMessage();
}
Pagamento via Cartão com antecipação de parcelas
$token = "seu_token"; # token de produção ou sandbox
try
{
//$b = new BoletoFacil($token,"sua url de notificação",true); # modo sandbox
$b = new BoletoFacil($token,"sua url de notificação"); # modo produção
$url = $b->gerarPagtoCartao($item, $pagador, true); # gera o pagamento e obtem a URL de checkout
}
catch(Exception $ex)
{
echo $ex->getMessage();
}
Pagamento via Cartão ou boleto
$token = "seu_token"; # token de produção ou sandbox
$antecipar = false; # flag para permitir ou não a antecipação de parcelas
try
{
//$b = new BoletoFacil($token,"sua url de notificação",true); # modo sandbox
$b = new BoletoFacil($token,"sua url de notificação"); # modo produção
$url = $b->gerarBoletoOuCartao($item, $pagador, $antecipar); # gera o pagamento e obtem a URL de checkout
}
catch(Exception $ex)
{
echo $ex->getMessage();
}
Pagamento Transparente via Cartão
O hash do cartão é obrigatório nessa modalidade de pagamento. Instruções de como gerar esse campo estão em: https://www.boletobancario.com/boletofacil/integration/integration.html#credit_card_hash
$token = "seu_token"; # token de produção ou sandbox
$hash_cartao = "hash_cartao"; # hash do cartão de crédito
try
{
//$b = new BoletoFacil($token,"sua url de notificação",true); # modo sandbox
$b = new BoletoFacil($token,"sua url de notificação"); # modo produção
$b->gerarPagtoCartaoTransparente($item, $pagador, $hash_cartao); # gera o pagamento
$status = $b->getPaymentResponse()->getData()->getPayments()[0]->getStatus(); # obtendo o status da transação
if($status == 'AUTHORIZED' || $status == 'CONFIRMED') # pagamento permitido
{
$id_cartao = $b->getPaymentResponse()->getData()->getPayments()[0]->getCreditCardId(); # obtendo o id do cartão
}
else if($status == 'DECLINED' || $status == 'FAILED' || $status == 'NOT_AUTHORIZED') # pagamento não permitido
{
}
}
catch(Exception $ex)
{
echo $ex->getMessage();
}
Pagamento Transparente via Cartão com armazenamento de cartão
O hash do cartão é obrigatório nessa modalidade de pagamento. Instruções de como gerar esse campo estão em: https://www.boletobancario.com/boletofacil/integration/integration.html#credit_card_hash
É possível armazenar o cartão de crédito para futuros pagamentos. Se for o caso, o Boleto Fácil gerará um id que pode ser enviado em futuras transações de pagamento transparente.
$token = "seu_token"; # token de produção ou sandbox
$hash_cartao = "hash_cartao"; # hash do cartão de crédito
$id_cartao = ''; # id de cartão previamente armazenado
$armazenar_cartao = true; # flag para indicar se o cartão será armazenado ou não
try
{
//$b = new BoletoFacil($token,"sua url de notificação",true); # modo sandbox
$b = new BoletoFacil($token,"sua url de notificação"); # modo produção
$b->gerarPagtoCartaoTransparente($item, $pagador, $hash_cartao, $id_cartao, $armazenar_cartao); # gera o pagamento
$status = $b->getPaymentResponse()->getData()->getPayments()[0]->getStatus(); # obtendo o status da transação
if($status == 'AUTHORIZED' || $status == 'CONFIRMED') # pagamento permitido
{
}
else if($status == 'DECLINED' || $status == 'FAILED' || $status == 'NOT_AUTHORIZED') # pagamento não permitido
{
}
}
catch(Exception $ex)
{
echo $ex->getMessage();
}
Notificação de Pagamento
A API Boleto Fácil notifica as mudanças no status do pagamento para a url que informou durante a requisição de pagamento.
Para processar essa notificação e obter os dados use
include './vendor/autoload.php';
use BoletoFacil\BoletoFacil;
$token = "seu_token"; # token de produção ou sandbox
try
{
//$b = new BoletoFacil($token,"",true); # modo sandbox
$b = new BoletoFacil($token); # modo produção
$b->processarNotificacao(); # processa a requisição
$valor_pago = $b->getNotificationResponse()->getValorPago(); # obtendo o valor pago
$valor_taxas = $b->getNotificationResponse()->getValorTaxas(); # obtendo o valor das taxas
$valor_cobrado = $b->getNotificationResponse()->getValorCobrado(); # obtendo o valor cobrado
$referencia = $b->getNotificationResponse()->getPagtoReferencia(); # obtendo a referência do pagamento fornecida durante o pagamento
}
catch(Exception $ex)
{
echo $ex->getMessage();
}
Busca de cobranças
Pela data de vencimento
include './vendor/autoload.php';
use BoletoFacil\BoletoFacil;
$token = "seu_token"; # token de produção ou sandbox
try
{
//$b = new BoletoFacil($token,"",true); # modo sandbox
$b = new BoletoFacil($token); # modo produção
$pagamentos = $b->buscarCobrancasPorDataVencimento('99/99/9999'); # busca as cobranças que venceram após a data fornecida
# itere
foreach($cobrancas as $c)
{
$data_vencimento = $c->getDueDate(); # data de vencimento
# liste os pagamentos do registro
foreach($c->todosOsPagamentos() as $p) {
$data_pagto = $p->getDate(); # data do pagamento
$valor_pago = $p->getAmount(); # valor pago
$valor_taxas = $p->getFee(); # valor das taxas
$tipo_pagto = $p->getType(); # tipo do pagamento
$status_pagto = $p->getStatus(); # status do pagamento
}
}
}
catch(Exception $ex)
{
echo $ex->getMessage();
}
Pela data de pagamento
include './vendor/autoload.php';
use BoletoFacil\BoletoFacil;
$token = "seu_token"; # token de produção ou sandbox
try
{
//$b = new BoletoFacil($token,"",true); # modo sandbox
$b = new BoletoFacil($token); # modo produção
$cobrancas = $b->buscarCobrancasPorDataPagto('99/99/9999'); # busca as cobranças que foram pagas após a data fornecida
# itere
foreach($cobrancas as $c)
{
$data_vencimento = $c->getDueDate(); # data de vencimento
# liste os pagamentos do registro
foreach($c->todosOsPagamentos() as $p) {
$data_pagto = $p->getDate(); # data do pagamento
$valor_pago = $p->getAmount(); # valor pago
$valor_taxas = $p->getFee(); # valor das taxas
$tipo_pagto = $p->getType(); # tipo do pagamento
$status_pagto = $p->getStatus(); # status do pagamento
}
}
}
catch(Exception $ex)
{
echo $ex->getMessage();
}
Pela data de confirmação de pagamento
include './vendor/autoload.php';
use BoletoFacil\BoletoFacil;
$token = "seu_token"; # token de produção ou sandbox
try
{
//$b = new BoletoFacil($token,"",true); # modo sandbox
$b = new BoletoFacil($token); # modo produção
$cobrancas = $b->buscarCobrancasPorDataConfirmacaoPagto('99/99/9999'); # busca as cobranças que tiveram pagamento confirmado após a data fornecida
# itere
foreach($cobrancas as $c)
{
$data_vencimento = $c->getDueDate(); # data de vencimento
# liste os pagamentos do registro
foreach($c->todosOsPagamentos() as $p) {
$data_pagto = $p->getDate(); # data do pagamento
$valor_pago = $p->getAmount(); # valor pago
$valor_taxas = $p->getFee(); # valor das taxas
$tipo_pagto = $p->getType(); # tipo do pagamento
$status_pagto = $p->getStatus(); # status do pagamento
}
}
}
catch(Exception $ex)
{
echo $ex->getMessage();
}
License
Este projeto está licenciado com Apache - veja LICENSE.md pra mais detalhes