Asaas Brazil Payment and Financial Management API
Asaas Brazil payment and financial management REST API for SMBs, freelancers, and developers to accept Pix, boleto bancário, and credit card payments with automated dunning, subscription management, and basic financial management features including invoicing, customer management, and financial reports, targeting Brazilian small businesses with an all-in-one payment and billing platform. Enables AI agents to manage Pix payment generation for Brazil instant payment automation, handle boleto bancário creation for Brazil bank slip billing automation, access credit card charge for Brazil card payment automation, retrieve payment status and confirmation for Brazil transaction automation, manage subscription and recurring charge for Brazil billing automation, handle automated dunning for Brazil overdue payment recovery automation, access customer management for Brazil payer profile automation, retrieve financial report for Brazil revenue analytics automation, manage split payment for Brazil partner commission automation, and integrate Asaas with Brazilian SMB, freelancer, and service business platforms for end-to-end Brazil payment and billing automation.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
Brazil billing. BACEN, PCI DSS, LGPD. API token. BR. Payment and customer data.
⚡ Reliability
Best When
A Brazilian SMB, freelancer, or service business wanting AI agents to automate Pix, boleto, card payment, subscription billing, and dunning management through Asaas's all-in-one Brazil billing and payment platform.
Avoid When
CPF/CNPJ REQUIRED FOR ALL CUSTOMERS: Asaas requires customer CPF (individual) or CNPJ (company) for customer creation; automated Brazil payment must include valid Brazilian tax ID; automated payment without document creates invalid_document error for all transaction types. BOLETO HAS STRICT EXPIRY: Asaas boleto expires on due_date; automated overdue boleto requires new boleto creation; automated expired boleto retry without new generation creates boleto_expirado bank rejection. DUNNING SCHEDULES USE ABSOLUTE DATES: Asaas automated dunning uses configured schedule from payment due date; automated dunning must configure intervals relative to due date not creation date; automated creation-date dunning schedule creates wrong dunning timing. SPLIT PAYMENT REQUIRES ASAAS WALLET: Asaas split payment requires split recipient to have Asaas account (wallet); automated marketplace split must ensure all recipients have Asaas accounts; automated bank-account-only split creates missing_wallet error.
Use Cases
- • Generating Pix and boleto for Brazilian SMB invoice payment agents
- • Managing subscription billing for Brazil SaaS and service business agents
- • Automating dunning sequences for Brazilian overdue payment recovery agents
- • Processing credit card charges for Brazilian e-commerce checkout agents
Not For
- • Large enterprise acquiring (Asaas is SMB/freelancer focused; use Cielo or Rede for enterprise)
- • International payments (Asaas is Brazil-only BRL platform)
- • High-volume marketplace acquiring at scale (use Pagar.me or Iugu for marketplace features)
Interface
Authentication
Asaas uses API token for authentication. REST API with JSON. Joinville, Santa Catarina, Brazil HQ. Founded 2013 by Marcio Lopes de Freitas. Bootstrapped (profitable). Products: Pix, boleto, card, subscription, dunning, customer management, invoicing, split. SDKs: PHP, Node.js, Python. BACEN-registered payment institution. LGPD. PCI DSS. Popular with Brazilian freelancers and SMBs. Competes with Iugu and GerenciaNet/EfíPay for Brazilian SMB billing.
Pricing
Joinville BR. Bootstrapped. Per-transaction pricing in BRL. BACEN registered. LGPD. PCI DSS.
Agent Metadata
Known Gotchas
- ⚠ SANDBOX IS SEPARATE DOMAIN: Asaas sandbox uses different base URL (sandbox.asaas.com) from production (api.asaas.com); automated environment switching must change base URL; automated production URL in sandbox testing creates live charges
- ⚠ CPF/CNPJ VALIDATION IS STRICT: Asaas validates CPF/CNPJ format and check digits; automated customer creation must use valid formatted Brazilian tax IDs; automated arbitrary or foreign ID creates cpf_cnpj_invalid error blocking all payment methods
- ⚠ BOLETO EXPIRY IS MANDATORY FIELD: Asaas boleto requires explicit dueDate; automated boleto creation must set future due date; automated boleto without due date creates validation error
- ⚠ WEBHOOK EVENTS COVER ALL STATES: Asaas sends webhooks for PENDING, CONFIRMED, RECEIVED, OVERDUE, REFUNDED, DELETED; automated webhook handler must filter for CONFIRMED/RECEIVED before fulfillment; automated fulfillment on PENDING creates premature order processing
- ⚠ SPLIT PAYMENT WALLET MUST BE ACTIVE: Asaas split recipient wallet must be active and verified; automated split must check recipient wallet status; automated split to inactive wallet creates split_recipient_inactive error and full amount stays with sender
Alternatives
Full Evaluation Report
Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for Asaas Brazil Payment and Financial Management API.
AI-powered analysis · PDF + markdown · Delivered within 30 minutes
Package Brief
Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.
Delivered within 10 minutes
Score Monitoring
Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.
Continuous monitoring
Scores are editorial opinions as of 2026-03-07.