Asaas

Asaas is a Brazilian payment institution and billing platform covering Pix, boleto, and cards. Agents create customers and charges, run subscriptions and payment links, handle refunds, splits, transfers, and bill payments, and react to charge events as they happen.

1 trigger 213 actions API key available

Asaas website Platform Documentation Capability data verified 2026-08-25

A charge reaches the received state and Asaas fires the event

Agent reads the charge, its net value, and any split configuration

Agent confirms the money settled rather than merely being confirmed

Get Balance and Get Statement reconcile the settlement against the account

The order is released downstream and the ledger row is written

The finance channel gets the day's settled total and any exceptions

A person decides what happens to the charges that went overdue instead of settling

What This Integration Enables

Asaas is a licensed Brazilian payment institution, not a gateway bolted onto somebody else's bank. That is the fact the whole connector turns on. The same API that raises a boleto, a Pix charge, or a card charge also holds the account it settles into. It moves money out by transfer, pays supplier bills, tops up phones, issues municipal service invoices, files a debt with a credit bureau, and provisions white label sub-accounts with their own keys. For a Brazilian business, the boundary between the billing system and the bank account largely disappears.

FlowRunner agents work both sides of that boundary. They create and reconcile charges across Pix, boleto, and card, run installment plans and subscriptions, manage marketplace splits and escrow, request anticipation on receivables, and read balance and statement directly rather than inferring them. The distinction between a charge that Asaas has confirmed and one that has actually settled is the sort of detail an agent should enforce every time and a person should never have to remember. Where the next step reaches a customer's credit file or moves money out of the account, human-in-the-loop is the default.

Without FlowRunner

Confirmed read as paid A charge that Asaas has merely confirmed is treated as money in the account, and goods ship against a balance that is not there

Collections by calendar Reminders, escalation, and write-off happen when someone gets to them

Reconciliation by export The bank view and the charge view are compared in a spreadsheet after the fact

With FlowRunner

Settlement is the trigger Downstream work waits for the received state, so releases follow money rather than intent

Collections run as a process Notifications, dunning candidates, and overdue lists are assembled continuously and reviewed as exceptions

The account is queryable Balance, statement, and payment statistics are read directly instead of rebuilt from exports

Use Case Scenarios

Charge to settlement, with the ship gate on the right state

An order arrives from the storefront. The agent calls Create Customer or matches an existing one, then Create Charge with the billing type left undefined so the payer picks Pix, boleto, or card at the checkout page. Get Charge Pix QR Code and Get Boleto Line supply whatever the customer's channel needs. The trigger then does the waiting. On the confirmed event the agent records that payment is coming and posts nothing downstream. On the received event it releases the order in Shopify, writes the ledger row to QuickBooks Online, and posts the settled total to Slack. Shipping against confirmed rather than received is the most expensive mistake available here, and the agent simply cannot make it.
Marketplace splits that pay sellers after delivery

A platform charge carries a split to the seller's wallet. Because a split settles when the charge is received rather than when it is created, the agent watches the split rows with List Received Splits and reports the pending ones separately from the paid ones. Where the platform holds funds until delivery is confirmed, Set Account Escrow Config puts the money in escrow at Asaas and Finish Escrow releases it once the carrier event lands. Get Split Statistics feeds the payout summary that reaches the seller dashboard, and the reconciliation sheet in Google Sheets shows what is owed against what has cleared.
A dunning ladder that stops before the credit bureau

Overdue charges are assembled nightly. The agent calls Get Charge Viewing Info first, because a customer who never opened the invoice page is a delivery problem rather than a refusal, and that case routes to a resend instead of an escalation. Real non-payers get Update Notification to tighten the reminder schedule, then a call task in the CRM. Simulate Dunning prices what a credit bureau filing would cost and what it would recover. The list stops there and goes to a person. Nothing is filed automatically.

Human-in-Loop Highlight

Create Dunning is debt registration, negativação, and it is not a firmer reminder email. It files an unpaid charge with a Brazilian credit bureau, which changes a real person's credit standing and can follow them into a mortgage application. Asaas charges to register it and charges again to withdraw it, and the withdrawal is not guaranteed: the charge carries a flag saying whether the registration can still be canceled, and once it has reached the bureau it may not be. So the agent assembles the case and hands it over. It posts: "Charge 118-4402 for R$ 3,180 is 74 days overdue. Three reminders delivered and opened. Simulate Dunning returns a registration fee of R$ 27 and estimates recovery at 41 percent. This customer has two paid charges in the last year. File with the bureau, keep chasing, or write it off?" The credit officer answers. Everything before that question is the agent's work, and the decision that marks a person's credit file stays with somebody who can be held to it.

Agent processes routinely

Detects exception requiring judgment

Clear match Continues automatically

Ambiguous Routes to human via email

Human decides

Agent resumes with decision

Agent Capabilities

213 actions

Customers

Create Customer Creates the payer every charge is raised against. Asaas validates the CPF or CNPJ check digits, so a bad tax number is refused rather than stored.
List Customers Lists customers filtered by name, email, tax number, group, or your own external reference. Paging is by offset and the response says whether more remain.
Get Customer Reads one customer in full, including addresses, tax registrations, and whether notifications are switched off for them.
Update Customer Updates a customer. Only supplied fields change. Changing the tax number on a customer with issued charges is restricted, because it appears on their boletos.
Delete Customer Removes a customer. The removal is soft, which is what makes it safe to call from a workflow.
Restore Customer Brings back a removed customer with their charge history intact.
Get Customer Notifications Reads which reminder channels fire for which events on one customer. The read before switching a single reminder off.

Charges

Create Charge Creates a charge against a customer. Billing type picks the instrument, and leaving it undefined lets the payer choose from whatever the account has enabled.
Create Credit Card Charge Creates a charge and attempts the card immediately rather than sending the customer to a payment page. Authorize-only holds the funds for a later capture.
List Charges Lists charges across the vendor's full filter set, including four separate date ranges and a filter for charges eligible to be sold forward.
Get Charge Reads one charge in full, including the net value that actually reaches the balance rather than the value the customer pays.
Update Charge Updates an unpaid charge. The vendor requires billing type, value, and due date on every call, so read the charge first and pass the current values back.
Delete Charge Removes a charge. The removal is soft and reversible. It is not a refund, and Asaas refuses it on a charge already paid.
Restore Charge Brings back a removed charge with its original due date and value.
Get Charge Status Reads only the status, as a single field. The cheap poll for a workflow waiting on payment.
Refund Charge Refunds a charge in full or in part. On a split charge, the refund pulls money back from the recipient wallets too.
List Charge Refunds Lists every refund issued against one charge, which is how a sequence of partial refunds is seen rather than the aggregate.
Refund Boleto Starts a boleto refund. It does not finish it: Asaas answers a URL a person must open to supply the payer's bank details, so a workflow surfaces the URL rather than reporting the refund as done.
Capture Authorized Charge Captures a charge created as authorize-only. Holds expire after the window in the pre-authorization config, and an expired hold cannot be captured.
Pay Charge With Card Settles an existing boleto or Pix charge by card. Distinguishes an ordinary credit card from a Brazilian meal or food benefit voucher card, which is a separate rail.
Pay Charge With Credit Card Settles an existing charge by credit card, taking the card and cardholder objects separately. A stored token makes both unnecessary.
Confirm Cash Receipt Records that a charge was settled outside Asaas, in cash or by direct transfer. No money moves, and it stops the charge chasing the customer.
Undo Cash Receipt Reverses a recorded cash receipt, returning the charge to unpaid so it resumes chasing.
Get Charge Billing Info Reads every payment instrument generated for a charge in one call: the Pix payload and image, the card details, and the boleto barcode and typeable line.
Get Boleto Line Reads the typeable line and barcode for a boleto, which is what a customer enters in their own banking app.
Get Charge Pix QR Code Reads the Pix copy and paste payload, the image, and when the code expires. The image arrives encoded rather than as a URL.
Get Charge Viewing Info Reads when the customer opened the invoice page and the boleto. Both empty on an overdue charge is evidence of a delivery problem rather than a refusal.
Simulate Sale Simulates fees and net value across several payment types before anything is created. The way a workflow picks the cheapest instrument or shows a customer what installments really cost.
Get Charge Limits Reads how many charges the account may still create in the current window, so a bulk import checks the ceiling instead of failing halfway.
Get Charge Anticipation Restrictions Lists the contractual effects preventing one charge from being anticipated, which is the answer to why an eligible-looking receivable is refused.

Lean Charges

Create Charge (Lean) Creates a charge and returns the reduced response body, which is the form to use when a workflow only needs the identifier and the payment link.
Create Credit Card Charge (Lean) Creates and attempts a card charge with the reduced response.
List Charges (Lean) Lists charges with the reduced payload, which keeps a high-volume sweep cheap.
Get Charge (Lean) Reads one charge with the reduced payload.
Update Charge (Lean) Updates an unpaid charge with the reduced response.
Delete Charge (Lean) Removes a charge, softly, with the reduced response.
Restore Charge (Lean) Restores a removed charge with the reduced response.
Refund Charge (Lean) Refunds a charge with the reduced response.
Capture Authorized Charge (Lean) Captures a held charge with the reduced response.
Confirm Cash Receipt (Lean) Records an out-of-band settlement with the reduced response.
Undo Cash Receipt (Lean) Reverses an out-of-band settlement with the reduced response.

Charge Documents

Upload Charge Document Attaches a document to a charge, such as the contract or delivery note the customer asked for.
List Charge Documents Lists the documents attached to a charge.
Get Charge Document Reads one attached document's metadata and location.
Update Charge Document Updates an attached document's properties.
Delete Charge Document Removes an attached document from a charge.

Installments

Create Installment Plan Splits a fixed total across a number of months. Send either the total for Asaas to divide or the per-installment value, never both.
Create Credit Card Installment Plan Creates an installment plan charged to a card.
List Installment Plans Lists installment plans on the account.
Get Installment Plan Reads one plan with its schedule and totals.
Delete Installment Plan Deletes a plan, which deletes every unpaid charge inside it.
Cancel Installment Charges Cancels the remaining charges in a plan without removing the plan record.
List Installment Charges Lists the individual charges generated by a plan, which is how paid and outstanding months are separated.
Get Installment Payment Book Produces the payment book for a plan, the printable set of slips a customer can pay from.
Refund Installment Plan Refunds the paid charges across a plan.
Update Installment Splits Updates the split configuration across an installment plan's charges.

Subscriptions

Create Subscription Creates an open-ended recurring bill against a customer.
Create Credit Card Subscription Creates a recurring bill charged to a stored card.
List Subscriptions Lists subscriptions with the vendor's filters.
Get Subscription Reads one subscription with its cycle, value, and next due date.
Update Subscription Updates a subscription. Changing the value does not change charges already generated unless the vendor's pending-payments flag is set.
Delete Subscription Ends a subscription so no further charges are generated.
Update Subscription Card Replaces the card a subscription bills, which is the fix for a customer whose card expired.
List Subscription Charges Lists the charges a subscription has generated.
Get Subscription Payment Book Produces the payment book for a subscription.
List Subscription Invoices Lists the municipal service invoices issued for a subscription.
Create Subscription Invoice Settings Sets how municipal invoices are issued for a subscription, so each cycle produces the fiscal document automatically.
Get Subscription Invoice Settings Reads a subscription's invoice settings.
Update Subscription Invoice Settings Updates a subscription's invoice settings.
Delete Subscription Invoice Settings Removes a subscription's invoice settings, stopping automatic issuance.

Payment Links

Create Payment Link Creates a page that can be sent to anyone, any number of times. The instrument for a campaign, a donation, or an ad-hoc sale.
List Payment Links Lists the account's payment links.
Get Payment Link Reads one link with its configuration and status.
Update Payment Link Updates a link's value, description, or availability.
Delete Payment Link Removes a link. The removal is soft.
Restore Payment Link Brings back a removed link.
Add Payment Link Image Adds an image to a link's page.
List Payment Link Images Lists the images on a link.
Get Payment Link Image Reads one image's details.
Delete Payment Link Image Removes an image from a link.
Set Main Payment Link Image Sets which image leads the page.

Checkout and Cards

Create Checkout Creates a hosted checkout session for a specific transaction.
Cancel Checkout Cancels an open checkout session.
Tokenize Credit Card Exchanges card details for a reusable token, which keeps card data out of every later workflow and is what makes a card subscription possible.
Set Pre-Authorization Config Sets how long an authorize-only hold survives before it expires uncapturable.
Get Pre-Authorization Config Reads the current hold window, which is the number a delayed-capture workflow has to be designed around.

Anticipations

Simulate Anticipation Returns the fee and net figure for selling a receivable forward, before anything is requested.
Request Anticipation Requests anticipation on a receivable. A request can be denied with an explanation, and the denial arrives as its own event rather than in the response.
List Anticipations Lists anticipation requests and their outcomes.
Get Anticipation Reads one anticipation request, including any denial note.
Cancel Anticipation Cancels a pending anticipation request.
Set Automatic Anticipation Switches on automatic anticipation, which turns a case-by-case decision into a standing one.
Get Automatic Anticipation Reads the current automatic anticipation setting.
Get Anticipation Limits Reads how much the account may still anticipate.

Chargebacks

List Chargebacks Lists chargebacks raised against the account.
Get Chargeback Reads one chargeback with its reason and deadline.
Dispute Chargeback Files the account's response to a chargeback with the supporting documentation.

Splits and Escrow

List Paid Splits Lists splits paid out of the account to other wallets.
Get Paid Split Reads one outgoing split, including a status that flags when the split totals no longer match the charge after a partial refund.
List Received Splits Lists splits received into the account from other Asaas accounts.
Get Received Split Reads one incoming split.
Set Default Escrow Config Sets the account's default escrow behavior for charges that carry splits.
Get Default Escrow Config Reads the default escrow behavior.
Set Account Escrow Config Sets escrow behavior for a specific account relationship.
Get Account Escrow Config Reads escrow behavior for a specific account relationship.
Get Charge Escrow Reads the escrow state on one charge, which is what says whether the money is still held.
Finish Escrow Releases held money to its recipient. The marketplace primitive for paying a seller once delivery is confirmed.

Notifications

Update Notification Switches one reminder channel or event on or off for one customer. Notifications are per customer, so the change applies to every future charge to them.
Update Notifications Batch Applies notification changes across several customers in one call.

Credit Bureau and Debt Registration

Create Credit Bureau Report Orders a credit report on a prospective payer before extending terms.
List Credit Bureau Reports Lists the reports ordered on the account.
Get Credit Bureau Report Reads one credit report.
Simulate Dunning Prices a debt registration and estimates recovery before anything is filed. The read that belongs in front of this page's human gate.
Create Dunning Files an unpaid charge with a Brazilian credit bureau. This affects a real person's credit standing, carries a fee both to register and to withdraw, and is not always withdrawable.
List Dunnings Lists filings raised from the account.
Get Dunning Reads one filing, including whether it can still be canceled and whether the bureau refused the paperwork.
Get Dunning History Reads the history of one filing's state changes.
Get Dunning Payments Reads payments recovered against a filing.
List Chargeable Debts Lists the charges eligible to be filed, which is the candidate list a person reviews.
Resend Dunning Documents Resupplies the supporting paperwork when the bureau has refused it.
Cancel Dunning Withdraws a filing where the vendor still allows it.

Municipal Invoices

Schedule Invoice Schedules a Brazilian municipal service invoice for a charge or customer.
List Invoices Lists issued municipal invoices with their effective dates.
Get Invoice Reads one municipal invoice with its status and document links.
Update Invoice Updates a scheduled invoice before it is authorized.
Authorize Invoice Sends a scheduled invoice to the municipality for authorization.
Cancel Invoice Cancels an issued invoice with the municipality.
Get Municipal Options Reads the issuing options the account's municipality supports.
Set Fiscal Info Stores the municipal credentials without which no invoice can be issued.
Get Fiscal Info Reads the stored fiscal configuration.
Set National Portal Configures issuance through Brazil's national portal.
List Municipal Services Lists the service codes the account's city publishes. Every city keeps its own list, so this cannot be hard-coded.
List Federal Service Codes Lists the federal service codes available for an invoice line.
List NBS Codes Lists Brazilian service nomenclature codes.
List Operation Indicator Codes Lists the operation indicators an invoice line can carry.
List Tax Classification Codes Lists the tax classification codes available on an invoice.
List Tax Situation Codes Lists the tax situation codes available on an invoice.

Pix Keys and QR Codes

Create Pix Key Creates a Pix key on the account.
List Pix Keys Lists the account's Pix keys with their status. A key must be active to receive.
Get Pix Key Reads one Pix key.
Delete Pix Key Removes a Pix key from the account.
Look Up Pix Key Resolves somebody else's Pix key to the account behind it, which is the check before paying out.
Get Pix Lookup Quota Reads how many key lookups remain in the current window.
Create Static Pix QR Code Creates a reusable Pix code for a fixed destination, such as a counter or a donation page.
Delete Static Pix QR Code Removes a static Pix code.
Decode Pix QR Code Reads the payload behind a Pix code, which is how a workflow learns who and how much before paying it.

Pix Payments

Pay Pix QR Code Pays a Pix code from the account balance.
List Pix Transactions Lists Pix movements in and out of the account.
Get Pix Transaction Reads one Pix movement.
Cancel Pix Transaction Cancels a scheduled Pix payment before it executes.

Pix Automatico

Create Pix Automatic Authorization Creates a recurring Pix debit authorization, which the payer approves in their own bank.
List Pix Automatic Authorizations Lists recurring Pix authorizations and their states.
Get Pix Automatic Authorization Reads one authorization.
Cancel Pix Automatic Authorization Cancels a recurring Pix authorization.
List Pix Automatic Instructions Lists the individual debit instructions issued under recurring authorizations.
Get Pix Automatic Instruction Reads one debit instruction and its outcome.
Create Pix Automatic Retry Retries a failed recurring debit within the rules Pix Automatico allows.
List Pix Recurrences Lists recurring Pix schedules on the account.
Get Pix Recurrence Reads one recurring schedule.
Cancel Pix Recurrence Cancels a recurring schedule.
List Pix Recurrence Items Lists the individual scheduled items under a recurrence.
Cancel Pix Recurrence Item Cancels one scheduled item without ending the recurrence.

Transfers and Bill Payments

Create Transfer Moves money out of the account to a bank account or Pix key.
Create Asaas Transfer Moves money to another Asaas account, which settles internally rather than over the banking rails.
List Transfers Lists outbound transfers with their states.
Get Transfer Reads one transfer.
Cancel Transfer Cancels a transfer that has not yet executed.
Simulate Bill Payment Reads what a supplier bill barcode actually represents, including the amount and due date, before paying it.
Create Bill Payment Pays a supplier bill from the account balance.
List Bill Payments Lists bill payments made from the account.
Get Bill Payment Reads one bill payment and its outcome.
Cancel Bill Payment Cancels a scheduled bill payment before it executes.

Mobile Top-Ups

Get Mobile Operator Resolves a phone number to its mobile operator before a top-up is attempted.
Create Mobile Top-Up Buys mobile credit for a number from the account balance.
List Mobile Top-Ups Lists top-ups made from the account.
Get Mobile Top-Up Reads one top-up and its outcome.
Cancel Mobile Top-Up Cancels a scheduled top-up before it executes.

Account and Finance

Get Balance Reads money available now. This is the figure a payout decision should be made against.
Get Statement Reads the account statement, movement by movement.
Get Payment Statistics Returns totals for what is still owed and still settling, in one request rather than by paging thousands of charges.
Get Split Statistics Returns split totals across the account, which is what a marketplace payout summary is built from.
Get Account Status Reads whether the account is cleared to transact and what is blocking it if not.
Get Account Fees Reads the fee schedule the account is on, per instrument.
Get Account Number Reads the account's banking identifiers.
Get Wallet ID Returns the identifier other Asaas accounts need in order to split money to this one.
Get Commercial Info Reads the registered business details behind the account.
Update Commercial Info Updates the registered business details.
Get Checkout Branding Reads the branding applied to hosted checkout pages.
Set Checkout Branding Updates the branding applied to hosted checkout pages.

Account Documents

List Pending Documents Lists the documents Asaas is still waiting for, which is usually what is blocking an account from transacting.
Upload Account Document Files a required account document.
Get Account Document Reads one filed document and its review state.
Update Account Document Replaces a filed document.
Delete Account Document Removes a filed document.
Delete My Account Closes the account holding the API key. It takes no identifier because it acts on the caller, and there is no confirmation and no undo.

Sub-Accounts

Create Sub-Account Provisions a white label sub-account under the platform account.
List Sub-Accounts Lists sub-accounts with their states.
Get Sub-Account Reads one sub-account.
Delete Sub-Account Removes a named sub-account. The vendor states this is irreversible.
Resend Sub-Account Activation Resends the activation message to a sub-account that never completed setup.
Create Sub-Account API Key Issues a key for a sub-account. The value is returned exactly once and cannot be read back, so it must be stored in the same workflow step that creates it.
List Sub-Account API Keys Lists a sub-account's keys by name and date. It does not return key values.
Update Sub-Account API Key Enables or disables a key, which is the reversible way to cut an integration off.
Delete Sub-Account API Key Permanently removes a key.

Webhooks

Create Webhook Registers a webhook configuration with its event list and failure contact.
List Webhooks Lists webhook configurations, including the failure counter that explains a quiet integration.
Get Webhook Reads one webhook configuration.
Update Webhook Updates a webhook's events, destination, or interrupted state. Interrupting a webhook pauses delivery while still collecting events, so nothing is lost while an endpoint is down.
Delete Webhook Removes a webhook configuration.
Remove Webhook Backoff Clears the throttling Asaas applies to a webhook that kept failing, once the endpoint is fixed.

Sandbox

Approve Sandbox Account Skips the document review that would otherwise block a sandbox account, so an end-to-end test can start.
Confirm Sandbox Payment Marks a sandbox charge paid without money moving, and every downstream event, split, and settlement then fires as it would in production.
Force Sandbox Overdue Ages a sandbox charge past its due date immediately, so a collections workflow can be tested in minutes rather than weeks.

Triggers

1 triggers

Event Triggers

On Asaas Event Fires on the full set of events Asaas publishes across charges, invoices, transfers, bills, subscriptions, checkouts, accounts, and anticipations, with an all-events option. The record is lifted out of the vendor's envelope so a workflow reads it directly. The distinction that matters most here is between the confirmed event and the received event: only the second one means the money has settled into the balance.

Frequently Asked Questions

What can FlowRunner do with Asaas?

FlowRunner agents can run Create Customer, List Customers, and Get Customer in Asaas, plus 210 more actions.

Does connecting Asaas to FlowRunner require OAuth?

No. Asaas connects to FlowRunner with an API key, no OAuth flow required.

Can Asaas trigger a FlowRunner workflow automatically?

Yes. Asaas supports 1 trigger that can start a FlowRunner workflow automatically.

Start building with Asaas

Free plan, no card required. Connect in minutes.

Start Building Free Talk to us