Processing error codes
Apart from general Error status and corresponding HTTP code, Enterprise API will provide you with a detailed description of an error using error codes provided below.
| Error code | Description | Applicable API Function(s) |
|---|---|---|
| 1000 | Processing error occurred. | - fx.rateGet- fx.rateGet.p2a- card.createToken- card.infoGet- partner.statementGet- pay.toAccount- pay.toCard- getBalance- task.statusGet |
| 2000 | You can receive the 2000 validation error in two formats:- Option 1: Validation error: {field_name}, error: {error_text}. Please try again with corrected payload. - Option 2: {"data":{"validationResult": {"errors": [{"path": "transferAmount","value": "transferAmount","errorTypes": ["0 should be greater than 0"]}],"status": "Error","message": "Validation error."}}} | - pay.toAccount- pay.toCard |
| 3000 | Failed to save card. | |
| 3001 | Tokenised card not found. Please try again with the corrected card token. | |
| 3002 | Unable to decrypt tokenised card. Please try again with the corrected card token. | |
| 3003 | Single transaction limit reached. | |
| 3004 | Aggregate transaction limit reached. | |
| 3005 | Processing error occurred. | - fx.rateGet- fx.rateGet.p2a- task.statusGet |
| 3006 | Unable to find requested data. Please check the request parameters and try again. | - partner.statementGet- task.statusGet |
| 3007 | Failed to get saved card by token. Please try again later or use other card. | |
| 3008 | Wrong Source Transaction Instrument provided (no such account Id) | - pay.toAccount- pay.toCard |
| 3009 | Insufficient Balance | |
| 4000 | Generic decline. Try again and refer to card issuer if issue persists. | - pay.toCard- task.statusGet |
| 4002 | The issuer is temporarily unavailable or has a system issue. | - pay.toCard- task.statusGet |
| 4003 | Approval amount or frequency limit exceeded. Try again later, send a smaller amount or use another card or account. | - pay.toAccount- pay.toCard- task.statusGet |
| 4004 | Insufficient funds in the recipient account. Please use a different card. | - pay.toCard- task.statusGet |
| 4005 | Issues with the card information or transaction data. | - pay.toCard- task.statusGet |
| 4006 | Declined due to account restrictions or bank policies. Recipient needs to contact the receiving bank. | - pay.toAccount- pay.toCard- task.statusGet |
| 4007 | Declined for security or regulatory reasons. Recipient needs to contact the receiving bank. | - pay.toAccount- pay.toCard- task.statusGet |
| 4008 | Account owner refused incoming money transfer. Please contact the account owner. | - pay.toAccount- task.statusGet |
| 4009 | Issues with the account information or transaction data: {error_text}. | - pay.toAccount- task.statusGet |
| 4010 | Transaction cancelled. | - pay.toAccount- task.statusGet |
| 4011 | Invalid recipient currency | - pay.toAccount- task.statusGet |
| 4012 | Transaction amount is greater than maximum allowed for transaction | - pay.toAccount- task.statusGet |
| 4013 | Incorrect IFSC or BIC code | - pay.toAccount- task.statusGet |
| 4014 | Sender address is incorrect or invalid | - pay.toAccount- task.statusGet |
| 4015 | Incorrect branch name or code | - pay.toAccount- task.statusGet |
| 4016 | Recipient name does not match the account | - pay.toAccount- task.statusGet |
| 4017 | Invalid Recipient bank account number | - pay.toAccount- task.statusGet |
| 4018 | IBAN provided is invalid | - pay.toAccount- task.statusGet |
| 4200 | Unable to check transaction status. | |
| 9999 | Unknown error. Please contact customer support. | - pay.toAccount- task.statusGet |