PHPackages                             phpay-io/phpay - 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. phpay-io/phpay

ActiveLibrary[Payment Processing](/categories/payments)

phpay-io/phpay
==============

v1.0.1(1y ago)621.2k↑176.7%6[1 issues](https://github.com/phpay-io/phpay/issues)MITPHPPHP ^8.1

Since Feb 12Pushed 1y ago6 watchersCompare

[ Source](https://github.com/phpay-io/phpay)[ Packagist](https://packagist.org/packages/phpay-io/phpay)[ GitHub Sponsors](https://github.com/sponsors/mariolucasdev)[ RSS](/packages/phpay-io-phpay/feed)WikiDiscussions develop Synced 2d ago

READMEChangelog (2)Dependencies (5)Versions (4)Used By (0)

[![capa-redes](https://private-user-images.githubusercontent.com/14020978/402399653-20051d3a-ecbf-4d01-8c29-50c43b8d3af4.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3OTA4MDQsIm5iZiI6MTc4Mjc5MDUwNCwicGF0aCI6Ii8xNDAyMDk3OC80MDIzOTk2NTMtMjAwNTFkM2EtZWNiZi00ZDAxLThjMjktNTBjNDNiOGQzYWY0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjMwVDAzMzUwNFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWYyNzkxN2Y3MjNjMmViNDA2MWEwNWI5ODY0Yjg3ZDhhYmY3ZGJkYThjMGIxZjZkNjNkZmY0Yzg1OWE2MGQzM2UmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.5QkS5pRDxtau0X-IddmR6oSYfazzSp3BW_VWYy8LbG0)](https://private-user-images.githubusercontent.com/14020978/402399653-20051d3a-ecbf-4d01-8c29-50c43b8d3af4.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3OTA4MDQsIm5iZiI6MTc4Mjc5MDUwNCwicGF0aCI6Ii8xNDAyMDk3OC80MDIzOTk2NTMtMjAwNTFkM2EtZWNiZi00ZDAxLThjMjktNTBjNDNiOGQzYWY0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjMwVDAzMzUwNFomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWYyNzkxN2Y3MjNjMmViNDA2MWEwNWI5ODY0Yjg3ZDhhYmY3ZGJkYThjMGIxZjZkNjNkZmY0Yzg1OWE2MGQzM2UmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.5QkS5pRDxtau0X-IddmR6oSYfazzSp3BW_VWYy8LbG0)

 [![Stable Version](https://camo.githubusercontent.com/052d650e3b9f68c24a5c6a7cdb78afe22749b50bf336bce6f47befb4336f130b/68747470733a2f2f706f7365722e707567782e6f72672f70687061792d696f2f70687061792f762f737461626c65)](https://github.com/phpay-io/phpay/releases) [![Php Version](https://camo.githubusercontent.com/c3a80c86d7355ce233d937cc6ce506d4f9b1f34a91fb4b52d2d725a3bef932d0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d2533453d382e312d627269676874677265656e2e7376673f6d61784167653d32353932303030)](https://www.php.net) [![Total Downloads](https://camo.githubusercontent.com/a209c06b92c8a58cc6e0a2c7624567fcb930429465c5e42ab4c58222844219ea/68747470733a2f2f706f7365722e707567782e6f72672f70687061792d696f2f70687061792f646f776e6c6f616473)](https://packagist.org/packages/phpay-io/phpay)

O PHPay é uma biblioteca PHP que tem o objetivo tornar o trabalho de integrações com gateways de pagamento mais simples e descomplicadas, facilitando a conexão entre tecnologia e negócios em produtos de software.

💸 Gateways
----------

[](#-gateways)

- Asaas (cobranças, gestão de clientes e webhooks)
- Efí (cobranças)

📦 Instalação
------------

[](#-instalação)

Instale via Composer:

```
composer require phpay-io/phpay
```

⚙️ Como usar o PHPay?
---------------------

[](#️-como-usar-o-phpay)

```
/**
 * instance with gateway inject
 * @var AsaasGateway $phpay
 */
$phpay = (new PHPay(new AsaasGateway(TOKEN_ASAAS_SANDBOX)));
```

### Cobranças

[](#cobranças)

```
/**
 * instance with gateway inject and resource call
 *
 * @var Charge $phpay
 */
$phpay = (new PHPay(new AsaasGateway(TOKEN_ASAAS_SANDBOX)))->charge();

/**
 * create charge
 */
$phpay
    ->setCharge($charge)
    ->setCustomer($customer)
    ->create();

/**
 * find charge
 */
$phpay->find($chargeId);

/**
 * get all charges
 */
$phpay->getAll();

/**
 * get all charges with filters
 */
$phpay
    ->setQueryParams(['limit' => 2])
    ->getAll();

/**
 * update charge
 */
$phpay->update($chargeId, $data);

/**
 * destroy charge
 */
$phpay->destroy($chargeId);

/**
 * restore charge
 */
$phpay->restore($chargeId);

/**
 * get status charge
 */
$phpay->getStatus($chargeId);

/**
 * get digitable line charge
 */
$phpay->getDigitableLine($chargeId);

/**
 * get qrcode charge
 */
$phpay->getQrCodePix($chargeId);

/**
 * confirm receipt charge
 */
$phpay->confirmReceipt($chargeId, [
    'paymentDate'    => date('Y-m-d'),
    'value'          => 100.00,
    'notifyCustomer' => true,
]);

/**
 * undo confirm receipt
 */
$phpay->undoConfirmReceipt($chargeId);
```

### Assinaturas

[](#assinaturas)

```
/**
 * @var Subscription $phpay
 */
$phpay = PHPay::gateway(new AsaasGateway(TOKEN_ASAAS_SANDBOX))->subscription();

/**
 * create a new subscription
 */
$phpay->setCustomer($customer)->create([
    'billingType' => 'BOLETO',
    'value'       => 100,
    'nextDueDate' => '2025-04-09',
]);
```

📝 Roadmap
---------

[](#-roadmap)

- Definições de Arquitetura ✅
- Domínios ✅
- Documentação ✍️
- Site 🕛
- Gateways ✍️

    - Asaas.
    - Cobranças ✅
    - Clientes ✅
    - Webhook ✅
    - Assinaturas ✍️
    - Pix 🕥
    - Efí.
    - Autorização ✅
    - Cobranças ✅
    - Clientes 🕥
    - Webhook 🕥
    - Assinaturas ✍️
    - Pix 🕥
- Lançamento v1.0.0 🚀

🌟 Contribuindo
--------------

[](#-contribuindo)

Para contribuir com o PHPay, implementando melhorias e novos gateways de pagamento, leia nosso manual de contribuição. [MANUAL DE CONTRIBUIÇÃO PHPAY](./CONTRIBUTING.md)

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

[](#-licença)

Este projeto está licenciado sob a MIT License. Consulte o arquivo [LICENSE](./LICENSE.md) para mais detalhes.

🤝 Contato
---------

[](#-contato)

💻 GitHub: [Mário Lucas](https://github.com/mariolucasdev)

📧 Email:

🎉 Comece a usar o PHPay e simplifique suas integrações com gateways de pagamento!

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance44

Moderate activity, may be stable

Popularity33

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 91.5% 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 ~84 days

Total

2

Last Release

422d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/14020978?v=4)[Mário Lucas](/maintainers/mariolucasdev)[@mariolucasdev](https://github.com/mariolucasdev)

---

Top Contributors

[![mariolucasdev](https://avatars.githubusercontent.com/u/14020978?v=4)](https://github.com/mariolucasdev "mariolucasdev (161 commits)")[![evandrosystems](https://avatars.githubusercontent.com/u/78321345?v=4)](https://github.com/evandrosystems "evandrosystems (15 commits)")

---

Tags

gatewaysinvoicesreceiptsAsaasgatewaysefigateways de pagamentosdk asaassdk efiphpay

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/phpay-io-phpay/health.svg)

```
[![Health](https://phpackages.com/badges/phpay-io-phpay/health.svg)](https://phpackages.com/packages/phpay-io-phpay)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.3k543.5M2.6k](/packages/aws-aws-sdk-php)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k656.1k38](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3741.3M46](/packages/tencentcloud-tencentcloud-sdk-php)[chargebee/chargebee-php

ChargeBee API client implementation for PHP

758.5M9](/packages/chargebee-chargebee-php)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)[imdhemy/google-play-billing

Google Play Billing

491.5M5](/packages/imdhemy-google-play-billing)

PHPackages © 2026

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