Introduction - Transfers

Get to know Transfers

Transfer the available balance in your Asaas account to another linked Asaas account or to an account at another institution.

Choose the flow

DestinationWhen to useNext step
Linked Asaas accountMove balance between the main account and subaccounts or between subaccounts of the same structureTransfer to Asaas account
Account at another institutionTransfer the Asaas balance via Pix or TEDTransfer to accounts at another institution
Pix keyTransfer directly to a Pix keyTransfer to accounts at another institution

Before transferring

It is not possible to transfer an amount greater than the available balance in the source Asaas account.

📘

The balance available for transfer can be checked through the Retrieve account balance endpoint.

Track the processing

The possible statuses of a transfer are:

StatusMeaning
PENDINGTransfer pending
SCHEDULEDTransfer scheduled
BANK_PROCESSINGTransfer in bank processing
BLOCKEDTransfer blocked
DONETransfer completed
CANCELLEDTransfer canceled
FAILEDTransfer failed. Generates the TRANSFER_FAILED event

To track status changes in your integration, prefer Webhooks instead of repeatedly querying the transfer through the API.

Events such as:

  • TRANSFER_DONE;
  • TRANSFER_FAILED;
  • TRANSFER_CANCELLED;

let you update your operation after the transfer is processed.

Asaas also has events for intermediate steps, such as transfer pending, in bank processing or blocked.

See Transfer events.

Next steps


Did this page help you?