Welcome to Dapi

Here you will find comprehensive documentation to help you integrate with Dapi's API as quickly as possible, as well as support if you get stuck. Get started below!

Get Started    

Banking Errors

Input Errors

These errors occur when you or your user have entered incorrect information. Please verify values in your request body and try again.

HTTP Status CodeErrorDescriptionHow to Handle
400BENEFICIARY_NAME_CHARACTER_LIMITThe user provided a beneficiary name that contains too many characters. This bank only supports x number of characters.Prompt your user to enter the beneficiary name again while limiting themselves to the required number of characters.
401INACTIVE_ACCOUNTProvided account number is incorrect or inactive.Verify that the request body contains valid values for request parameters or contact your bank.
401INVALID_CREDENTIALSYour user entered invalid login credentials.Prompt the user to try again.
401INVALID_MFAYour user has entered invalid MFA information (OTP, Secret Question).Prompt the user to try again.
404INVALID_ACCOUNT_IDProvided account ID is incorrect.Verify that the request body contains valid identifiers.
404INVALID_CARD_IDProvided card ID is incorrect.Verify that the request body contains valid identifiers.
400INVALID_DATE_RANGEProvided date range is not supported by the bank.Enter a date range of up to x days.
400PARAMETER_ERRORYour request body contains incorrect parameters.Verify that your request body is properly formatted in accordance to our endpoints.
422PARAMETER_MISSINGYour request body is missing necessary parameters.Verify that your request body is properly formatted in accordance to our endpoints.

Invalid Request Errors

These errors occur when the financial institution does not accept the requested operation. Please see error details below and attempt a different request.

HTTP Status CodeErrorDescriptionHow to Handle
400INSUFFICIENT_BALANCEThe user's account does not have sufficient balance for this transaction.Check the balance and try a different amount.
400BENEFICIARY_NOT_ACTIVATEDBeneficiary has not been activated as two factor authentication is required.Prompt the user to take necessary further action.
400BENEFICIARY_COOL_DOWN_PERIODNew beneficiary will be activated for fund transfer after x hour(s).Attempt transactions once this cool down period has elapsed.
400BENEFICIARY_ALREADY_EXISTSA beneficiary with this account number or IBAN already exists.Try the Create Transfer endpoint instead.
401ACCOUNT_LOCKEDAccount locked out due to too many failed login attempts.Prompt the user to reset their password and try again.
401INACTIVE_ACCOUNTThis account has been deactivated.Prompt the user to contact their bank.
401DUPLICATE_TRANSFERThe same transaction has already been initiated a short time ago.Initiate a different transfer or try again later.
401ACCOUNT_FEATURE_LOCKEDThis operation is locked by the bank.Contact your bank.
400NO_REFERENCE_FOUNDWe couldn't find the reference for this transfer.Verify this transfer manually.
400DAILY_LIMIT_EXCEEDEDThe entered amount exceeds the maximum daily limit set by the user.Inform the user to enter a lesser amount or adjust the daily limit from the user's online banking.
400TRANSACTION_LIMIT_EXCEEDEDYou have exceeded the limit defined for the transaction you are trying to execute.Inform the user to enter a lesser amount or adjust the transaction limit from the user's online banking.
400USER_LIMIT_EXCEEDEDThe amount you have entered exceeds the User limit.Inform the user to enter a lesser amount or adjust the user limit from the user's online banking.
400PART_OF_ANOTHER_SUBPRODUCTThis endpoint is included in a different type of request for this bank (payment/transfer/create).Try the operation using a different type of request.

Retryable Errors

These errors are usually caused by a failed connection to the bank or our servers. Please try the request again.

HTTP Status CodeErrorDescriptionHow to Handle
400UNABLE_TO_CONNECT_TO_BANKFailed attempt to connect to the user's bank.Try again later.
500UNKNOWN_ERRORAn unknown interruption occurred while performing your request.Try again.
401SESSION_INVALIDATEDYour user's session has expired or been terminated by the bank.Retry the request.
400USER_ALREADY_LOGGED_INThis bank does not support concurrent login.Prompt the user to log in again or try again later.
503TEMPORARILY_UNAVAILABLEAn error occurred due to financial institution downtime.Try again.

Implementation Errors

These errors occur when either our system or the financial institution does not support your request. Please try a different operation.

ErrorDescription
CREATE_TRANSFER_TYPE_NOT_SUPPORTEDWe do not currently support this transfer type.
CREATE_BENEFICIARY_SAME_TYPE_NOT_SUPPORTEDWe do not currently support this beneficiary type.
CREATE_TRANSFER_TYPE_NOT_SUPPORTEDWe do not currently support this transfer type.
CREATE_BENEFICIARY_TYPE_NOT_SUPPORTEDWe do not currently support this beneficiary type.
CREATE_BENEFICIARY_INTL_TYPE_NOT_SUPPORTEDWe do not currently support this beneficiary type.
PRODUCT_NOT_SUPPORTEDThe endpoint you are trying to connect is currently not supported.

Updated 23 days ago

Errors


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.