Braspag API SDK (NÃO OFICIAL)
Repositório oficial:
https://github.com/Braspag/BraspagApiPhpSdk, (*1)
Repositório criado a partir da versão v2.0 para sanar problemas pontuais que levariam algumas semanas para ser aceito o PR., (*2)
Principais recursos
- [x] Pagamentos por cartão de crédito.
- [x] Pagamentos recorrentes.
- [x] Com autorização na primeira recorrência.
- [x] Com autorização a partir da primeira recorrência.
- [x] Pagamentos por cartão de débito.
- [x] Pagamentos por boleto.
- [x] Pagamentos por transferência eletrônica.
- [x] Cancelamento de autorização.
- [x] Consulta de pagamentos.
Limitações
Por envolver a interface de usuário da aplicação, o SDK funciona apenas como um framework para criação das transações. Nos casos onde a autorização é direta, não há limitação; mas nos casos onde é necessário a autenticação ou qualquer tipo de redirecionamento do usuário, o desenvolvedor deverá utilizar o SDK para gerar o pagamento e, com o link retornado pela Cielo, providenciar o redirecionamento do usuário., (*3)
Utilizando o SDK
Para criar um pagamento simples com cartão de crédito com o SDK, basta fazer:, (*4)
// ...
// Configure o ambiente
$environment = $environment = Environment::sandbox();
// Configure seu merchant
$merchant = new Merchant('MERCHANT ID', 'MERCHANT KEY');
// Crie uma instância de Sale informando o ID do pagamento
$sale = new Sale('123');
// Crie uma instância de Customer informando o nome do cliente
$customer = $sale->customer('Fulano de Tal');
// Crie uma instância de Payment informando o valor do pagamento
$payment = $sale->payment(15700);
// Crie uma instância de Credit Card utilizando os dados de teste
// esses dados estão disponíveis no manual de integração
$payment->creditCard("123", "Visa")
->setExpirationDate("12/2018")
->setCardNumber("0000000000000001")
->setHolder("Fulano de Tal");
// Crie o pagamento na Braspag
try {
// Configure o SDK com seu merchant e o ambiente apropriado para criar a venda
$sale = (new Braspag($merchant, $environment))->createSale($sale);
// Com a venda criada na Braspag, já temos o ID do pagamento, TID e demais
// dados retornados pela Braspag
$paymentId = $sale->getPayment()->getPaymentId();
// Com o ID do pagamento, podemos fazer sua captura, se ela não tiver sido capturada ainda
$sale = (new Braspag($merchant, $environment))->captureSale($paymentId, 15700, 0);
// E também podemos fazer seu cancelamento, se for o caso
$sale = (new CieloBraspagEcommerce($merchant, $environment))->cancelSale($paymentId, 15700);
} catch (BraspagRequestException $e) {
// Em caso de erros de integração, podemos tratar o erro aqui.
// os códigos de erro estão todos disponíveis no manual de integração.
$error = $e->getBraspagError();
}
// ...
Wallogit.com
