PHPackages cashier-pix/cashier-pix - 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. cashier-pix/cashier-pix ActiveLibrary[Payment Processing](/categories/payments) cashier-pix/cashier-pix ======================= Laravel Cashier-style recurring billing for PIX Automático (Asaas, Efí, Mercado Pago). v0.1.0(1mo ago)01MITPHPPHP ^8.3CI passing Since Jul 12Pushed 1mo agoCompare [ Source](https://github.com/cashier-pix/cashier-pix)[ Packagist](https://packagist.org/packages/cashier-pix/cashier-pix)[ Docs](https://github.com/cashier-pix/cashier-pix)[ RSS](/packages/cashier-pix-cashier-pix/feed)WikiDiscussions main Synced 1w ago READMEChangelogDependencies (9)Versions (2)Used By (0) Cashier PIX =========== [](#cashier-pix) [![Latest Version on Packagist](https://camo.githubusercontent.com/ae359d18e6871ae3c6fba28c200350db611a27e2ab400e293d03eb55ed6af3fc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636173686965722d7069782f636173686965722d7069782e737667)](https://packagist.org/packages/cashier-pix/cashier-pix)[![CI](https://github.com/cashier-pix/cashier-pix/actions/workflows/ci.yml/badge.svg)](https://github.com/cashier-pix/cashier-pix/actions/workflows/ci.yml)[![Total Downloads](https://camo.githubusercontent.com/89ca8d3b9108f86ac24ed273786c69d568f9e07c3c4aa05ec5a696dc21e01f07/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636173686965722d7069782f636173686965722d7069782e737667)](https://packagist.org/packages/cashier-pix/cashier-pix)[![License](https://camo.githubusercontent.com/95097d56547ce32a1f5edb74b508f3ae70c0339e420984de22b42e68da5ef3e9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f636173686965722d7069782f636173686965722d7069782e737667)](LICENSE.md) Cobrança recorrente via **PIX Automático** para Laravel, no estilo do Laravel Cashier. Driver **Asaas** incluído (Efí e Mercado Pago no roadmap). > Stripe resolve cartão. Cliente brasileiro paga com PIX — e até agora não existia um "Cashier do PIX". Este pacote é isso. Requisitos ---------- [](#requisitos) - PHP 8.3+ - Laravel 12 ou 13 - Conta no [Asaas](https://www.asaas.com) (sandbox grátis) Quickstart ---------- [](#quickstart) **1.** Instale o pacote: ``` composer require cashier-pix/cashier-pix ``` **2.** Publique config e migrations, e migre: ``` php artisan vendor:publish --tag=cashier-pix-config php artisan vendor:publish --tag=cashier-pix-migrations php artisan migrate ``` **3.** Configure o `.env`: ``` ASAAS_API_KEY=sua-chave ASAAS_SANDBOX=true ASAAS_WEBHOOK_TOKEN=um-token-secreto-seu ``` **4.** Adicione o trait ao seu model: ``` use CashierPix\Billable; class User extends Authenticatable { use Billable; } ``` **5.** Crie a assinatura (Jornada 3: consentimento + 1ª cobrança num QR só): ``` use CashierPix\Enums\Cycle; use CashierPix\Plan\PixPlan; $subscription = $user->newPixSubscription('default', new PixPlan( valueCents: 4990, // R$ 49,90 — sempre centavos, nunca float cycle: Cycle::Monthly, description: 'Plano Pro', ))->create(); $subscription->qr_code_payload; // copia-e-cola pro seu checkout ``` **6.** Cadastre o webhook no painel do Asaas apontando para: ``` POST https://seu-app.com/cashier-pix/webhook/asaas ``` com o token de autenticação igual ao `ASAAS_WEBHOOK_TOKEN`. Pronto — o estado da assinatura atualiza sozinho. **7.** Cheque o estado onde precisar: ``` $user->pixSubscription()?->active(); // libera a feature? $user->pixSubscription()?->pastDue(); // cobrança falhou $user->pixSubscription()?->cancel(); // cancela no PSP e localmente ``` **8.** Reaja aos eventos (opcional): ``` use CashierPix\Events\PixChargeConfirmed; use CashierPix\Events\PixChargeFailed; Event::listen(PixChargeConfirmed::class, SendReceiptMail::class); Event::listen(PixChargeFailed::class, StartDunningFlow::class); ``` Estados da assinatura --------------------- [](#estados-da-assinatura) ``` incomplete → pending_authorization → active ⇄ past_due ↓ ↓ authorization_denied | expired canceled ``` Webhooks são a fonte de verdade — o pacote nunca infere estado por tempo. Eventos disponíveis ------------------- [](#eventos-disponíveis) EventoQuando`PixAuthorizationGranted`pagador autorizou no banco`PixAuthorizationDenied` / `PixAuthorizationExpired`autorização negada / expirou`PixChargeConfirmed`ciclo cobrado com sucesso`PixChargeFailed`cobrança do ciclo falhou (assinatura vira `past_due`)`PixSubscriptionCanceled`cancelada (por você ou pelo pagador no banco)`PixWebhookMismatch`valor do webhook difere da assinaturaTestes ------ [](#testes) ``` composer test # suite completa, sem rede (SQLite) ASAAS_SANDBOX_KEY=... composer test:sandbox # integração real no sandbox ``` ### Docker (suite contra MySQL real) [](#docker-suite-contra-mysql-real) ``` docker compose up --build --abort-on-container-exit tests ``` Sobe MySQL 8.4 + roda a suite completa no container (PHP 8.4). Útil pra validar migrations num banco de verdade — SQLite esconde diferenças de FK e ordenação. Licença ------- [](#licença) [MIT](LICENSE.md) ### Health Score 35 — LowBetter than 77% of packages Maintenance90 Actively maintained with recent releases Popularity1 Limited adoption so far Community6 Small or concentrated contributor base Maturity38 Early-stage or recently created project 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 49d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/93fb0acaf031e480e4460f0037d895c84a02cebf7cea67f2d9002d6962a015bb?d=identicon)[OwlHugo](/maintainers/OwlHugo) --- Top Contributors [![OwlHugo](https://avatars.githubusercontent.com/u/68191727?v=4)](https://github.com/OwlHugo "OwlHugo (18 commits)") --- Tags laravelbillingcashierpixAsaasbrasilpix-automatico ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/cashier-pix-cashier-pix/health.svg) ``` [![Health](https://phpackages.com/badges/cashier-pix-cashier-pix/health.svg)](https://phpackages.com/packages/cashier-pix-cashier-pix) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3365.5M359](/packages/psalm-plugin-laravel)[laravel/scout Laravel Scout provides a driver based solution to searching your Eloquent models. 1.7k59.5M714](/packages/laravel-scout)[simplestats-io/laravel-client Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof. 5226.7k](/packages/simplestats-io-laravel-client)[spatie/laravel-health Monitor the health of a Laravel application 89313.5M195](/packages/spatie-laravel-health)[laravel/cashier Laravel Cashier provides an expressive, fluent interface to Stripe's subscription billing services. 2.5k31.8M166](/packages/laravel-cashier)[api-platform/laravel API Platform support for Laravel 58190.1k22](/packages/api-platform-laravel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)