Google Pay

Accept payments from customers using Google Pay, the digital wallet available on Android devices and the Chrome browser. Customers authenticate the charge through Google’s secure payment sheet — no card details are entered manually.

This payment method only supports one-time (non-recurring) payments. It is available on Android devices and in the Chrome browser on any platform where Google Pay is set up.

Payment flow

Several steps occur between collecting the customer’s billing information and completing the charge.

We’ll proceed assuming you’ve already set up a customer order. If you need to create one, you’ll find the steps here.

After creating the order, follow these steps to complete the Google Pay charge.

Collect the customer’s billing information.
Encrypt sensitive data within your request.
Redirect the customer to the Google Pay checkout page to authorise the charge.
Confirm the payment and inform the customer of its outcome.

Google Pay Customer Information

Present the customer with a form to gather their billing details. These are required to initiate the transaction:

Customer information	Parameter	Example	Required
Country	`country`	US	Yes
Customer Name	`card.billingAddress.customerName`	John Smith	Yes
House Number	`card.billingAddress.HouseNumber`	1600	Yes
Street	`card.billingAddress.street`	Amphitheatre Pkwy	Yes
City	`card.billingAddress.city`	Mountain View	Yes
State	`card.billingAddress.state`	California	Yes
Country	`card.billingAddress.country`	US	Yes
Zip code	`card.billingAddress.zipCode`	94043	Yes
Phone Number	`card.billingAddress.PhoneNumber`	+16505551234	Yes

Combine the billing data, order reference, and paymentoption. Encrypt the request before sending it to the pay order endpoint.

{
    "reference": "12345678",
    "paymentoption": "GOOGLEPAY",
    "country": "US",
    "card": {
        "billingAddress": {
            "customerName": "John Smith",
            "HouseNumber": "1600",
            "street": "Amphitheatre Pkwy",
            "city": "Mountain View",
            "state": "California",
            "country": "US",
            "zipCode": "94043",
            "PhoneNumber": "+16505551234"
        }
    }
}

{
  "data": "B9pQJ1HoxybgfjNnEro+26w7lQZ6jriF3AFiUeGH2Ggacn6cF0srUlqiHEXeEncJcMw6ThDobjuS+AsmvhNfvGPGMddjbt5rcK2JrUnUI4cHk0XebJKoNnjEqivcyq0UKEMdYOLd6mYZtvKu5FMlpz0Lo0aMY49pnYvUGLSsCf/wOhlPx9PHgQDXptT+WBJcO3lzeD8O0S4IVSWPCWPLi7GhGlqhZpheEi1FHq39TCHk12hL3sqkkIktZIkkQVAe8AkwZGhy/CMJZrTzU6IXZr2ulT7mJenZljSk66m0pARcUqwMw/+5PEPECDo8SX3IkX2hmym02pGuWZeHE9ONWcaW7h8UIroQ/+kThz/RtP/UMiK3596cij66JcW+RcXKPiqNKysskcnaOlQFIFuhEiAczimLgd320RrQzehaw1C33UGsCzAG1p2EnDthjTF63BZtEhVlu9kN7qtFCz9AvojZeaZFKOxpJJ0usfwl9Hq5oAa56AFt/3IIsvqrAktTOyMgQ/jGQ6uhRYpA6UAH0CcYyv7L99hgVtRTXAxA/rpCtY7aTR9Pjxb5Lt1IV0Q1V8fWxAv0yY+ss07qeiSIsccsdJiN4LaMx3RvmDlu54XF68w51L34hOCDj/NBoPVUZrSaCJK2GPJ6CjOHI8q2/U2TkU+y+a80XCAC/rgqGhw="
}

Upon receiving your request, we will return a successful response containing a redirect URL for the Google Pay checkout page.

200 OK

{
    "data": {
        "paymentDetail": {
            "redirectUrl": "https://path/to/google/pay/checkout?ref=EPCLB-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "recipientAccount": null,
            "paymentReference": "CP2C4G375D-9EC2-58D2-B61F-7605GC038E62"
        },
        "bankTransferDetails": null,
        "orderPayment": {
            "orderId": 630,
            "orderPaymentReference": "PGW-PAYREF-E2D3B1C1F43C5G76CCDCBF01H345H644",
            "currency": "USD",
            "statusId": 2,
            "orderPaymentResponseCode": "02",
            "orderPaymentResponseMessage": "pending-authentication",
            "orderPaymentInstrument": null,
            "remarks": "Order payment initiated",
            "totalAmount": 100.00,
            "fee": 0.00
        }
    },
    "status": "success",
    "statusCode": "02",
    "message": "pending-authentication"
}

Authorising the Payment

Redirect the customer to the paymentDetail.redirectUrl. On this page, the customer is presented with the Google Pay payment sheet, where they select their preferred payment method and confirm the charge. Once the customer approves, Google Pay processes the transaction and EPayClub is notified of the outcome. You will receive a webhook containing the final transaction status regardless of whether the payment was approved or declined.

Verifying the Payment

Read the transaction verification section to learn how to verify your Google Pay transactions.

Testing your integration

Kindly contact the support team to enable Google Pay testing on your account.

Follow these guidelines to successfully test your Google Pay integration:

Use a device or browser with Google Pay configured and a test card added to the wallet.
Ensure the billing address details match the country of the test card.
Use test credentials provided by the support team to complete the payment on the hosted page.
Verify the final transaction status using the order verification endpoint or by checking the webhook payload delivered to your configured webhook URL.

Get Started

API Basics

Orders

Payments

Payment flow

Google Pay Customer Information

Authorising the Payment

Verifying the Payment

Testing your integration

​Payment flow

​Google Pay Customer Information

​Authorising the Payment

​Verifying the Payment

​Testing your integration

Payment flow

Google Pay Customer Information

Authorising the Payment

Verifying the Payment

Testing your integration