README

Descrição

Utilizando essa biblioteca você pode integrar o PagHiper ao Laravel e utilizar os recursos que o PagHiper fornece em sua API, deixando seu código mais legível e manutenível.

Esta biblioteca tem suporte aos seguintes recursos:

• Emissão de boleto
• Cancelamento de boleto
• Receber notificações automáticas (Retorno Automático)
• Listar contas bancárias

Instalação

Você pode instalar a biblioteca via composer:

composer require flromano/paghiper-laravel

Instalação no Laravel

Laravel 5.5+

Você não precisa configurar nada. O pacote carrega automaticamente o Service Provider e cria o Facade alias, utilizando o recurso Auto-Discovery.

Laravel 5.4

Adicione o ServiceProvider e a Facade em config/app.php

Flromano\LaravelPagHiper\PagHiperServiceProvider::class,

'PagHiper' => Flromano\LaravelPagHiper\PagHiperFacade::class,

Publique o arquivo de configuração

php artisan vendor:publish --provider=Flromano\LaravelPagHiper\PagHiperServiceProvider

Adicione suas credenciais (token e apiKey) em config/paghiper.php. (Para obtê-las basta ir no seu painel: https://www.paghiper.com/painel/credenciais/

Utilizando

Emissão de Boleto

Para emitir um boleto você pode fazer da seguinte maneira:

use PagHiper;

$transaction = PagHiper::billet()->create([
    'order_id' => 'ABC-456-789',
    'payer_name' => 'Fernando Romano',
    'payer_email' => 'comprador@email.com',
    'payer_cpf_cnpj' => '1234567891011',
    'type_bank_slip' => 'boletoa4',
    'days_due_date' => '3',
    'items' => [[
        'description' => 'Notebook',
        'quantity' => 1,
        'item_id' => 'e24fc781-f543-4591-a51c-dde972e8e0af',
        'price_cents' => '1000'
    ]]
]);

Você pode obter a lista de dados que você pode enviar no seguinte link: https://dev.paghiper.com/reference#gerar-boleto

Para cancelar um boleto:

use PagHiper;

$transaction = PagHiper::billet()->cancel('JKP03X9KN0RELVLH');

Para obter informações do pagamento via retorno automático:

use PagHiper;
use Illuminate\Http\Request;

public function notification(Request $request) {
    $transaction = PagHiper::notification()->response($request->notification_id, $request->idTransacao);
}

Para obter a lista de suas contas bancárias:

use PagHiper;

$bankAccounts = PagHiper::bank()->accounts();