Error Codes
❌ Error Codes Reference
🔐 Authentication Errors
| Error Code | Endpoint | Description |
|---|---|---|
| CUSTOMER_NOT_FOUND | All | The username and password used for authentication could not be found in the system |
| UNAUTHORIZED_CUSTOMER | All | The MID header is either empty or could not be found in the system |
🔔 Webhook Errors
| Error Code | Error Type | Description |
|---|---|---|
| PAYMENT_NOT_COMPLETED | Order | User has cancelled the payment or did not complete it within the session |
| NAME_NOT_MATCHED | Compliance | User name on the sender's bank account did not match with APARA |
| BIOMETRICS_CHECK_FAILED | Compliance | User's device failed the biometric check |
| USER_CONSENT_NOT_PROVIDED | Compliance | User did not provide consent within the defined time |
| BEHAVIORAL_CHECK_IN_REVIEW | Compliance | Biometric check of the user's device is under review |
| BEHAVIORAL_CHECK_FAILED | Compliance | Biometric check of the user's device has failed |
| AMOUNT_MISMATCH | Order | The payment amount does not match the expected amount |
| AUTHENTICATION_FAILED | Order | User authentication failed |
| BANK_ACCOUNT_ALREADY_IN_USE | Order | This bank account is already linked to another user |
| BANK_UNDER_MAINTENANCE | Order | There was a technical issue with the bank |
| DECLINED_BY_BANK | Order | Bank has declined this transaction |
| INVALID_ACCOUNT_DETAILS | Order | The provided account details are invalid |
| TRANSACTION_EXPIRED | Order | Payment was not completed within the allowed time |
| VALIDATION_FAILED | Order | Validation failed for the transaction |
| TRANSACTION_FAILED | Order | Transaction has failed |
| OTHERS | Any | An unexpected error occurred |
🔄 Transfer Errors
| Error Code | Endpoint | Description |
|---|---|---|
| TRANSFER_NOT_FOUND | Order | Transfer not found |
| UNKNOWN_TRANSFER_FLOW | Order | Transfer flow is unknown or unsupported |
| INVALID_ORDER_TYPE | Order | Order type is invalid for the requested flow |
| INVALID_SETTLEMENT_TYPE | Order | Settlement type is not allowed for the flow |
| USER_ID_REQUIRED | Order | User ID is required for the transfer |
| DESTINATION_USER_NOT_FOUND | Order | Destination user not found |
| RECIPIENT_USER_NOT_FOUND | Order | Recipient user not found |
| COUNTRY_NOT_ALLOWED | Order | User or organization country is not allowed for the flow |
| QUOTE_INSUFFICIENT_ORDER_AMOUNT | Order | Quote/order amount is below the minimum required |
| AMOUNT_VALIDATION_FAILED | Order | Amount validation failed for the transfer |
| SOURCE_AMOUNT_VALIDATION_FAILED | Order | Source amount validation failed for the transfer |
| DESTINATION_AMOUNT_VALIDATION_FAILED | Order | Destination amount validation failed for the transfer |
| SOURCE_AMOUNT_REQUIRED | Order | Source amount is required |
| WALLET_CREATION_ERROR | Order | Failed to create or fetch wallet for the transfer |
| WALLET_ADDRESS_REQUIRED | Order | Wallet address is required for the flow |
| WALLET_ADDRESS_INVALID | Order | Wallet address failed validation |
| SENDERS_WALLET_ADDRESS_INVALID | Order | Sender's wallet address failed validation |
| INVALID_DESTINATION_CURRENCY | Order | Destination currency is invalid for the flow |
| PAYMENT_CODE_AND_PAYMENT_TYPE_REQUIRED | Order | Payment code and payment type are required for the transfer |
| PAYMENT_TYPE_REQUIRED | Order | Payment type is required |
| PAYMENT_CODE_REQUIRED | Order | Payment code is required |
| PAYMENT_TYPE_MISMATCH | Order | Payment type does not match the expected value |
| PAYMENT_METHOD_NOT_FOUND | Order | Payment method not found for the given payment code/type |
| SOURCE_PAYMENT_METHOD_NOT_FOUND | Order | Source payment method not found |
| DESTINATION_PAYMENT_METHOD_NOT_FOUND | Order | Destination payment method not found |
| SOURCE_PAYMENT_TYPE_REQUIRED | Order | Source payment type is required |
| SOURCE_PAYMENT_CODE_REQUIRED | Order | Source payment code is required |
| DESTINATION_PAYMENT_TYPE_REQUIRED | Order | Destination payment type is required |
| DESTINATION_PAYMENT_CODE_REQUIRED | Order | Destination payment code is required |
| SUCCESS_REDIRECT_URL_REQUIRED | Order | Success redirect URL is required |
| FAILURE_REDIRECT_URL_REQUIRED | Order | Failure redirect URL is required |
| DEVICE_DETAILS_REQUIRED | Order | Device details are required (e.g., for card/headless flows) |
⚙️ Internal Errors
| Error Code | Endpoint | Description |
|---|---|---|
| INTERNAL_SERVER_ERROR | System | An internal server error occurred while processing the request |
| SYSTEM_ERROR | System | An internal system error occurred |
Was this page helpful?
Last updated today
Built with Documentation.AI