README

这个库允许您通过您的系统连接到https://dev.bankon.com.br。

这个库不是官方的。然而，我认为它是功能性的，因为我总是添加新的工具。

API 文档

官方 API Rest 文档在这里：https://dev.bankon.com.br

安装

您可以使用 Composer

Composer

最方便的方法是通过composer。如果您还没有安装 composer，请按照说明进行操作。

在项目根目录下执行以下命令以安装库

composer require phabloraylan/bankon-php-sdk

将自动加载器包含到您的项目中

require_once 'vendor/autoload.php';

查询余额

获取账户余额信息

use BankOn\Cliente;
use BankOn\Services\Consultas\Saldo;
use BankOn\Exceptions\BankOnException;

$cliente = new Cliente;
$cliente->setTokenConsulta("TOKEN_CONSULTA");

try{
    $saldo = Saldo::get($cliente);

    echo $saldo->getValorDisponivel();
    echo $saldo->getUsuario();

}catch(BankOnException $e){
    echo $e->getMessage();
}

查询转账

获取转账信息

use BankOn\Cliente;
use BankOn\Services\Consultas\Transferencia;
use BankOn\Exceptions\BankOnException;

$cliente = new Cliente;
$cliente->setTokenConsulta("TOKEN_CONSULTA");

$codigo = "xxxxxxxx";

try{
    $transferencia = Transferencia::get($cliente,$codigo);

    echo $transferencia->getData();
    echo $transferencia->getValor();
    echo $transferencia->getOrigemUsuario();
    echo $transferencia->getOrigemNome();
    echo $transferencia->getOrigemDocumento();
    echo $transferencia->getDestinoUsuario();
    echo $transferencia->getDestinoNome();
    echo $transferencia->getDestinoDocumento();
    $transferencia->getDataCarbon();// retorna a data pra ser usada com a biblioteca https://carbon.nesbot.com/

}catch(BankOnException $e){
    echo $e->getMessage();
}

查询用户

获取用户信息

use BankOn\Cliente;
use BankOn\Services\Consultas\Usuario;
use BankOn\Exceptions\BankOnException;

$cliente = new Cliente;
$cliente->setTokenConsulta("TOKEN_CONSULTA");

$usuario = "fulanodetal";

try{
    $usuario = Usuario::get($cliente, $usuario);

    echo $usuario->getDocumento();
    echo $usuario->getNome();
    echo $usuario->getUsuario();
    echo $usuario->getEmail();
    echo $usuario->getCidade();
    echo $usuario->getEstado();

}catch(BankOnException $e){
    echo $e->getMessage();
}

新建转账

将您的账户中的金额转账给第三方

use BankOn\Cliente;
use BankOn\Services\Financeiro\NovaTransferencia;
use BankOn\Services\Financeiro\Transferencia;
use BankOn\Exceptions\BankOnException;

$cliente = new Cliente;
$cliente->setTokenTransacao("TOKEN_TRANSACAO");

$transferencia = new Transferencia;
$transferencia->setBeneficiario('test');
$transferencia->setValor(100);
$transferencia->setIdTransferencia('test');

try{
    $novaTransferencia = new NovaTransferencia;
    $resposta = $novaTransferencia->executar($cliente,$transferencia);

    echo $resposta->getTransacao();
    echo $resposta->getFavorecido();
    echo $resposta->getFavorecidoUser();
    echo $resposta->getData();
    echo $resposta->getHora();
    echo $resposta->getValor();

}catch(BankOnException $e){
    echo $e->getMessage();
}

请求支付

简单请求支付

use BankOn\Cliente;
use BankOn\Services\Checkout\SolicitarPagamento;
use BankOn\Services\Checkout\Solicitar;
use BankOn\Exceptions\BankOnException;

$cliente = new Cliente;
$cliente->setTokenTransacao("TOKEN_TRANSACAO");

$solicitar = new Solicitar;
$solicitar->setEmail('test@gmail.com');
$solicitar->setValor(100);
$solicitar->setRefPagamento('test');
$solicitar->setUrlCallbackSuccesso('http://www.seudominio.com.br/url-sucesso');// Após o pagamento ser efetuado pelo cliente, ele será redirecionado para a url_callback contendo o parâmero transacao na url: http://www.seudominio.com.br/url_callback?transacao={codigo_transacao}
$solicitar->setUrlCallbackFalha('http://www.seudominio.com.br/url-falha');

try{
    $solicitarPagamento = new SolicitarPagamento;
    $resposta = $solicitarPagamento->executar($cliente, $solicitar);

    echo $resposta->getTokenPagamento();
    echo $resposta->getUrlPagamento(); // Uma vez que a solicitação é criada, use a URL que você encontra nesse metódo para gerar um botão de pagamento
    echo $resposta->getSolicitacao(); // Data de solicitação
    echo $resposta->getExpiracao(); // Data de expiração
    $resposta->getExpiracaoCarbon(); // retorna a data pra ser usada com a biblioteca https://carbon.nesbot.com/

}catch(BankOnException $e){
    echo $e->getMessage();
}

为了确保更高的完整性和安全性，您可以选择按照“查询转账”中的步骤验证交易。