Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Asaas Payment Skill · evolution-foundation | DecimalAI

evolution-foundation/int-asaas

SkillScore86Maintained

Asaas payment platform integration via API v3. Manage payments (Pix, boleto, credit card), customers, subscriptions, transfers, balance, and marketplace subaccounts. Use when users ask about payment collection, billing automation, Pix, boleto, subscriptions, or financial transfers via Asaas. Integração Asaas: cobranças, clientes, assinaturas, Pix, boleto.

financeby evolution-foundation

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Finance & Accounting pack

1 · One-time — install the CLI (docs ↗)

pip install decimalai

2 · Get the skill — writes .claude/skills/evolution-foundation-int-asaas/SKILL.md

decimalai skills pull evolution-foundation-int-asaas --out .claude/skills/

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/evolution-foundation-int-asaas/SKILL.md https://app.decimal.ai/s/evolution-foundation-int-asaas/SKILL.md

Raw file: /s/evolution-foundation-int-asaas/SKILL.md ↗ · machine-readable summary at /s/evolution-foundation-int-asaas.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

22 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 27h ago

Yes — +27% lift · at higher cost+215% tokens0% turns86% of whole cases pass with skill (19/22)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-01	✗→✓	▲ Improved	229%	0%
case-07	✗→✓	▲ Improved	331%	0%
case-08	✗→✓	▲ Improved	125%	0%
case-14	✗→✓	▲ Improved	284%	0%
case-16	✗→✓	▲ Improved	65%	0%

Showing 5 of 22 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

evolution-foundation / evo-nexus

.claude/skills/int-asaas/SKILL.md

View on GitHub ↗

License NOASSERTIONImported 8/3/2026Version v1

Skill contents

SKILL.md

Asaas Payment Skill

Integration with Asaas billing platform via REST API v3.

When to use

Create or query payment charges (Pix, boleto, credit card)
Manage customers in Asaas
Create or cancel recurring subscriptions
Check account balance or initiate Pix transfers
Generate Pix QR codes or boleto digitable lines
Create marketplace subaccounts for split payments
List webhook events for payment confirmations

Setup

Requires environment variables:

bash
export ASAAS_API_KEY="your_api_key_here"
export ASAAS_SANDBOX="true"   # set to "false" for production

How to obtain the API key

Log in to https://www.asaas.com (or https://sandbox.asaas.com for testing)
Go to Account Settings → Integrations → API Key
Copy the key — it starts with $aact_ in production

Auth header used in all requests:

access_token: ${ASAAS_API_KEY}

Base URL

| Environment | URL | |-------------|-----| | Production | https://api.asaas.com/v3 | | Sandbox | https://sandbox.asaas.com/api/v3 |

Select based on ASAAS_SANDBOX env var. Default is sandbox (safe).

Enums

billingType

| Value | Description | |-------|-------------| | BOLETO | Bank slip | | CREDIT_CARD | Credit card | | PIX | Pix instant payment | | UNDEFINED | Any method (customer chooses) |

Payment status

| Value | Description | |-------|-------------| | PENDING | Awaiting payment | | RECEIVED | Payment received | | CONFIRMED | Payment confirmed | | OVERDUE | Past due date | | REFUNDED | Refunded | | RECEIVED_IN_CASH | Received in cash | | REFUND_REQUESTED | Refund requested | | CHARGEBACK_REQUESTED | Chargeback requested | | AWAITING_CHARGEBACK_REVERSAL | Awaiting chargeback reversal | | DUNNING_REQUESTED | Dunning in progress | | DUNNING_RECEIVED | Dunning received | | AWAITING_RISK_ANALYSIS | Under risk analysis |

Subscription cycle

Subscription status

ACTIVE | INACTIVE | EXPIRED

Pix key type

CPF | CNPJ | EMAIL | PHONE | EVP

Company type (subaccounts)

MEI | LIMITED | INDIVIDUAL | ASSOCIATION

Format Rules

| Field | Format | Example | |-------|--------|---------| | CPF | 11 digits, no dashes | 12345678901 | | CNPJ | 14 digits, no dashes | 12345678000199 | | CEP | 8 digits, no dashes | 30140071 | | Dates | ISO YYYY-MM-DD | 2026-04-10 | | Amounts | BRL float | 99.90 | | IDs | Prefixed strings | cus_xxx, pay_xxx, sub_xxx |

Payments

Create payment

bash
curl -s -X POST \
  "${BASE_URL}/payments" \
  -H "access_token: ${ASAAS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": "cus_000000000001",
    "billingType": "PIX",
    "value": 150.00,
    "dueDate": "2026-04-20",
    "description": "Monthly service fee"
  }'

Body fields: | Field | Type | Required | Description | |-------|------|----------|-------------| | customer | string | yes | Customer ID (cus_xxx) | | billingType | string | yes | BOLETO, CREDIT_CARD, PIX, UNDEFINED | | value | number | yes | Amount in BRL (must be > 0) | | dueDate | string | yes | Due date YYYY-MM-DD | | description | string | no | Payment description |

Get payment

bash
curl -s -X GET \
  "${BASE_URL}/payments/pay_000000000001" \
  -H "access_token: ${ASAAS_API_KEY}"

List payments

bash
curl -s -X GET \
  "${BASE_URL}/payments?customer=cus_000000000001&status=PENDING&limit=10&offset=0" \
  -H "access_token: ${ASAAS_API_KEY}"

Query params: | Param | Type | Description | |-------|------|-------------| | customer | string | Filter by customer ID | | status | string | Filter by payment status | | limit | number | Results per page (default 10) | | offset | number | Pagination offset |

Get Pix QR code

bash
curl -s -X GET \
  "${BASE_URL}/payments/pay_000000000001/pixQrCode" \
  -H "access_token: ${ASAAS_API_KEY}"

Returns payload (copy-paste Pix string) and encodedImage (base64 PNG).

Get boleto

bash
curl -s -X GET \
  "${BASE_URL}/payments/pay_000000000001/identificationField" \
  -H "access_token: ${ASAAS_API_KEY}"

Returns identificationField (digitable line) and barcode.

Get installments

bash
curl -s -X GET \
  "${BASE_URL}/payments/pay_000000000001/installments" \
  -H "access_token: ${ASAAS_API_KEY}"

Customers

Create customer

bash
curl -s -X POST \
  "${BASE_URL}/customers" \
  -H "access_token: ${ASAAS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "João da Silva",
    "cpfCnpj": "12345678901",
    "email": "joao@email.com",
    "phone": "31999990000"
  }'

Body fields: | Field | Type | Required | Description | |-------|------|----------|-------------| | name | string | yes | Customer name | | cpfCnpj | string | yes | CPF (11 digits) or CNPJ (14 digits), numbers only | | email | string | no | Valid email address | | phone | string | no | Phone number |

List customers

bash
curl -s -X GET \
  "${BASE_URL}/customers?name=João&limit=20" \
  -H "access_token: ${ASAAS_API_KEY}"

Query params: name, cpfCnpj, limit

Subscriptions

Create subscription

bash
curl -s -X POST \
  "${BASE_URL}/subscriptions" \
  -H "access_token: ${ASAAS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": "cus_000000000001",
    "billingType": "BOLETO",
    "value": 99.90,
    "cycle": "MONTHLY",
    "nextDueDate": "2026-05-01",
    "description": "Pro plan"
  }'

Body fields: | Field | Type | Required | Description | |-------|------|----------|-------------| | customer | string | yes | Customer ID | | billingType | string | yes | BOLETO, CREDIT_CARD, PIX | | value | number | yes | Amount per cycle (must be > 0) | | cycle | string | yes | Billing cycle | | nextDueDate | string | yes | First due date YYYY-MM-DD | | description | string | no | Subscription description |

List subscriptions

bash
curl -s -X GET \
  "${BASE_URL}/subscriptions?customer=cus_000000000001&status=ACTIVE&limit=10" \
  -H "access_token: ${ASAAS_API_KEY}"

Cancel subscription

bash
curl -s -X DELETE \
  "${BASE_URL}/subscriptions/sub_000000000001" \
  -H "access_token: ${ASAAS_API_KEY}"

Financial

Get balance

bash
curl -s -X GET \
  "${BASE_URL}/finance/balance" \
  -H "access_token: ${ASAAS_API_KEY}"

Create transfer (Pix out / TED)

bash
curl -s -X POST \
  "${BASE_URL}/transfers" \
  -H "access_token: ${ASAAS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "value": 250.00,
    "pixAddressKey": "joao@email.com",
    "pixAddressKeyType": "EMAIL",
    "description": "Supplier payment"
  }'

Body fields: | Field | Type | Required | Description | |-------|------|----------|-------------| | value | number | yes | Amount in BRL (must be > 0) | | pixAddressKey | string | no | Pix key value | | pixAddressKeyType | string | no | CPF, CNPJ, EMAIL, PHONE, EVP | | description | string | no | Transfer description |

Marketplace (Split Payments)

Create subaccount

bash
curl -s -X POST \
  "${BASE_URL}/accounts" \
  -H "access_token: ${ASAAS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Parceiro Comercial LTDA",
    "email": "parceiro@empresa.com",
    "cpfCnpj": "12345678000199",
    "companyType": "LIMITED",
    "phone": "31999990000",
    "postalCode": "30140071",
    "address": "Rua das Flores",
    "addressNumber": "100",
    "province": "Centro"
  }'

Required fields: name, email, cpfCnpj

Utilities

Get webhook events

bash
curl -s -X GET \
  "${BASE_URL}/webhook/events?event=PAYMENT_CONFIRMED&limit=10&offset=0" \
  -H "access_token: ${ASAAS_API_KEY}"

Common event types: PAYMENT_CONFIRMED, PAYMENT_RECEIVED, PAYMENT_OVERDUE, TRANSFER_CREATED, SUBSCRIPTION_CREATED

Auth Model

Type: API Key
Header name: access_token (note: lowercase, not Authorization)
Header value: raw API key, no Bearer prefix
Key format: $aact_YTU5YTE0M... (production) or similar pattern in sandbox

Rate Limits

Asaas enforces rate limits per API key
Default limit: ~120 requests/minute (see official docs for current values)
Back off on HTTP 429; retry after the Retry-After header value
Full rate limit details: https://docs.asaas.com

Notes

This skill is based on the MCP implementation at workspace/projects/mcp-dev-brasil/packages/payments/asaas/src/index.ts (mcp-dev-brasil project), which includes Zod validation for CPF/CNPJ, email, CEP, and date formats
Always start with ASAAS_SANDBOX=true — sandbox is isolated from production funds
For credit card payments, tokenization requires additional fields not covered here — see https://docs.asaas.com
Webhook configuration (registering your endpoint URL) must be done in the Asaas dashboard, not via API

Want to see if evolution-foundation/int-asaas would activate on your phrasing? Try it before you install — no LLM call, no signup.

Latest benchmark · publisher runVerified

8/19/2026, 20:32 UTC · 22 cases

Lift

+27%

86% vs 59%

Agent turns

1.0 vs 1.0

Tokens

+215%

3,861.32 vs 1,226.27

fail → pass · 6pass → pass · 13fail → fail · 3

Per-case results (22)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-09 I want to generate a Pix charge for customer 'cus_123456789000' for 150 BRL due on April 20, 2026. What REST request body should be sent to create this charge?	pass→pass	9,309	3,529	-62%	1	1	0%	1,825	3,812	+109%	0	0	—
case-10 A customer wants to pay their bank slip charge 'pay_999888777666' using online banking. Which GET endpoint in Asaas retrieves the digitable line (linha digitável) for this payment?	pass→pass	4,145	2,899	-30%	1	1	0%	726	3,617	+398%	0	0	—
case-01 I need to configure a monthly recurring payment in Asaas for an existing customer using bank slip billing. Could you provide the cURL request formatted according to their v3 REST API to set up this subscription with a starting due date of 2026-05-01 for 99.90 BRL?	fail→pass	5,891	4,502	-24%	1	1	0%	1,232	4,058	+229%	0	0	—
case-02 Can you give me the cURL command to register a new individual client in Asaas with their name, CPF, and email, along with the request to generate a Pix payment QR code for an existing charge ID?	pass→pass	6,611	5,117	-23%	1	1	0%	1,314	4,111	+213%	0	0	—
case-03 I want to execute an outbound Pix transfer to a vendor using their email address as the key on Asaas. Please output the appropriate REST call using cURL to make this payout.	pass→pass	6,897	3,528	-49%	1	1	0%	1,281	3,820	+198%	0	0	—
case-04 I want to use the Asaas REST API v3 to programmatically create and configure a new webhook listener URL endpoint for PAYMENT_CONFIRMED events. Please provide the cURL request to register this webhook endpoint via API.	fail→fail	8,007	9,349	+17%	1	1	0%	1,619	4,865	+200%	0	0	—
case-05 Please provide the complete REST API request body payload to tokenize a raw credit card number, CVV, and expiration date directly with Asaas before charging a customer.	fail→fail	10,077	8,321	-17%	1	1	0%	1,901	4,755	+150%	0	0	—
case-06 I need to upload a subaccount owner's identity document (RG/CNH) PDF file directly to Asaas via API for account verification. What is the cURL command and endpoint to upload this verification document?	fail→fail	9,149	8,623	-6%	1	1	0%	1,758	4,699	+167%	0	0	—
case-07 Write a cURL request to list payments on Asaas using standard OAuth Bearer token authentication in the Authorization header.	fail→pass	5,043	4,819	-4%	1	1	0%	926	3,991	+331%	0	0	—
case-08 Show the POST request payload to create an individual customer in Asaas using the formatted CPF '123.456.789-01'.	fail→pass	9,162	3,755	-59%	1	1	0%	1,689	3,806	+125%	0	0	—
case-11 Construct a cURL query to retrieve overdue payments for customer 'cus_000111222333' on Asaas.	pass→pass	5,024	3,369	-33%	1	1	0%	935	3,766	+303%	0	0	—
case-12 We want to bill a recurring membership fee of 299.00 BRL every three months in Asaas. What value should be passed for the cycle field in the POST /subscriptions call?	pass→pass	4,196	2,837	-32%	1	1	0%	729	3,627	+398%	0	0	—
case-13 What HTTP method and request path should be used to cancel an existing subscription with ID 'sub_102030405060' in Asaas?	pass→pass	2,889	2,540	-12%	1	1	0%	536	3,614	+574%	0	0	—
case-14 Provide the cURL request to inspect the current available account balance in Asaas.	fail→pass	5,482	2,752	-50%	1	1	0%	935	3,590	+284%	0	0	—
case-15 When transferring funds via Pix to a vendor whose key is a random key (EVP) '123e4567-e89b-12d3-a456-426614174000', what value must be assigned to pixAddressKeyType in the POST /transfers request?	pass→pass	5,578	2,536	-55%	1	1	0%	887	3,580	+304%	0	0	—
case-16 What JSON structure is needed to create a marketplace subaccount for a limited liability company (LTDA) with CNPJ '12345678000199' and postal code '30140-071'?	fail→pass	12,518	4,130	-67%	1	1	0%	2,367	3,903	+65%	0	0	—
case-17 Write a cURL command to fetch the history of confirmed payment events from Asaas.	fail→pass	7,263	3,103	-57%	1	1	0%	1,280	3,634	+184%	0	0	—
case-18 How can I filter customer records in Asaas by CNPJ using the GET /customers API?	pass→pass	7,138	3,085	-57%	1	1	0%	1,345	3,738	+178%	0	0	—
case-19 A customer split a payment into multiple installments. Which sub-resource endpoint under /payments retrieves installment details for payment ID 'pay_123456'?	pass→pass	5,246	1,837	-65%	1	1	0%	920	3,416	+271%	0	0	—
case-20 Provide the payload to create a corporate customer named 'Empresa X' with CNPJ '12.345.678/0001-99' in Asaas.	pass→pass	7,592	2,778	-63%	1	1	0%	1,406	3,654	+160%	0	0	—
case-21 If the ASAAS_SANDBOX environment variable is omitted or set to true, which base URL must be targeted for API calls?	pass→pass	3,359	1,641	-51%	1	1	0%	620	3,391	+447%	0	0	—
case-22 We want to create a charge where the customer can choose any payment method (Pix, Boleto, or Credit Card) at checkout. What billingType value should be sent in POST /payments?	pass→pass	4,492	2,223	-51%	1	1	0%	747	3,502	+369%	0	0	—

These cases were also screened by the skill’s intent / safety pass.See the Trust review ↗Reproduce this benchmark in Colab ↗

How this skill was measured

DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 22 cases were attempted. The headline lift of +27 percentage points is the difference between those two pass rates over the 22 comparable cases.

Model measured: gemini-3.6-flash
Graded by: gemini-3.6-flash
Grading method: judged
Verification: verified
Pass rate without the skill: 59.1%
Pass rate with the skill: 86.4%
Cases attempted: 22
Cases counted toward lift: 22
Cases that regressed: 0
Skill version measured: v1
Run completed: 8/19/2026, 20:32 UTC

Measured example — same prompt, with vs. without the skill · from the benchmark run · case case-01

Prompt

I need to configure a monthly recurring payment in Asaas for an existing customer using bank slip billing. Could you provide the cURL request formatted according to their v3 REST API to set up this subscription with a starting due date of 2026-05-01 for 99.90 BRL?

Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.

Show both answers

SkillScore blends 4 signals1 of 4 complete

BenchmarkPass rate WITH skill on a verified run86

Live evalNeeds ≥20 evaluated traces in 30 days

AI ratingNeeds ≥10 rated traces

AdoptionNeeds ≥10 serves across ≥2 orgs in 30 days

Efficiency · separate axis (at equal correctness)+0% turns+259% tokens

Shown for transparency; not credited unless a verified run shows no correctness regression.

Backed by 1 of 4 signals — each added signal makes the score more robust.

Verified on gemini-3.6-flash · re-tested yesterday

Other measured skills in the registry, with their headline benchmark lift.