Download the PHP package jorzelalves/laravel-asaas without Composer
On this page you can find all versions of the php package jorzelalves/laravel-asaas. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download jorzelalves/laravel-asaas
More information about jorzelalves/laravel-asaas
Files in jorzelalves/laravel-asaas
Package laravel-asaas
Short Description Package for integration with Asaas.
License MIT
Informations about the package laravel-asaas
Laravel Asaas
Pacote Laravel para integrar com a API de pagamentos Asaas. Oferece Facade e classes para gerenciar clientes, cobranças, assinaturas, parcelamentos, notas fiscais, links de pagamento, antecipações, finanças, transferências, subcontas, webhooks e chaves Pix.
Requisitos
- PHP >= 8.0
- Laravel >= 10.0
Instalação
Publique o arquivo de configuração:
Adicione as variáveis de ambiente no .env:
Para ambiente sandbox:
Uso
A API key é passada por parâmetro em cada chamada, permitindo uso multi-tenant com chaves diferentes por subconta:
Todas as respostas seguem o formato:
Módulos
Customer (Clientes)
Payment (Cobranças)
Subscription (Assinaturas)
Ciclos disponíveis: WEEKLY, BIWEEKLY, MONTHLY, BIMONTHLY, QUARTERLY, SEMIANNUALLY, YEARLY
Installment (Parcelamentos)
Invoice (Notas Fiscais)
PaymentLink (Links de Pagamento)
Tipos de cobrança: DETACHED (avulsa), RECURRENT (recorrente), INSTALLMENT (parcelada)
Tipos de billing: PIX, BOLETO, CREDIT_CARD, UNDEFINED (cliente escolhe)
Anticipation (Antecipação)
Finance (Finanças)
Transfer (Transferências)
Tipos de chave Pix: CPF, CNPJ, EMAIL, PHONE, EVP
Pix
CreditCard (Cartão de Crédito)
SubAccount (Subcontas)
Tipos de empresa: MEI, LIMITED, INDIVIDUAL, ASSOCIATION
Webhook
Eventos disponíveis
| Classe | Eventos |
|---|---|
PaymentsWebhookEvents |
PAYMENT_CREATED, PAYMENT_CONFIRMED, PAYMENT_RECEIVED, PAYMENT_OVERDUE, PAYMENT_DELETED, PAYMENT_REFUNDED, ... |
SubscriptionsWebhookEvents |
SUBSCRIPTION_CREATED, SUBSCRIPTION_UPDATED, SUBSCRIPTION_INACTIVATED, SUBSCRIPTION_DELETED, ... |
TransfersWebhookEvents |
TRANSFER_CREATED, TRANSFER_PENDING, TRANSFER_DONE, TRANSFER_FAILED, TRANSFER_CANCELLED, ... |
InvoicesWebhookEvents |
INVOICE_CREATED, INVOICE_AUTHORIZED, INVOICE_CANCELED, INVOICE_ERROR, ... |
BillsWebhookEvents |
BILL_CREATED, BILL_PAID, BILL_CANCELLED, BILL_FAILED, ... |
AccountStatusWebhookEvents |
ACCOUNT_STATUS_DOCUMENT_APPROVED, ACCOUNT_STATUS_GENERAL_APPROVAL_APPROVED, ... |
PhoneRechargeWebhookEvents |
PHONE_RECHARGE_CONFIRMED, PHONE_RECHARGE_CANCELLED, ... |
ReceivableAnticipationWebhookEvents |
RECEIVABLE_ANTICIPATION_CREDITED, RECEIVABLE_ANTICIPATION_DENIED, ... |
Retry automático
O pacote possui retry automático com backoff exponencial para resiliência contra falhas transitórias:
- Tentativas: 1 retry após falha
- Delay inicial: 150ms
- Delay máximo: 1000ms
- Backoff: Exponencial (fator 2.0) com jitter aleatório (0-150ms)
- Status codes retryable: 408, 429, 500, 502, 503, 504
- Exceptions retryable: Erros de conexão (timeout, rede)
Tratamento de erros
Erros da API retornam no mesmo formato padronizado:
Erros de validação (antes do envio à API) lançam \Exception com os detalhes dos campos inválidos.
Multi-tenant
A $apiKey é passada em toda chamada via Asaas::modulo($apiKey). Isso permite que uma aplicação multi-tenant use chaves diferentes por subconta/cliente:
Licença
MIT
All versions of laravel-asaas with dependencies
ext-json Version *
illuminate/support Version ^10.0|^11.0|^12.0
guzzlehttp/guzzle Version ^7.0
illuminate/console Version ^10.0|^11.0|^12.0