Skip to main content

Documentation Index

Fetch the complete documentation index at: https://www.cashfree.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
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.
CodeDescriptionTypeStatus
channel_missingThe channel field is required but was not included in the request.invalid_request_error400
phone_invalidThe phone field must contain a valid 10-digit Indian phone number (for example, 9090407368). Value received: 1234567890invalid_request_error400
phone_missingThe phone field is required but was not included in the request.invalid_request_error400
provider_missingThe provider field is required but was not included in the request.invalid_request_error400
version_missingThe 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_error400
card_cvv_invalidThe card_cvv field must be at least 3 characters long. Value received: 12invalid_request_error400
card_cvv_missingThe card_cvv field is required but was not included in the request.invalid_request_error400
card_invalidThe card field is invalid. Provide payment details using one of the following: card details, card_alias, instrument_id, or cryptogram.invalid_request_error400
bank_processing_failureThe transaction could not be created at the banking partner. Retry the request or contact support if the issue persists.api_error502
request_invalidCards issued in India cannot be used for transactions where the order currency is non-INR. Value received: AUDinvalid_request_error400
orderpay_not_foundThe specified order is no longer active and cannot be used to initiate a payment.invalid_request_error404
card_bank_name_missingThe card_bank_name field is required but was not included in the request.invalid_request_error400
card_bank_name_invalidThe 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$BANKinvalid_request_error400
card_expiry_yy_missingThe card_expiry_yy field is required but was not included in the request.invalid_request_error400
card_expiry_yy_invalidThe card_expiry_yy field must be at least 2 characters long. Value received: 0invalid_request_error400
card_expiry_mm_missingThe card_expiry_mm field is required but was not included in the request.invalid_request_error400
card_expiry_mm_invalidThe card_expiry_mm field must be at least 2 characters long. Value received: 0invalid_request_error400
card_number_invalidThe card_number field contains an invalid card number. Verify the card number and try again. Value received: INVALIDinvalid_request_error400
card_number_missingThe card_number field is required but was not included in the request.invalid_request_error400
card_not_foundThe card details could not be retrieved. Verify the card information and try again.invalid_request_error404
emi_tenure_missingThe emi_tenure field is required but was not included in the request.invalid_request_error400
order_amount_invalidThe order amount exceeds the maximum allowed value. The amount must be less than 1,000,000.invalid_request_error400
netbanking_account_number_invalidThe netbanking_account_number field must be at least 9 characters long. Value received: testinvalid_request_error400
netbanking_bank_code_invalidThe netbanking_bank_code field contains an invalid value. Provide a supported bank code and try again.invalid_request_error400
netbanking_ifsc_invalidThe netbanking_ifsc field contains an invalid IFSC code. Verify the IFSC and try again. Value received: INVALIDinvalid_request_error400
request_failedThe selected payment mode is not configured for this account. Enable the payment mode or contact support.invalid_request_error400
currency_invalidThe currency field does not accept INR for this request. Use a supported non-INR currency. Value received: INRinvalid_request_error400
currency_missingThe currency field is required but was not included in the request.invalid_request_error400
risk_data.customer_ip_invalidThe risk_data.customer_ip field contains an invalid IP address. Provide a valid IPv4 or IPv6 address. Value received: 1.1.1invalid_request_error400
risk_data_ip_address_request_failedThe IP address could not be resolved. Verify the IP address and try again.invalid_request_error400
order_token_missingThe order_token field is required but was not included in the request.invalid_request_error400
payment_method_invalidThe payment_method field contains an unrecognized value. Provide a valid payment method and try again.invalid_request_error400
payment_method_missingThe payment_method field is required but was not included in the request.invalid_request_error400
payment_method_unsupportedThe specified payment method is not supported for this request. Use a supported payment method and try again.invalid_request_error400

​
2. Get payment details errors

The following errors may occur when retrieving payment details for an order using a payment ID.
CodeDescriptionTypeStatus
order_id_invalidThe order_id field contains a value in an invalid format. Provide a correctly formatted order ID and try again. Value received: #INVALIDinvalid_request_error400
order_id_missingThe order_id field is required but was not included in the request.invalid_request_error400
version_missingThe version field is required but was not included in the request header.invalid_request_error400
payment_id_invalidThe payment_id field must be a numeric value. Value received: INVALIDinvalid_request_error400
payment_get_failedThe payment_id value is out of the supported integer range and cannot be processed. Value received: 100000000000000000000000000000000000000invalid_request_error400
payment_id_missingThe payment_id field is required but was not included in the request.invalid_request_error400
payment_not_foundNo transaction was found for the specified payment ID. Verify the payment ID and try again.invalid_request_error404
order_not_foundNo order was found for the specified order reference ID. Verify the order ID and try again.invalid_request_error404

​
3. Submit OTP errors

The following errors may occur when submitting an OTP.
CodeDescriptionTypeStatus
action_missingThe action field is required but was not included in the request.invalid_request_error400
cf_payment_id_missingThe cf_payment_id field is required but was not included in the request.invalid_request_error400