| Payment Status |
| SUCCESS | Transaction Successful The payment was successfully authorized by the merchant's backend. Return this transactionState in PaymentAuthorizationResult to close the Google Pay sheet with a success confirmation. | Success | Common | T0 |
| READY_TO_PAY_TRUE | Ready to Pay IsReadyToPayResponse.result = true. The visitor's browser and Google account can provide a payment method. The Google Pay button should be displayed. | Success, Info | Common | T0 |
| READY_TO_PAY_FALSE | Not Ready to Pay IsReadyToPayResponse.result = false. The visitor cannot provide payment information via Google Pay (e.g., unsupported browser, no Google account). Hide the Google Pay button and offer alternatives. | Info | Occasional | T3 |
| NO_PAYMENT_METHOD_PRESENT | No Payment Method Present IsReadyToPayResponse.paymentMethodPresent = false. The user's Google account has no saved payment methods matching the merchant's allowedPaymentMethods. Show the Google Pay button with a 'Set up' prompt. | Info | Occasional | T3 |
| USER_CANCELLED | User Cancelled The user closed the Google Pay payment sheet without authorizing the payment. The loadPaymentData promise is rejected. No charge was made; treat as an abandoned checkout and return the user to the cart. | Info | Common | T0 |
| ABORTED | Payment Aborted The payment flow was aborted programmatically (e.g., the payment app returned RESULT_CANCELED without user interaction). Typically occurs in TWA/Android integrations. Retry the payment request. | Info, Error | Occasional | T0 |
| INITIALIZE | Callback: Initialize The onPaymentDataChanged callback was triggered during initialization of the payment sheet. Use to pre-populate or validate shipping options and order summary before the user interacts. | Info | Common | T0 |
| SHIPPING_ADDRESS | Callback: Shipping Address Changed The user changed their shipping address in the payment sheet. The onPaymentDataChanged callback fires with an IntermediateAddress. Update shipping options and order totals accordingly. | Info | Common | T0 |
| SHIPPING_OPTION | Callback: Shipping Option Changed The user selected a different shipping option in the payment sheet. Update the order total to reflect the new shipping cost. | Info | Common | T0 |
| OFFER | Callback: Offer Code Entered The user entered a promotional or offer redemption code on the payment sheet. Validate the code and update the order summary with the applicable discount. | Info | Occasional | T0 |
| 499 | Cancelled The operation was cancelled by the client or user. Retry if appropriate. | Info | Occasional | T0 |
| CARD_FUNDING_UNKNOWN | Card Funding Source Unknown CardInfo.cardFundingSource = UNKNOWN. The funding source of the selected card could not be determined. Some processors apply different rules for debit vs. credit; treat with standard processing rules. | Info | Occasional | T0 |
| CARD_FUNDING_PREPAID | Prepaid Card CardInfo.cardFundingSource = PREPAID. The selected card is a prepaid card. Some merchants restrict prepaid cards for subscriptions or high-risk transactions. Validate against merchant policy. | Info | Occasional | T0 |
| Decline Codes |
| ERROR | Transaction Error The payment authorization failed. Return this transactionState in PaymentAuthorizationResult alongside a PaymentDataError object specifying the reason and user-facing message. The sheet remains open for correction. | Error, Decline | Common | T2 |
| PAYMENT_DATA_INVALID | Payment Data Invalid The payment token, card, or payment credentials returned by Google Pay are invalid and cannot be used to process the transaction. Prompt the user to select a different payment method or retry. | Error, Decline | Occasional | T0 |
| BUYER_ACCOUNT_ERROR | Buyer Account Error The current Google user is unable to provide payment information. This may occur due to account suspension, missing payment methods, or the user being in an unsupported region. Offer an alternative payment method. | Error, Decline | Occasional | T2 |
| OR-CCSEH-22 | Issuer Declined Payment The issuing bank declined the payment. Typically caused by the bank not enabling international or online transactions. The customer should contact their card issuer. | Decline | Common | T2 |
| OR-HDT-14 | Incorrect Card Info The card information is incorrect. Customer should verify and correct card details or use a different card. | Decline | Common | T0 |
| OR-CCSEH-32 | Transaction Declined – Try Different Method The transaction was declined. Customer should try a different payment method or contact their card issuer. | Decline | Common | T2 |
| OR-PMCR-32 | Carrier Billing Declined The purchase on a telecom carrier billing account was declined or the transaction cannot be completed. Customer should select a different payment method. | Decline | Occasional | T3 |
| OR_CCREU_01 | Invalid Payment Method Transaction declined because the payment method is invalid. Customer should add a new valid payment method. | Decline | Occasional | T0 |
| OR_CCREU_02 | Action Could Not Be Completed The action could not be completed. Customer should try a different payment method or contact Google Pay support. | Decline, Error | Occasional | T2 |
| OR_CCREU_03 | Request Failed – Contact Bank The payment request failed. Customer should use a different payment method or contact their bank. | Decline | Occasional | T2 |
| OR_CCREU_05 | Payment Method Linked to Too Many Accounts This action cannot be completed because the payment method is linked to too many Google Accounts. Customer must add a different payment method. | Decline | Rare | T3 |
| OR_PMCR_58 | Payment Failed – Contact Issuer Payment failed. Customer should try another payment method or contact their card issuer for more information. | Decline | Occasional | T2 |
| OR_ISMF_08 | Payment Failed – Try Later Payment failed. Customer should try again later or use another payment method. | Decline | Occasional | T0 |
| Error Codes |
| ERROR | Transaction Error The payment authorization failed. Return this transactionState in PaymentAuthorizationResult alongside a PaymentDataError object specifying the reason and user-facing message. The sheet remains open for correction. | Error, Decline | Common | T2 |
| PAYMENT_DATA_INVALID | Payment Data Invalid The payment token, card, or payment credentials returned by Google Pay are invalid and cannot be used to process the transaction. Prompt the user to select a different payment method or retry. | Error, Decline | Occasional | T0 |
| SHIPPING_ADDRESS_INVALID | Shipping Address Invalid The shipping address selected by the customer is invalid (e.g., missing required fields, incorrect postal code format). The payment sheet remains open for the user to correct the address. | Error | Occasional | T0 |
| SHIPPING_ADDRESS_UNSERVICEABLE | Shipping Address Unserviceable The shipping address is valid but cannot be serviced by the merchant (e.g., delivery not available to selected country or region). The payment sheet prompts the user to pick a different address. | Error | Occasional | T0 |
| SHIPPING_OPTION_INVALID | Shipping Option Invalid The selected shipping option is invalid for the given address (e.g., the option is no longer available or does not apply to the selected region). The sheet prompts the user to select a valid option. | Error | Occasional | T0 |
| OFFER_INVALID | Offer / Promo Code Invalid The promotional or offer redemption code entered on the Google Pay sheet is invalid, expired, or cannot be applied. The sheet stays open for the user to enter a valid code or proceed without one. | Error | Occasional | T0 |
| OTHER_ERROR | Other Error A general or unclassified error occurred during payment processing. Use when no specific PaymentDataError reason applies. Provide a descriptive message to guide the user. | Error | Occasional | T0 |
| BUYER_ACCOUNT_ERROR | Buyer Account Error The current Google user is unable to provide payment information. This may occur due to account suspension, missing payment methods, or the user being in an unsupported region. Offer an alternative payment method. | Error, Decline | Occasional | T2 |
| DEVELOPER_ERROR | Developer / Configuration Error A passed parameter is improperly formatted or the API request is malformed (e.g., typo in a field name, invalid enum value, missing required property). Check the browser console for details. Fix the integration before retrying. | Error | Common | T1 |
| MERCHANT_ACCOUNT_ERROR | Merchant Account Error The site accessing the Google Pay API does not have the required permissions. Common causes: the merchant has not been approved for production use, incorrect merchantId, or the domain is not registered in the Google Pay & Wallet Console. | Error | Occasional | T1 |
| INTERNAL_ERROR | Internal Server Error A general server-side error occurred on Google's payment infrastructure. Retry after a short delay. If the issue persists, contact Google Pay support. | Error | Occasional | T0 |
| ABORTED | Payment Aborted The payment flow was aborted programmatically (e.g., the payment app returned RESULT_CANCELED without user interaction). Typically occurs in TWA/Android integrations. Retry the payment request. | Info, Error | Occasional | T0 |
| 400 | Invalid Argument The request contains an invalid argument (e.g., malformed field, unsupported enum value). Review and correct the request before retrying. | Error | Common | T0 |
| 504 | Deadline Exceeded The deadline expired before the operation could complete. Retry with an appropriate timeout. | Error | Occasional | T0 |
| 404 | Not Found The requested entity was not found. Verify the resource identifiers in the request. | Error | Occasional | T0 |
| 409 | Aborted / Already Exists The operation was aborted due to a concurrency conflict, or the entity already exists. For idempotent operations, check current state before retrying. | Error | Occasional | T0 |
| 403 | Permission Denied The caller does not have permission to execute the specified operation. Verify API credentials and merchant permissions. | Error | Occasional | T1 |
| 429 | Resource Exhausted The resource or quota has been exhausted (e.g., rate limit exceeded). Implement exponential back-off and retry. | Error | Occasional | T0 |
| 500 | Internal / Unknown Error An internal or unknown server error occurred. Retry after a delay. Contact Google Pay support if the issue persists. | Error | Occasional | T0 |
| 503 | Service Unavailable The Google Pay service is temporarily unavailable. Retry with exponential back-off. | Error | Occasional | T0 |
| 401 | Unauthenticated The request does not have valid authenticated credentials. Verify and refresh the authentication token. | Error | Occasional | T1 |
| OR_CCREU_02 | Action Could Not Be Completed The action could not be completed. Customer should try a different payment method or contact Google Pay support. | Decline, Error | Occasional | T2 |
USA
