Google Pay (COPYandPAY)

Google Pay

Introduction

Loading the Google Pay button via COPYandPAY payment widget is just like loading any other brand, i.e. in step 2, GOOGLEPAY must be specified as a brand.

See an example below.


Options

Google Pay provides a list of features that can be used via the API Reference.

As with other options, you can modify the Google Pay behavior by using wpwlOptions.googlePay.

The full reference of all available options is shown below in this page.

To quick start your integration, we recommend use our example code below as a guidance (Click js tab to see the code example).

References

The following table lists all available Google Pay options that you can use with wpwlOptions.googlePay.

ParameterDescriptionExamples
apiVersion

Major API version. For this specification's version this value should be 2.

apiVersion: 2
apiVersionMinor Minor API version. For this specification's version this value should be 0. apiVersionMinor: 0
gatewayMerchantId Gateway account ID provided by your gateway gatewayMerchantId: "your entityId"
allowedAuthMethods Fields supported to authenticate a card transaction.
  • PAN_ONLY: this authentication method is associated with payment cards stored on file with the user's Google Account. Returned payment data includes personal account number (PAN) with expiration month and year.
allowedAuthMethods: ["PAN_ONLY"]
allowedCardNetworks One or more card networks you support also supported by the Google Pay API.:
  • AMEX
  • DISCOVER
  • JCB
  • MASTERCARD
  • VISA
allowedCardNetworks: ["AMEX", "DISCOVER", "JCB", "MASTERCARD", "VISA"]
merchantId A Google merchant identifier issued after your website is approved by Google. Required when PaymentsClient is initialized with an environment property of PRODUCTION. See Google Pay's Integration checklist for more information about the approval process and obtaining a Google merchant identifier. merchantId: "your_merchantId"
merchantName A user-visible merchant name encoded as UTF-8. This name may be shown to the user in the Google Pay payment sheet to describe the merchant requesting payment data. merchantName: "Example Merchant"

Errors

PaymentsError

Errors returned by client JavaScript methods.

PropertyDescription
statusCode Short code describing the type of error.
statusMessage Developer-facing message describing the error encountered and possible steps to correct.

Common errors

Errors you may encounter across all JavaScript methods.

Status CodeDescription
BUYER_ACCOUNT_ERROR The current Google user is unable to provide payment information.
DEVELOPER_ERROR A passed parameter was improperly formatted. An error message may appear in the browser console for all configured environments.
INTERNAL_ERROR General server error.