EBANX Benjamin

Esta biblioteca permite integrar o EBANX com qualquer aplicativo PHP.

Requisitos#

PHP >= 5.6
cURL

Instalação#

Composer#

A biblioteca EBANX PHP está disponível no Packagist, portanto, basta apenas atualizar seu arquivo composer.json e ela será instalada:

{
    "require": {
        "ebanx/benjamin-local": "^1.19"
    }
}

Após ter atualizado seu arquivo composer.json execute o comando run composer install e aguarde finalizar a instalação.

Utilização#

O Benjamin é muito simples. Você só precisará de uma instância Ebanx\Benjamin\Models\Configs\Config:

Caso haja necessidade de alterar outras configurações, a seguinte função poderá ser utilizada:

$config = new Config([
  //Propriedades da configuração
]);

$ebanx = EBANX($config);

Aqui está um exemplo de configuração:

$config = new Config([
  'integrationKey' => 'SUA_CHAVE_DE_INTEGRAÇÃO',
  'sandboxIntegrationKey' => 'SUA_CHAVE_DE_INTEGRAÇÃO_STAGING',
  'isSandbox' => true,
  'baseCurrency' => Currency::BRL
]);

Você pode alterar as seguintes configurações:

integrationKey: Sua chave de integração. Somente será usada no ambiente in live.
sandboxIntegrationKey: Sua chave de integração Staging. Somente será usada no ambiente de teste.
isSandbox: Habilite ou desabilite o modo de testes. O valor padrão é false.
baseCurrency: A moeda base da transação.

Aqui está um exemplo de requisição de pagamento:

$payment = new Payment([
    'type' => 'boleto',
    'address' => new Address([
        'address' => 'Rua Rodrigues',
        'city' => 'Vila Malena d\'Oeste',
        'country' => Country::BRAZIL,
        'state' => 'MS',
        'streetComplement' => 'Apto 35',
        'streetNumber' => '55',
        'zipcode' => '10493-222'
    ]),
    'amountTotal' => 48.63,
    'deviceId' => 'b2017154beac2625eec083a5d45d872f12dc2c57535e25aa149d3bdb57cbdeb9',
    'merchantPaymentCode' => 'a6d690137e32c38db369beed8844e997',
    'note' => 'Example payment.',
    'person' => new Person([
        'type' => 'business',
        'birthdate' => new \DateTime('1978-03-29 08:15:51.000000 UTC'),
        'document' => '40701766000118',
        'email' => 'sdasneves@r7.com',
        'ip' => '30.43.84.28',
        'name' => 'Sr. Gustavo Fernando Valência',
        'phoneNumber' =>  '(43) 3965-4162'
    ]),
    'items' => [
        new Item ([
            'sku' => 'S-NDI-359444',
            'name' => 'consequuntur perferendis',
            'description' => 'Aut aliquid quibusdam quidem neque alias aliquid culpa maxime. Totam voluptatum et fuga nesciunt expedita rerum.',
            'unitPrice' => 7.19,
            'quantity' => 3,
            'type' => 'sed'
        ]),
        new Item ([
            'sku' => 'X-LQF-592041',
            'name' => 'esse sint',
            'description' => 'Eligendi error iusto et ut. Cupiditate sint ut et in vitae non.',
            'unitPrice' => 9.02,
            'quantity' => 3,
            'type' => 'est'
        ])
    ],
    'responsible' => new Person ([
        'type' => 'personal',
        'birthdate' => new \DateTime ('1986-06-18 10:18:33 UTC'),
        'document' => '38346222653',
        'email' => 'alessandra.dominato@galhardo.net',
        'ip' => '49.29.237.45',
        'name' => 'Luana Aragão Mendes',
        'phoneNumber' => '(74) 97063-8157',
    ]),
    'dueDate' => new \DateTime ('2017-05-20 01:47:31 UTC')
]);

$result = EBANX($config)->create($payment);

// Type can also be explicit, like so:
$result = EBANX($config)->boleto()->create($payment);

Aqui está um exemplo de resposta:

Array
(
  [payment] => Array
      (
          [hash] => 591b803da5549b6a1bac524b31e6eef55c2e67af8e40e1e4
          [pin] => 670071563
          [merchant_payment_code] => 248b2672f000e293268be28d6048d600
          [order_number] => null
          [status] => PE
          [status_date] => null
          [open_date] => 2017-05-16 19:42:05
          [confirm_date] => null
          [transfer_date] => null
          [amount_br] => 48.81
          [amount_ext] => 48.63
          [amount_iof] => 0.18
          [currency_rate] => 1.0000
          [currency_ext] => BRL
          [due_date] => 2018-11-22
          [instalments] => 1
          [payment_type_code] => boleto
          [boleto_url] => https://sandbox.ebanxpay.com/print/?hash=591b803da5549b6a1bac524b31e6eef55c2e67af8e40e1e4
          [boleto_barcode] => 34191760071244348372714245740007871600000004881
          [boleto_barcode_raw] => 34198716000000048811760012443483721424574000
          [pre_approved] => null
          [capture_available] => null
          [customer] => Array
              (
                  [document] => 40701766000118
                  [email] => sdasneves@r7.com
                  [name] => SR GUSTAVO FERNANDO VALENCIA
                  [birth_date] => 1978-03-28
              )

      )

  [status] => SUCCESS
)

Contribuindo#

Encontrou um bug? Quer adicionar um novo recurso? Vá em frente e envie um Pull Request para o nosso repositório GitHub:

https://github.com/ebanx/benjamin-local

Obtendo Ajuda#

Nós esperamos que este artigo tenha sido esclarecedor, mas caso não tenhamos tirado suas dúvidas você tem as seguintes opções para continuar buscando respostas:

Se você ainda não é nosso parceiro e deseja saber mais sobre nossos preços e condições, entre em contato com nossa equipe comercial.
Caso você já seja nosso parceiro, entre em contato com nossa equipe de suporte em faleconosco@ebanxpay.com.