Error codes and messages help identify and communicate issues that occur during API requests or transaction processing. They provide clear, structured feedback to help developers understand what went wrong and how to resolve it.

What are Error Codes and Error Messages ?

Error codes are standardized identifiers returned when a request fails or cannot be processed, with each code mapping to a specific error scenario for easier programmatic handling. Error messages accompany these codes as human-readable descriptions, providing additional context and guidance to help understand and resolve the issue.

Example:

• EC-BL-0250Owner Type can not be null for business customer
• EC-BL-0526 Maximum no. of attempts reached, Account verification Failed.

Response Structure

Errors are typically returned in a structured format within the API response

{
  "errorCode": "EC-VA-0071",
  "message": "Required field 'amount' is missing",
  "details": [
    {
      "field": "amount",
      "issue": "This field is required"
    }
  ]
}

Best Practices

• Always log both error codes and messages for troubleshooting
• Use error codes for logic handling, and messages for display/debugging
• Avoid exposing sensitive system details in error messages
• Refer to the Error Code Reference for a complete list of supported errors