Get

The lookup resource facilitates the retrieval of metadata associated with mobile money or bank accounts. For instance, prior to creating payment accounts, you can utilize this endpoint to validate whether an account number corresponds to a specific business or individual.

This functionality proves especially valuable in ensuring that only validated payment accounts are utilized; for example, when integrated with other processes, such as payouts, it helps mitigate the risk of costly reversals or refunds resulting from funds being sent to an incorrect recipient.

Account not found

While we strive to ensure that our lookup sources are always up to date with the most recent data, we must consider instances when we cannot retrieve metadata for a requested payment account.

In such cases, our API will respond with the error code LOOKUP_ACCOUNT_NOT_FOUND, providing a way to programmatically determine whether the account lookup was unsuccessful.

For some cases like Kenya mobile money lookups, try again in 5 minutes after getting the LOOKUP_ACCOUNT_NOT_FOUND error. If we respond with the same error again, it is likely that the account is not registered with the operator.

Supported countries/account types