Errors - Structure and List

Error Structure

The Payment Gateway response in case of an error includes the following:

  • error_code - Code associated with every error
  • error_description - Description of the error
  • error_source - Source of the error
  • error_reason - Failure reason

Sample error response:


{
  "cf_payment_id": 12376123,
  "order_id": "order_8123",
  "entity": "payment",
  "payment_currency": "INR",
  "order_amount": 10.01,
  "is_captured": true,
  "payment_group": "upi",
  "authorization": null,
  "payment_method": {
    "upi": {
      "channel": "collect",
      "upi_id": "[email protected]"
    }
  },
  "payment_amount": 10.01,
  "payment_time": "2021-07-23T12:15:06+05:30",
  "payment_completion_time": "2021-07-23T12:18:59+05:30",
  "payment_status": "SUCCESS",
  "payment_message": "Transaction successful",
  "bank_reference": "P78112898712",
  "auth_id": "A898101",
  
  "error_details":{
    "error_code":"TRANSACTION_DECLINED",
    "error_description":"issuer bank or payment service provider declined the transaction",
    "error_reason":"auth_declined",
    "error_source":"customer"
  }

List of Errors for Payments

Download the list of errors along with their explanation.

Payment Error List

📘

Note:

Error details will be shown for every failed transaction in the payload of the following APIs and webhook: