Skip to main content

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 codeDescriptionApplicable API Function(s)
1000Processing error occurred.- fx.rateGet
- fx.rateGet.p2a
- card.createToken
- card.infoGet
- partner.statementGet
- pay.toAccount
- pay.toCard
- getBalance
- task.statusGet
2000You 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
3000Failed to save card.
3001Tokenised card not found. Please try again with the corrected card token.
3002Unable to decrypt tokenised card. Please try again with the corrected card token.
3003Single transaction limit reached.
3004Aggregate transaction limit reached.
3005Processing error occurred.- fx.rateGet
- fx.rateGet.p2a
- task.statusGet
3006Unable to find requested data. Please check the request parameters and try again.- partner.statementGet
- task.statusGet
3007Failed to get saved card by token. Please try again later or use other card.
3008Wrong Source Transaction Instrument provided (no such account Id)- pay.toAccount
- pay.toCard
3009Insufficient Balance
4000Generic decline. Try again and refer to card issuer if issue persists.- pay.toCard
- task.statusGet
4002The issuer is temporarily unavailable or has a system issue.- pay.toCard
- task.statusGet
4003Approval amount or frequency limit exceeded. Try again later, send a smaller amount or use another card or account.- pay.toAccount
- pay.toCard
- task.statusGet
4004Insufficient funds in the recipient account. Please use a different card.- pay.toCard
- task.statusGet
4005Issues with the card information or transaction data.- pay.toCard
- task.statusGet
4006Declined due to account restrictions or bank policies. Recipient needs to contact the receiving bank.- pay.toAccount
- pay.toCard
- task.statusGet
4007Declined for security or regulatory reasons. Recipient needs to contact the receiving bank.- pay.toAccount
- pay.toCard
- task.statusGet
4008Account owner refused incoming money transfer. Please contact the account owner.- pay.toAccount
- task.statusGet
4009Issues with the account information or transaction data: {error_text}.- pay.toAccount
- task.statusGet
4010Transaction cancelled.- pay.toAccount
- task.statusGet
4011Invalid recipient currency- pay.toAccount
- task.statusGet
4012Transaction amount is greater than maximum allowed for transaction- pay.toAccount
- task.statusGet
4013Incorrect IFSC or BIC code- pay.toAccount
- task.statusGet
4014Sender address is incorrect or invalid- pay.toAccount
- task.statusGet
4015Incorrect branch name or code- pay.toAccount
- task.statusGet
4016Recipient name does not match the account- pay.toAccount
- task.statusGet
4017Invalid Recipient bank account number- pay.toAccount
- task.statusGet
4018IBAN provided is invalid- pay.toAccount
- task.statusGet
4200Unable to check transaction status.
9999Unknown error. Please contact customer support.- pay.toAccount
- task.statusGet