sistem_atc/asaas-laravel

SDK Asaas para Laravel com webhooks e metodos de envios

v2.0.2 2026-02-28 15:00 UTC

Requires

• php: ^8.2
• illuminate/http: ^10.0 || ^11.0 || ^12.0
• illuminate/support: ^10.0 || ^11.0 || ^12.0

Requires (Dev)

• orchestra/testbench: ^10.9
• pestphp/pest: ^4.3

MIT

• Kleber Pracidelli

• payments
• sdk
• gateway
• laravel
• Asaas

README

Pacote Laravel para integracao com a API do Asaas, incluindo suporte a webhooks.

Instalacao

composer require sistem-atc/asaas-laravel

Publique o arquivo de configuracao:

php artisan vendor:publish --provider="SistemAtc\Asaas\AsaasServiceProvider" --tag=asaas-config

Configuracao

No arquivo .env:

ASAAS_ENVIRONMENT=sandbox

ASAAS_BASE_URL=https://api.asaas.com
ASAAS_API_VERSION=v3
ASAAS_ACCESS_TOKEN=seu-token-de-producao
ASAAS_PIX_KEY=sua-chave-pix-producao
GROUP_NAME_ASAAS="group_customers"

ASAAS_SANDBOX_BASE_URL=https://sandbox.asaas.com
ASAAS_SANDBOX_API_VERSION=v3
ASAAS_SANDBOX_ACCESS_TOKEN=seu-token-de-sandbox
ASAAS_SANDBOX_PIX_KEY=sua-chave-pix-sandbox
GROUP_NAME_SANDBOX_ASAAS="group_customers"

ASAAS_WEBHOOK_TOKEN=seu-token-secreto-webhook
ASAAS_IDEMPOTENCY_TTL=86400
ASAAS_ROUTE_EVENTS="/asaas-events"
ASAAS_ROUTE_EVENTS_NAME="asaas.webhook"

Uso Basico

use SistemAtc\Asaas\Facades\Asaas;
use SistemAtc\Asaas\DTO\Request\Customer\CustomerRequestDTO;

$customer = Asaas::customer()->createNewCustomer(
    CustomerRequestDTO::fromArray([
        'name' => 'Joao da Silva',
        'email' => '[e-mail]',
        'cpfCnpj' => '12345678900',
        'mobilePhone' => '11999999999',
    ])
);

Documentacao de Metodos

Todos os metodos implementados possuem documentacao em docs/methods:

• AccountDocument
• AccountInfo
• Anticipation
• AutomaticPix
• Bill
• Chargeback
• Checkout
• CreditBureauReport
• CreditCard
• Customer
• EscrowAccount
• Finance
• FinancialTransaction
• FiscalInfo
• Installment
• Invoice
• MobilePhoneRecharge
• Notification
• Payment
• PaymentDocument
• PaymentDunning
• PaymentLink
• PaymentRefund
• PaymentSplit
• PaymentWithSummaryData
• Pix
• PixTransaction
• RecurringPix
• Subaccount
• Subscription
• Transfer
• Webhook

Webhooks

A documentacao completa de webhooks esta em:

• docs/webhooks.md

Para configurar o token e o endpoint no painel do Asaas, use a referencia visual abaixo:

Testes

Executar todos os testes:

composer test

ou

./vendor/bin/pest

Licenca

Este pacote esta licenciado sob MIT License.