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)62375↓33.3%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 1mo 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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ0MTczMDMsIm5iZiI6MTc3NDQxNzAwMywicGF0aCI6Ii8xNDAyMDk3OC80MDIzOTk2NTMtMjAwNTFkM2EtZWNiZi00ZDAxLThjMjktNTBjNDNiOGQzYWY0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMjUlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzI1VDA1MzY0M1omWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTNmOGVhNjM5YzhkOTI1ZDVkN2IwMDE4MjdjMzIwOGVhYTY2YmFkNDlhMDNlMGU0NDQzODZmYWRmZTkyMTk4YzImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.s47XR6RugSbTj2SLnfZWMva6YQBGNZrnGjLWDT6raUQ)](https://private-user-images.githubusercontent.com/14020978/402399653-20051d3a-ecbf-4d01-8c29-50c43b8d3af4.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ0MTczMDMsIm5iZiI6MTc3NDQxNzAwMywicGF0aCI6Ii8xNDAyMDk3OC80MDIzOTk2NTMtMjAwNTFkM2EtZWNiZi00ZDAxLThjMjktNTBjNDNiOGQzYWY0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMjUlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzI1VDA1MzY0M1omWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTNmOGVhNjM5YzhkOTI1ZDVkN2IwMDE4MjdjMzIwOGVhYTY2YmFkNDlhMDNlMGU0NDQzODZmYWRmZTkyMTk4YzImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.s47XR6RugSbTj2SLnfZWMva6YQBGNZrnGjLWDT6raUQ)

 [![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 85% of packages

Maintenance48

Moderate activity, may be stable

Popularity30

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

375d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9da5c93f43a49ee0437e7b662537c13d262303f25ac035e020177bde04a994b8?d=identicon)[mariolucasdev](/maintainers/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

[imdhemy/google-play-billing

Google Play Billing

491.3M5](/packages/imdhemy-google-play-billing)[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)

PHPackages © 2026

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