Account status events

Listen to Asaas events to keep your integration up to date.

You can use webhooks for your system to be notified about changes in the status of your account or subaccounts. The events that Asaas notifies are:

  • ACCOUNT_STATUS_BANK_ACCOUNT_INFO_APPROVED - Bank account approved.
  • ACCOUNT_STATUS_BANK_ACCOUNT_INFO_AWAITING_APPROVAL - Bank account under review.
  • ACCOUNT_STATUS_BANK_ACCOUNT_INFO_PENDING - Bank account status reverted to pending.
  • ACCOUNT_STATUS_BANK_ACCOUNT_INFO_REJECTED - Bank account rejected.
  • ACCOUNT_STATUS_COMMERCIAL_INFO_APPROVED - Commercial information approved.
  • ACCOUNT_STATUS_COMMERCIAL_INFO_AWAITING_APPROVAL - Commercial information under review.
  • ACCOUNT_STATUS_COMMERCIAL_INFO_PENDING - Commercial information status reverted to pending.
  • ACCOUNT_STATUS_COMMERCIAL_INFO_REJECTED - Commercial information rejected.
  • ACCOUNT_STATUS_DOCUMENT_APPROVED - Documents approved.
  • ACCOUNT_STATUS_DOCUMENT_AWAITING_APPROVAL - Documents under review.
  • ACCOUNT_STATUS_DOCUMENT_PENDING - Document status reverted to pending.
  • ACCOUNT_STATUS_DOCUMENT_REJECTED - Documents rejected.
  • ACCOUNT_STATUS_GENERAL_APPROVAL_APPROVED - Account approved.
  • ACCOUNT_STATUS_GENERAL_APPROVAL_AWAITING_APPROVAL - Account under review.
  • ACCOUNT_STATUS_GENERAL_APPROVAL_PENDING - Account status reverted to pending.
  • ACCOUNT_STATUS_GENERAL_APPROVAL_REJECTED - Account rejected.

Example of JSON to be received [POST]

The notification consists of a POST containing a JSON, as in this example:

{
    "event": "ACCOUNT_STATUS_COMMERCIAL_INFO_APPROVED",
    "accountStatus": {
        "id": "175027c1-029c-41e5-8b9a-e289b9788c33",
        "commercialInfo": "APPROVED",
        "bankAccountInfo": "APPROVED",
        "documentation": "APPROVED",
        "general": "APPROVED"
    }
}

🚧

  • With the introduction of new products and functionalities within Asaas, it's possible that new attributes may be included in the Webhook. It's very important that your code is prepared not to generate exceptions if Asaas returns new attributes not handled by your application, as this could interrupt the synchronization queue.
  • We will send an email and notify on our Discord when new fields are included in the Webhook. The notification will be sent to the email defined in the webhook settings.