PHPackages                             murillofrazaocunha/hbank-sdk-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. murillofrazaocunha/hbank-sdk-php

ActiveProject[Payment Processing](/categories/payments)

murillofrazaocunha/hbank-sdk-php
================================

Cliente PHP para a API de pagamento da Hight Bank

1.0.0(1y ago)03PHPPHP ^8.0

Since Feb 16Pushed 1y ago1 watchersCompare

[ Source](https://github.com/murillofrazaocunha/HBank-sdk-php)[ Packagist](https://packagist.org/packages/murillofrazaocunha/hbank-sdk-php)[ RSS](/packages/murillofrazaocunha-hbank-sdk-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

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
----------

[](#instalação)

Para instalar o SDK, use o **Composer**. Execute o seguinte comando no terminal:

```
composer require https://github.com/murillofrazaocunha/HBank-sdk-php
```

Requisitos
----------

[](#requisitos)

- PHP 8.0 ou superior.
- Composer instalado.
- Chave de API da HBank.

---

Configuração
------------

[](#configuração)

### 1. **Autoloading**

[](#1-autoloading)

O SDK usa autoloading do Composer. Certifique-se de incluir o autoloader no seu projeto:

```
require 'vendor/autoload.php';
```

### 2. **Chave de API**

[](#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`:

```
use HBank\Api\PaymentService;

$apiKey = 'sua-chave-de-api'; // Substitua pela sua chave de API
$paymentService = new PaymentService($apiKey);
```

---

Uso Básico
----------

[](#uso-básico)

Aqui está um exemplo básico de como usar o SDK para criar um link de pagamento e verificar o status:

```
use HBank\Api\PaymentService;
use HBank\Models\Payment;

require 'vendor/autoload.php';

$apiKey = 'sua-chave-de-api'; // Substitua pela sua chave de API
$paymentService = new PaymentService($apiKey);

try {
    // Dados para criar o link de pagamento
    $paymentData = Payment::createPaymentLinkRequest(
        '100.00', // Valor do pagamento
        'Teste',  // Descrição do pagamento
        'https://hightpanel.com.br', // URL de notificação
        'https://hightpanel.com.br', // URL de redirecionamento
        ['TESTE' => '20%'] // Cupons de desconto
    );

    // Cria o link de pagamento
    $paymentLink = $paymentService->createPaymentLink($paymentData);
    echo "Link de pagamento criado: " . $paymentLink['link'] . "\n";

    // Verifica o status do pagamento
    $paymentStatus = $paymentService->getPaymentStatus($paymentLink['id']);
    echo "Status do pagamento: " . $paymentStatus['pstatus'] . "\n";
} catch (\Exception $e) {
    echo "Erro: " . $e->getMessage() . "\n";
}
```

---

Métodos Disponíveis
-------------------

[](#métodos-disponíveis)

### 1. **`PaymentService::createPaymentLink(array $data)`**

[](#1-paymentservicecreatepaymentlinkarray-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.

---

### 2. **`PaymentService::getPaymentStatus(string $id)`**

[](#2-paymentservicegetpaymentstatusstring-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.

Tratamento de Erros
-------------------

[](#tratamento-de-erros)

O SDK lança exceções em caso de erros. Use um bloco `try/catch` para capturar e tratar os erros:

```
try {
    $paymentLink = $paymentService->createPaymentLink($paymentData);
    echo "Link de pagamento criado: " . $paymentLink['link'] . "\n";
} catch (\Exception $e) {
    echo "Erro: " . $e->getMessage() . "\n";
}
```

Contribuição
------------

[](#contribuição)

Se encontrar algum problema ou tiver sugestões, sinta-se à vontade para abrir uma **issue** ou enviar um **pull request**.

---

Licença
-------

[](#licença)

Este projeto está licenciado sob a [MIT License](LICENSE).

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance43

Moderate activity, may be stable

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

450d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3af5702b36f39b26063aa15c03a6b7567b5d6301930d40405e4fa92d4dacae66?d=identicon)[murillofrazaocunha](/maintainers/murillofrazaocunha)

---

Top Contributors

[![murillofrazaocunha](https://avatars.githubusercontent.com/u/105169407?v=4)](https://github.com/murillofrazaocunha "murillofrazaocunha (3 commits)")

### Embed Badge

![Health badge](/badges/murillofrazaocunha-hbank-sdk-php/health.svg)

```
[![Health](https://phpackages.com/badges/murillofrazaocunha-hbank-sdk-php/health.svg)](https://phpackages.com/packages/murillofrazaocunha-hbank-sdk-php)
```

###  Alternatives

[chargebee/chargebee-php

ChargeBee API client implementation for PHP

768.0M9](/packages/chargebee-chargebee-php)[imdhemy/google-play-billing

Google Play Billing

491.3M5](/packages/imdhemy-google-play-billing)[bitpay/sdk

Complete version of the PHP library for the new cryptographically secure BitPay API

42337.5k4](/packages/bitpay-sdk)[buckaroo/sdk

Buckaroo payment SDK

12189.1k9](/packages/buckaroo-sdk)[contica/facturador-electronico-cr

Un facturador de código libre para integrar facturación electrónica en Costa Rica a un proyecto PHP

2128.8k](/packages/contica-facturador-electronico-cr)[karson/mpesa-php-sdk

172.2k](/packages/karson-mpesa-php-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)