Google Pay allows customers to make payments on the merchant website using any credit or debit card saved to their Google Account. When a customer pays with Google Pay in apps and on websites, Google Pay shows a payment sheet where they select their preferred card payment method and confirm their purchase.
Use the Google Pay API to request any credit or debit card stored in your customer’s Google account.
Using Google Pay with payabl. Hosted Solution is pretty easy as decryption would be handled by payabl.
Card Networks supported by payabl. are Mastercard and Visa.
Google Pay™ is the trademark of Google LLC.
To make a subscription for this method use Credentials on File (tokenization).
The initial request is sent to /googlepay_init link and follow-up transactions need to be sent to the authorization /payment_authorize link
POST Request -> to /googlepay_init
<- Response (direct, synchronous) with status=0 and redirect_url
Customer is redirected to redirect_url for googlepay
<- HTML response with status=0 (or decline) to return_url
<- Callback (asynchronous) with errorcode= 0 to notification_url
googlepay_init payment request from your server.
Include all required and optional parameters in your request for processing of the payment:
|40 characters||Merchant identification number assigned during account creation|
|max. 40 characters||The field orderid is optional and exclusively for the merchants' convenience|
|digits only, either no decimals or two decimal places (e.g. 8 or 8.50)||Transaction’s total amount that will be deducted from the customer|
|3 characters. ISO 4217||The currency field contains the alpha-3 currency code for the transaction. Links to ISO|
|payabl. Payment methods IDs|
|40 characters||Signature Calculation2|
|max. 50 characters||Customer email. An RFC 822 compliant email address|
|max. 50 characters||First name of the customer|
|max. 50 characters||Last name of the customer|
|max. 255 characters starting with http or https||URL for customer redirection|
You can see a full list of parameters in Authorization.
merchantid=gateway_test&orderid=Payabl-Test&amount=9.99¤cy=EUR&[email protected]&language=en&firstname=John& lastname=Doe&payment_method=121&zip=3035&street=Olympion&house=23&city=Limassol&country=CYP&url_return=https://yourshop.example/thank_you& notification_url=https://yourshop.example/notification&customerip=188.8.131.52&signature=0831c9eea7a5c3cab91eb4bf5d0d9a6471f37cfd
Public Sandbox information
Do not use your personal email address, Order ID with sensitive information, real customer details and credit card data in the public Sandbox. For email field you may use [email protected].
The payment gateway sends to you the response that includes the initiation URL (
redirect_url parameter) for redirecting the customer only if your server received a successful response from the payment gateway after
googlepay_init payment request.
Response fields reference:
|payabl. internal transaction id. Please use this transaction id when referring to the transaction in communications with the payabl. team|
|Transaction error code|
|Brief explanation of transaction decline reason (empty on success)|
|URL for customer redirection to finalize the payment (URL encoded)|
The customer will be redirected immediately to the payabl. Google Pay page to complete the transaction.
After clicking the Google Pay button a payment sheet will appear (see below).
Once the transaction is authorized via fingerprint or face recognition or with a passcode, payment would start processing.
Depending on the type, if the card was saved as PAN_ONLY then depending on the region additional SCA could be required where the end customer would be redirected to their bank page to complete the payment. Redirection would be handled by payabl. itself.
In case if cards were saved as 3D on Google Pay wallet, then the request would be directly sent to the processor to process the amount.
If the transaction was processed successfully, the end-customer will see the notification about the successful result and will be redirected to the merchant’s website via the URL
In parallel, a notification would be received on the
notification_url provided in the initial request by the merchant
While in Google Pay hosted payment page for any reason if the back to the shop is clicked then the customer will be redirected back to the merchant’s website via the
To repeat/retry the payment, the order must be submitted by the merchant again.
For iframe the initial request is the same as per our iframe section.
On payabl. iframe an additional Google Pay option would appear, by clicking on it the end customer would be redirected to payabl. Google Pay hosted payment page.
Google Pay supports refunds which can be initiated only on a successful captured transaction.
The request will send a credit note to the authorization system after the customer has already been charged. The refund amount will be credited to the customer and the merchant’s account will be charged.
The refund can be done in two ways:
- Through API integration
- Through payabl. dashboard
If you have API integration, you can check more in our documentation Refund.
Our Technical Support team is there to help you:
Email: [email protected]
Available Monday – Friday between 09:00 and 17:00 CET/CEST
Updated 4 months ago