PHPackages                             62pay/php-sdk - 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. 62pay/php-sdk

ActiveLibrary[Payment Processing](/categories/payments)

62pay/php-sdk
=============

PHP SDK for the 62pay Payment Gateway

0.0.15(3mo ago)155MITPHPPHP ^8.0

Since Aug 8Pushed 3mo agoCompare

[ Source](https://github.com/zer062/62pay-php-sdk)[ Packagist](https://packagist.org/packages/62pay/php-sdk)[ Docs](https://62pay.com.br/)[ RSS](/packages/62pay-php-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (17)Used By (0)

62Pay SDK para PHP
==================

[](#62pay-sdk-para-php)

Um SDK robusto para integrar as soluções de pagamento **62Pay** em suas aplicações PHP de forma simples e segura.

---

📋 Requisitos
------------

[](#-requisitos)

- **PHP** 8.0 ou superior
- **Composer**
- Conta válida na **62Pay** e credenciais de API
- SSL habilitado para ambientes de produção

---

💻 Instalação
------------

[](#-instalação)

Instale o SDK via Composer:

```
composer require 62pay/php-sdk
```

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

[](#-configuração)

Inicialize o SDK com sua API Key e ambiente desejado:

```
use Sixtytwopay\Sixtytwopay;

$sdk = new Sixtytwopay('SIXTYTWOPAY_API_KEY', 'SANDBOX');
```

#### ⚠️ Importante: Nunca versione sua chave de API. Utilize variáveis de ambiente.

[](#️-importante-nunca-versione-sua-chave-de-api-utilize-variáveis-de-ambiente)

**📦 Serviços Disponíveis**
--------------------------

[](#-serviços-disponíveis)

Método no SDKServiçoDescrição`$sdk->customer()`CustomerServiceCriação, listagem e atualização de clientes`$sdk->invoice()`InvoiceServiceEmissão e gerenciamento de cobranças`$sdk->payment()`PaymentServiceProcessamento e consulta de pagamentos`$sdk->checkout()`CheckoutServicePagamento direto via checkout (Cartão de crédito)🌟 **Funcionalidades**
---------------------

[](#-funcionalidades)

- Gestão de **clientes**
- Emissão e gestão de **cobranças**
- Processamento de **pagamentos**
- Checkout seguro
- Suporte a múltiplos métodos de pagamento
- Tratamento de erros e integração com **webhooks**

---

📘 Exemplos de Uso
-----------------

[](#-exemplos-de-uso)

### **Clientes**

[](#clientes)

#### Criar cliente (mínimo)

[](#criar-cliente-mínimo)

```
$customer = $sdk->customer()->create([
'name' => 'João da Silva',
]);
```

#### Criar cliente (completo)

[](#criar-cliente-completo)

```
$customer = $sdk->customer()->create([
'type' => 'LEGAL',
'name' => 'João da Silva',
'legal_name' => 'João A. da Silva',
'email' => 'joao@example.com',
'phone' => '11988887777',
'document_number' => '12345678900',
'address' => 'Rua das Palmeiras',
'address_number' => '123',
'complement' => 'Apto 45',
'postal_code' => '01311000',
'province' => 'Bela Vista',
'city' => 'São Paulo',
'state' => 'SP',
'tags' => ['vip', 'beta-tester'],
]);
```

#### Atualizar cliente

[](#atualizar-cliente)

```
$updatedCustomer = $sdk->customer()->update('01987533-17dc-7120-a54b-de803aa04bc0', [
'email' => 'joao.novo@example.com',
'phone' => '11999998888',
'tags' => ['vip', 'premium'],
]);
```

#### Buscar cliente por ID

[](#buscar-cliente-por-id)

```
$customer = $sdk->customer()->get('01987533-17dc-7120-a54b-de803aa04bc0');
```

#### Listar clientes

[](#listar-clientes)

```
$customers = $sdk->customer()->list();
```

#### Excluir cliente

[](#excluir-cliente)

```
$sdk->customer()->delete('01987533-17dc-7120-a54b-de803aa04bc0');
```

### **Cobranças**

[](#cobranças)

#### Criar fatura (mínimo)

[](#criar-fatura-mínimo)

```
$invoice = $sdk->invoice()->create([
'customer' => '01987533-17dc-7120-a54b-de803aa04bc0',
'payment_method' => 'PIX',
'amount' => 10000,
'due_date' => '2025-08-15',
'description' => 'Serviço de Assinatura',
]);
```

#### Criar fatura (completo, com juros/multa/desconto e parcelas)

[](#criar-fatura-completo-com-jurosmultadesconto-e-parcelas)

```
$invoice = $sdk->invoice()->create([
'customer' => '01987533-17dc-7120-a54b-de803aa04bc0',
'payment_method' => 'CREDIT_CARD',
'amount' => 250000,
'due_date' => '2025-08-20',
'description' => 'Plano Anual Premium',
'installments' => 6,
'immutable' => false,
'interest_percent' => 500,
'fine_type' => 'PERCENTAGE',
'fine_value' => 200,
'discount_type' => 'PERCENTAGE',
'discount_value' => 1000,
'discount_deadline'=> '2025-08-10',
'tags' => ['campanha-ano', 'premium'],
]);
```

#### Atualizar fatura (parcial)

[](#atualizar-fatura-parcial)

```
$invoice = $sdk->invoice()->update('01987533-8e9e-7384-a2e3-96fb04d556f2', [
'amount' => 12000,
'due_date' => '2025-08-25',
'description' => 'Serviço de Assinatura (ajustado)',
'installments' => 3,
'immutable' => false,
'tags' => ['ajuste', 'cliente-vip'],
]);
```

> ℹ️ **Nota:** O `buildUpdatePayload()` só aceita um subconjunto de campos (sem juros/multa/desconto). Para alterar regras de juros/multa/desconto após criação, verifique as políticas/recursos da sua API.

#### Buscar fatura por ID

[](#buscar-fatura-por-id)

```
$invoice = $sdk->invoice()->get('01987533-8e9e-7384-a2e3-96fb04d556f2');
```

#### Listar faturas

[](#listar-faturas)

```
$faturas = $sdk->invoice()->list();
```

#### Estornar/Refund

[](#estornarrefund)

```
$sdk->invoice()->refund('01987533-8e9e-7384-a2e3-96fb04d556f2');
```

#### Excluir fatura

[](#excluir-fatura)

```
$sdk->invoice()->delete('01987533-8e9e-7384-a2e3-96fb04d556f2');
```

### **Pagamentos**

[](#pagamentos)

#### Buscar pagamento por ID de fatura

[](#buscar-pagamento-por-id-de-fatura)

```
$payment = $sdk->payment()->get('01987533-8e9e-7384-a2e3-96fb04d556f2');
```

#### Atualizar regras de pagamento (juros/multa/desconto/descrição)

[](#atualizar-regras-de-pagamento-jurosmultadescontodescrição)

```
$payment = $sdk->payment()->update('01987533-8e9e-7384-a2e3-96fb04d556f2', [
'interest_percenter' => 500,
'fine_type' => 'PERCENTAGE',
'fine_value' => 200,
'discount_type' => 'FIXED',
'discount_value' => 1000,
'discount_deadline' => '2025-08-31',
'description' => 'Pagamento ajustado com condições promocionais',
]);
```

#### Estornar pagamento (refund)

[](#estornar-pagamento-refund)

```
$sdk->payment()->refund('01987533-8e9e-7384-a2e3-96fb04d556f2', [
'reason' => 'CUSTOMER_REQUESTED',
]);
```

> ℹ️ **Notas**
>
> - Os métodos recebem o **ID da fatura** (`invoice`) no path: `payments/{invoice}`.
> - `refund()` não retorna corpo (**void**) de acordo com o serviço.
> - O `update()` aplica apenas os campos aceitos em `buildUpdatePayload()`; envie somente o que deseja alterar.
> - **Valide** se a chave correta é `interest_percenter` ou `interest_percent` conforme sua API.

### **Checkout**

[](#checkout)

#### Pagar fatura com **cartão de crédito** (mínimo)

[](#pagar-fatura-com-cartão-de-crédito-mínimo)

```
$response = $sdk->checkout()->payWithCreditCard('01987533-8e9e-7384-a2e3-96fb04d556f2', [
'holder_name' => 'João da Silva',
'number' => '4111111111111111',
'card_expiry_date' => '12/28',
'ccv' => '123',
'billing_name' => 'João da Silva',
'billing_email' => 'joao@example.com',
'billing_document_number' => '12345678900',
'billing_postal_code' => '01311000',
'billing_address_number' => '123',
'billing_phone' => '11988887777',
]);
```

#### Com parcelas e endereço completo

[](#com-parcelas-e-endereço-completo)

```
$response = $sdk->checkout()->payWithCreditCard('01987533-8e9e-7384-a2e3-96fb04d556f2', [
'holder_name' => 'Maria Oliveira',
'number' => '5555444433331111',
'card_expiry_date' => '07/29',
'ccv' => '987',
'installments' => 6,
'billing_name' => 'Maria Oliveira',
'billing_email' => 'maria@example.com',
'billing_document_number' => '98765432100',
'billing_postal_code' => '20031000',
'billing_address_number' => '456',
'billing_address_complement' => 'Apto 1203',
'billing_phone' => '21977776666',
]);
```

⚡ Boas Práticas
---------------

[](#-boas-práticas)

Sempre utilize variáveis de ambiente para credenciais

Ative o error reporting no ambiente de desenvolvimento

Valide todos os dados de entrada

Trate exceções de forma adequada

Mantenha o SDK atualizado

**🔍 Tratamento de Erros**
-------------------------

[](#-tratamento-de-erros)

```
use Sixtytwopay\Exceptions\ApiException;

try {
$fatura = $sdk->invoice()->create($dadosFatura);
} catch (ApiException $e) {
echo "Erro da API: " . $e->getMessage();
} catch (\Exception $e) {
echo "Erro geral: " . $e->getMessage();
}
```

🛠️ Desenvolvimento
------------------

[](#️-desenvolvimento)

```
composer install --dev
composer test
```

**🤝 Contribuindo**
------------------

[](#-contribuindo)

##### 1. Faça um fork do repositório

[](#1-faça-um-fork-do-repositório)

##### 2. Crie uma branch para sua feature (git checkout -b feature/minha-feature)

[](#2-crie-uma-branch-para-sua-feature-git-checkout--b-featureminha-feature)

##### 3. Commit suas alterações (git commit -m 'Minha nova feature')

[](#3-commit-suas-alterações-git-commit--m-minha-nova-feature)

##### 4. Faça o push (git push origin feature/minha-feature)

[](#4-faça-o-push-git-push-origin-featureminha-feature)

##### 5.Abra um Pull Request

[](#5abra-um-pull-request)

🔒 Segurança
-----------

[](#-segurança)

Para reportar vulnerabilidades, siga nossa Política de Segurança.

📄 Licença
---------

[](#-licença)

Este projeto está licenciado sob a MIT License – veja o arquivo LICENSE para mais detalhes.

💬 Suporte
---------

[](#-suporte)

- Para dúvidas sobre a API:
- Para problemas com o SDK: abra uma issue no GitHub
- Para casos urgentes: entre em contato com nosso time de suporte

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance81

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 Bus Factor1

Top contributor holds 97.7% 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

Every ~14 days

Recently: every ~45 days

Total

14

Last Release

98d ago

PHP version history (2 changes)0.0.1PHP ^8.4

0.0.3PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/757bf65c20f29c716b6f45e2f2048da2a42176ef86c32775c7f584163bb06435?d=identicon)[zer062](/maintainers/zer062)

---

Top Contributors

[![Peagah-Vieira](https://avatars.githubusercontent.com/u/105545343?v=4)](https://github.com/Peagah-Vieira "Peagah-Vieira (43 commits)")[![caiovncius](https://avatars.githubusercontent.com/u/4031854?v=4)](https://github.com/caiovncius "caiovncius (1 commits)")

---

Tags

62payphpsdkphpsdkpaymentgateway62pay

### Embed Badge

![Health badge](/badges/62pay-php-sdk/health.svg)

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

###  Alternatives

[lokielse/omnipay-wechatpay

Wechat gateway for Omnipay payment processing library

329224.5k7](/packages/lokielse-omnipay-wechatpay)

PHPackages © 2026

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