Download the PHP package murillofrazaocunha/hbank-sdk-php without Composer
On this page you can find all versions of the php package murillofrazaocunha/hbank-sdk-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download murillofrazaocunha/hbank-sdk-php
More information about murillofrazaocunha/hbank-sdk-php
Files in murillofrazaocunha/hbank-sdk-php
Package hbank-sdk-php
Short Description Cliente PHP para a API de pagamento da Hight Bank
License
Informations about the package hbank-sdk-php
HBank SDK PHP
Este é um SDK em PHP para interagir com a API de pagamentos da HBank. Ele permite criar links de pagamento e verificar o status de pagamentos de forma simples e eficiente.
Instalação
Para instalar o SDK, use o Composer. Execute o seguinte comando no terminal:
Requisitos
- PHP 8.0 ou superior.
- Composer instalado.
- Chave de API da HBank.
Configuração
1. Autoloading
O SDK usa autoloading do Composer. Certifique-se de incluir o autoloader no seu projeto:
2. Chave de API
Você precisará de uma chave de API para autenticar as requisições. Configure-a ao criar uma instância do PaymentService:
Uso Básico
Aqui está um exemplo básico de como usar o SDK para criar um link de pagamento e verificar o status:
Métodos Disponíveis
1. PaymentService::createPaymentLink(array $data)
Cria um link de pagamento.
- Parâmetros:
$data(array): Dados do pagamento.amount(string): Valor do pagamento (ex:"100.00").description(string): Descrição do pagamento.notification_url(string): URL para receber notificações.redirect(string): URL para redirecionamento após o pagamento.cupons(array): Cupons de desconto (opcional).
- Retorno:
- Retorna um array com:
status(string): Status da operação ("success"ou"error").link(string): Link de pagamento gerado.id(string): ID do pagamento.
- Retorna um array com:
2. PaymentService::getPaymentStatus(string $id)
Verifica o status de um pagamento.
- Parâmetros:
$id(string): ID do pagamento.
- Retorno:
- Retorna um array com:
status(string): Status da operação ("success"ou"error").id(string): ID do pagamento.amount(string): Valor do pagamento.description(string): Descrição do pagamento.pstatus(string): Status do pagamento.cupons(array): Cupons aplicados.
- Retorna um array com:
Tratamento de Erros
O SDK lança exceções em caso de erros. Use um bloco try/catch para capturar e tratar os erros:
Contribuição
Se encontrar algum problema ou tiver sugestões, sinta-se à vontade para abrir uma issue ou enviar um pull request.
Licença
Este projeto está licenciado sob a MIT License.