csweb/bin-pagamentos

Integracao com a BIN pagamentos

0.5.1 2020-10-08 00:50 UTC

Requires

• php: >=7.2
• ext-curl: *
• ext-dom: *
• ext-json: *
• ext-simplexml: *

Requires (Dev)

• phpunit/phpunit: ^7.5

MIT

• Matheus Lopes Santos

README

Testes

Para a realização de alguns testes, é necessário o uso de certificados digitais. Para este package foram gerados alguns certificados auto-assinados, que se encontram em tests/fixtures/certs.

A senha do certificado private_key.pem é muito simples: 123456

Estes certificados tem validade de 4 anos. Caso deseja gerar outros, faça

# generate private key and enter pass phrase
openssl genrsa -des3 -out private_key.pem 2048

# create certificate signing request, enter "*.example.com" as a "Common Name", leave "challenge password" blank
openssl req -new -sha256 -key private_key.pem -out server.csr

# generate self-signed certificate for 1 year
openssl req -x509 -sha256 -days 365 -key private_key.pem -in server.csr -out server.pem

# validate the certificate
openssl req -in server.csr -text -noout | grep -i "Signature.*SHA256" && echo "All is well" || echo "This certificate doesn't work in 2017! You must update OpenSSL to generate a widely-compatible certificate"

Criando uma nova venda

Para Criação de uma nova venda, faça

<?php

require_once __DIR__ . './vendor/autoload.php';

use CSWeb\BIN\Environment;
use CSWeb\BIN\Transactions\Sale;
use CSWeb\BIN\Bin;

$payload = [
    'CreditCardTxType' => [
        'Type' => 'sale'
    ],
    'CreditCardData'   => [
        'CardNumber'    => 411111111111,
        'ExpMonth'      => 12,
        'ExpYear'       => 30,
        'CardCodeValue' => 123
    ],
    'Payment' => [
        'NumberOfInstallments' => 1, // Opcional
        'ChargeTotal'          => 10.0,
        'Currency'             => 986 // REAL formato ISO
    ],
    'TransactionDetails' => [
        'OrderId',
        'TDate'
    ],
    'cardFunction' => 'credit'
];

$sale = new Sale($payload, 'v1');
$env  = new Environment('username', 'password', 'path/to/cert', 'path/to/key', 'ssl_key');

$bin = new Bin($env);

$response = $bin->send($sale);

Cancelando uma venda

Para cancelar uma venda, faça o seguinte

<?php

require_once __DIR__ . './vendor/autoload.php';

use CSWeb\BIN\Environment;
use CSWeb\BIN\Transactions\RevokeSale;
use CSWeb\BIN\Bin;

$payload = [
    'CreditCardTxType'   => [
        'Type' => 'void'
    ],
    'TransactionDetails' => [
        'OrderId' => 1,
        'TDate'   => 1190244932
    ]
];

$sale = new RevokeSale($payload, 'v1');
$env  = new Environment('username', 'password', 'path/to/cert', 'path/to/key', 'ssl_key');

$bin = new Bin($env);

$response = $bin->send($sale);