> ## 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 # 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 |