Direct debit deposit error codes

This page provides a list of general errors and detailed descriptions when you retrieve a direct debit deposit from Linked Accounts with a failure status (one of REJECTED or REVERSED) via Get a list of deposits API or Get a deposit by ID API, after receiving a webhook event.

For a direct debit deposit with a failure status, the response contains a failure_details object with:

• code: Error code for this direct debit deposit
• iso_code: Error code according to ISO 20022 standards

• provider_failure_details: If the error originated from the local clearing system, the response will contain this object with:

  • local_clearing_system: name of the direct debit scheme e.g. United Kingdom Bacs (UK_BACS)
  • code: error code directly from the clearing system
  • message: error message directly from the clearing system

Please refer to the scheme-specific errors that could be returned under provider_failure_details for each region under Direct debit scheme and mandate requirements.

We recommend using the Airwallex error code or the iso_code for systematic exception handling. The code from provider_failure_details can be used for troubleshooting against the clearing system rules, but it is not advised for systematic handling because the clearing system may update it from time to time.