GPay Payment Errors

This reference lists error codes, descriptions, types, and HTTP status codes returned by the GPay API. Errors are grouped by operation: payment initiation, retrieving payment details by payment ID, and submitting an OTP.

1. Payment initiation errors

The following errors may occur when initiating a payment request.

Code	Description	Type	Status
`channel_missing`	The `channel` field is required but was not included in the request.	`invalid_request_error`	400
`phone_invalid`	The `phone` field must contain a valid 10-digit Indian phone number (for example, `9090407368`). Value received: `1234567890`	`invalid_request_error`	400
`phone_missing`	The `phone` field is required but was not included in the request.	`invalid_request_error`	400
`provider_missing`	The `provider` field is required but was not included in the request.	`invalid_request_error`	400
`version_missing`	The `version` field must be one of the following supported values: `2021-05-21`, `2022-01-01`, `2022-09-01`, `2023-08-01`, `2025-01-01`, or `2026-01-01`.	`invalid_request_error`	400
`card_cvv_invalid`	The `card_cvv` field must be at least 3 characters long. Value received: `12`	`invalid_request_error`	400
`card_cvv_missing`	The `card_cvv` field is required but was not included in the request.	`invalid_request_error`	400
`card_invalid`	The `card` field is invalid. Provide payment details using one of the following: card details, `card_alias`, `instrument_id`, or `cryptogram`.	`invalid_request_error`	400
`bank_processing_failure`	The transaction could not be created at the banking partner. Retry the request or contact support if the issue persists.	`api_error`	502
`request_invalid`	Cards issued in India cannot be used for transactions where the order currency is non-INR. Value received: `AUD`	`invalid_request_error`	400
`orderpay_not_found`	The specified order is no longer active and cannot be used to initiate a payment.	`invalid_request_error`	404
`card_bank_name_missing`	The `card_bank_name` field is required but was not included in the request.	`invalid_request_error`	400
`card_bank_name_invalid`	The `card_bank_name` field contains an unrecognized value. Accepted values are: `hdfc`, `icici`, `kotak`, `rbl`, `bob`, `axis`, `standard chartered`, `au`, `yes`, `indus`, `fed`, `hsbc`, `citi`, `sbi`, `amex`, `onecard`, or `idfc`. Value received: `INVALID$BANK`	`invalid_request_error`	400
`card_expiry_yy_missing`	The `card_expiry_yy` field is required but was not included in the request.	`invalid_request_error`	400
`card_expiry_yy_invalid`	The `card_expiry_yy` field must be at least 2 characters long. Value received: `0`	`invalid_request_error`	400
`card_expiry_mm_missing`	The `card_expiry_mm` field is required but was not included in the request.	`invalid_request_error`	400
`card_expiry_mm_invalid`	The `card_expiry_mm` field must be at least 2 characters long. Value received: `0`	`invalid_request_error`	400
`card_number_invalid`	The `card_number` field contains an invalid card number. Verify the card number and try again. Value received: `INVALID`	`invalid_request_error`	400
`card_number_missing`	The `card_number` field is required but was not included in the request.	`invalid_request_error`	400
`card_not_found`	The card details could not be retrieved. Verify the card information and try again.	`invalid_request_error`	404
`emi_tenure_missing`	The `emi_tenure` field is required but was not included in the request.	`invalid_request_error`	400
`order_amount_invalid`	The order amount exceeds the maximum allowed value. The amount must be less than `1,000,000`.	`invalid_request_error`	400
`netbanking_account_number_invalid`	The `netbanking_account_number` field must be at least 9 characters long. Value received: `test`	`invalid_request_error`	400
`netbanking_bank_code_invalid`	The `netbanking_bank_code` field contains an invalid value. Provide a supported bank code and try again.	`invalid_request_error`	400
`netbanking_ifsc_invalid`	The `netbanking_ifsc` field contains an invalid IFSC code. Verify the IFSC and try again. Value received: `INVALID`	`invalid_request_error`	400
`request_failed`	The selected payment mode is not configured for this account. Enable the payment mode or contact support.	`invalid_request_error`	400
`currency_invalid`	The `currency` field does not accept `INR` for this request. Use a supported non-INR currency. Value received: `INR`	`invalid_request_error`	400
`currency_missing`	The `currency` field is required but was not included in the request.	`invalid_request_error`	400
`risk_data.customer_ip_invalid`	The `risk_data.customer_ip` field contains an invalid IP address. Provide a valid IPv4 or IPv6 address. Value received: `1.1.1`	`invalid_request_error`	400
`risk_data_ip_address_request_failed`	The IP address could not be resolved. Verify the IP address and try again.	`invalid_request_error`	400
`order_token_missing`	The `order_token` field is required but was not included in the request.	`invalid_request_error`	400
`payment_method_invalid`	The `payment_method` field contains an unrecognized value. Provide a valid payment method and try again.	`invalid_request_error`	400
`payment_method_missing`	The `payment_method` field is required but was not included in the request.	`invalid_request_error`	400
`payment_method_unsupported`	The specified payment method is not supported for this request. Use a supported payment method and try again.	`invalid_request_error`	400

2. Get payment details errors

The following errors may occur when retrieving payment details for an order using a payment ID.

Code	Description	Type	Status
`order_id_invalid`	The `order_id` field contains a value in an invalid format. Provide a correctly formatted order ID and try again. Value received: `#INVALID`	`invalid_request_error`	400
`order_id_missing`	The `order_id` field is required but was not included in the request.	`invalid_request_error`	400
`version_missing`	The `version` field is required but was not included in the request header.	`invalid_request_error`	400
`payment_id_invalid`	The `payment_id` field must be a numeric value. Value received: `INVALID`	`invalid_request_error`	400
`payment_get_failed`	The `payment_id` value is out of the supported integer range and cannot be processed. Value received: `100000000000000000000000000000000000000`	`invalid_request_error`	400
`payment_id_missing`	The `payment_id` field is required but was not included in the request.	`invalid_request_error`	400
`payment_not_found`	No transaction was found for the specified payment ID. Verify the payment ID and try again.	`invalid_request_error`	404
`order_not_found`	No order was found for the specified order reference ID. Verify the order ID and try again.	`invalid_request_error`	404

3. Submit OTP errors

The following errors may occur when submitting an OTP.

Code	Description	Type	Status
`action_missing`	The `action` field is required but was not included in the request.	`invalid_request_error`	400
`cf_payment_id_missing`	The `cf_payment_id` field is required but was not included in the request.	`invalid_request_error`	400

Secure ID

Gpay payment errors

GPay Payment Errors

1. Payment initiation errors

2. Get payment details errors

3. Submit OTP errors

​GPay Payment Errors

​1. Payment initiation errors

​2. Get payment details errors

​3. Submit OTP errors

GPay Payment Errors

1. Payment initiation errors

2. Get payment details errors

3. Submit OTP errors