Error objects

AI-generated Key Takeaways

• This reference guide details Google Pay API error objects for websites.

• These error objects provide information about why a Google Pay request failed.

• The PaymentsError object includes a status code and message to help you debug.

• Common Google Pay API errors include buyer, developer, and merchant account issues.

• Refer to the linked resources for details on request and response objects related to Google Pay.

This reference describes the Google Pay API error object options to use with your website. Error objects are objects that are returned by a rejected promise from a client JavaScript method.

Error objects

• PaymentsError

Key Point: The request objects and response objects are covered in their respective pages.

Request objects

• PaymentOptions
• IsReadyToPayRequest
• PaymentDataRequest
• PaymentDataCallbacks
• PaymentDataRequestUpdate
• MerchantInfo
• PaymentMethod
• TokenizationSpecification
• CardParameters
• BillingAddressParameters
• ShippingAddressParameters
• ShippingOptionParameters
• SelectionOption
• TransactionInfo
• ButtonOptions
• PayPalParameters

Response objects

• IsReadyToPayResponse
• PaymentData
• IntermediatePaymentData
• PaymentMethodData
• CardInfo
• PaymentMethodTokenizationData
• DisplayItem
• PaymentAuthorizationResult
• PaymentDataError
• Address
• IntermediateAddress
• SelectionOptionData

PaymentsError

This object contains details about errors returned by client JavaScript methods. Errors might not be displayed in a user-facing dialog.

Property	Type	Description
statusCode	string	Short code that describes the type of error.
statusMessage	string	Developer-facing message that describes the error encountered and possible steps to correct it.

Common errors

This object displays errors that you might encounter across all JavaScript methods. Be sure to check the developer console for additional error messages.

Status Code	Description
BUYER_ACCOUNT_ERROR	The current Google user is unable to provide payment information.
DEVELOPER_ERROR	A passed parameter is improperly formatted. An error message may appear in the browser console for all configured environments.
MERCHANT_ACCOUNT_ERROR	The site accessing the Google Pay API does not have the right permission. This could be due to either an incorrect configuration or an incorrect merchant identifier set in the request. Check the statusMessage field for more details. If you continue to have trouble, please contact support.
INTERNAL_ERROR	General server error.