flromano / paghiper-laravel
Biblioteca de integração Laravel do PagHiper
Requires
- guzzlehttp/guzzle: ~6.0 || ~7.0
- laravel/framework: >=5.2
This package is auto-updated.
Last update: 2024-05-12 22:36:26 UTC
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();