Error Codes

To provide you with the best experience, we aim to successfully process all API calls. However, financial transactions involve multiple systems and an API call can fail due to external factors in these systems. API calls can also fail due to other unforeseen circumstances such as human error while providing inputs, network errors, and intermittent connectivity.

We use standard HTTP response codes to indicate a successful or failed API call. All successful API calls return a 2XX response code. You can treat any non 2XX HTTP response as a failed call.

The table below lists the various HTTP response codes we return to indicate successful or failed API calls.

Error Parameters

To make it easier for you to identify where the error occurred and how to rectify the error, we return an error message with all non 2XX HTTP response codes.

Shown below are sample error responses for different non 2XX HTTP response codes.

{
  "error": {
    "type": "authentication_error",
    "message": "Invalid secret key."
  }
}

{
  "error": {
    "type": "invalid_method",
    "code": "resource_missing",
    "message": "API does not support this method.",
    "param": "null"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "parameter_missing_or_invalid",
    "message": "The type field must be one of vpa, account_number",
    "param": "type"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "duplicate_request",
    "message": "duplicate request"
  }
}

{
  "error": {
    "type": "internal_system_error",
    "message": "something went wrong",
    "trace_id": "bfa30905-e73b-8d86-f656-6c64ac308634"
  }
}

{
  "error": {
    "type": "service_provider_error",
    "code": "downstream_error",
    "message": "we are unavailable to process the request due to an error with our service provider. Please try again after some time"
  }
}

The below table gives a brief description of the different parameters in the error message sent with all non-2XX HTTP response codes.