External Account Representation Overview

Deprecation notice

This feature is scheduled for deprecation. If you are currently using it, we recommend contacting Mambu Support to discuss your transition options. Alternatively, you can explore our latest payments module here.

The External Account Representation (EAR) endpoints are used to associate IBANs with Mambu account IDs so that payments made using the Mambu Payment Gateway are routed to the correct accounts.

An IBAN can be mapped to multiple accounts but can only be associated to one account per currency, so, for example, the same IBAN can be mapped to one underlying Mambu account using EUR, another using GBP and another using CHF, but not to two accounts both in EUR denomination.

note

There is a short delay for newly created accounts to be synced with the Mambu Payment Gateway. This means that requests to the EAR endpoints may fail with an ACCOUNT_NOT_FOUND error if made immediately following account creation in Mambu. We recommend implementing a retry mechanism with exponential backoff and low value for maximum number of retries if such an error is received for an account which has just been created.