> ## Documentation Index
> Fetch the complete documentation index at: https://flutterwaveinc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Pay™️

> Learn how to process payments using Google Pay.

<Info>
  We recommend checking out the [introductory
  section](/payment-api/introduction) to understand the basics of direct
  charge first. This guide assumes you've read that.
</Info>

With Google Pay, Customers can make payments with cards linked to their Google accounts. They can choose from these linked cards to make one-touch payments on the modal. This payment experience elevates UX in your application.

<Warning>
  All merchants using this payment method must adhere to the Google Pay APIs
  [Acceptable Use Policy](https://payments.developers.google.com/terms/aup)
  and accept the terms defined in the Google Pay API [Terms of
  Service](https://payments.developers.google.com/terms/sellertos).
</Warning>

## Prerequisites

Before starting your integration, you should:

1. Ensure that your Flutterwave account is live.
2. Register your business/app on [Google Pay and Wallet Console](https://pay.google.com/business/console/home).
3. Inform your customers whether Google Pay is available in their region. Here is a [list of countries](https://support.google.com/pay/answer/9023773) where you can use Google Pay.
4. Prompt your customers to link their [cards](https://support.google.com/pay/answer/7625139) to their Google account or confirm that they already have a linked card. Google Pay supports Visa, Mastercard, and American Express cards globally. It also supports regional cards like Discover (US 🇺🇸), Elo (Brazil 🇧🇷), Interac (Canada 🇨🇦), and Maestro (EU and Brazil).
5. Confirm that your browser supports Google Pay. You can see the full list of [supported browsers here](https://developers.google.com/pay/api/web/guides/setup#get-started).

## Payment Flow

While the customer pays with just one tap, the complexity of the payment has been abstracted from the customer. As a developer, here are the steps to follow:

1. Initiate the payment.
2. Redirect the user securely. (only redirect URLs with https TLS1.2 and above will be approved for use)
3. Complete the payment.

<img src="https://mintcdn.com/flutterwaveinc/8LJ4mpYLmd_SNb9Z/images/GPay_flow.png?fit=max&auto=format&n=8LJ4mpYLmd_SNb9Z&q=85&s=2845f6928484f268298f950b8081d122" alt="G_pay_floe" width="2077" height="3520" data-path="images/GPay_flow.png" />

### Step 1: Initiating the Payment

First, you'll need the customer's `email`. Combine that with the rest of the payment details to create the payload and send it to our charge [endpoint](/api-reference/charges#google-pay). You'll need to specify `amount`, `currency`, `fullname` and a unique `tx_ref`. You can also pass more details, like the `fullname` and custom `meta` information. See the [endpoint reference](/api-reference/charges#google-pay) for all parameters that can be passed.

```json cURL theme={null}
# Google Pay
curl --request POST\
   --url https://api.flutterwave.com/v3/charges?type=googlepay\
   --header'Authorization: Bearer YOUR_SECRET_KEY'\
   --header'content-type: application/json'\
   --data'{
     "amount": 100,
     "currency": "USD",
     "email": "developers@flutterwavego.com",
     "fullname": "Flutterwave Developers",
     "tx_ref": "BJUYU399fcd43_success_mock"
}'
```

Generating a payment link via [standard](/payment-api/flutterwave-standard) would open a modal like this.

<img src="https://mintcdn.com/flutterwaveinc/8LJ4mpYLmd_SNb9Z/images/checkout_google_pay.png?fit=max&auto=format&n=8LJ4mpYLmd_SNb9Z&q=85&s=359e2660d7597fbffe66db8553ec7fc4" alt="google_pay_charge" width="2711" height="1344" data-path="images/checkout_google_pay.png" />

### Step 2: Redirecting your Customers

<iframe
  width="560"
  height="315"
  src="https://www.youtube.com/embed/xc1_6AWOos4?si=ITss4g_10bEhV1WQ"
  title="Google pay"
  frameborder="0"
  allow="accelerometer; 
autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
  referrerpolicy="strict-origin-when-cross-origin"
  allowfullscreen
/>

After a successful charge, You'll get a response that looks like this:

```json Sample Response theme={null}
{
   "status":"success",
   "message":"Charge initiated",
   "data":{
      "id":2615403,
      "tx_ref":"MC-TEST-1234568_success_mock",
      "flw_ref":"RQFA6549001367743",
      "device_fingerprint":"gdgdhdh738bhshsjs",
      "amount":10,
      "charged_amount":10,
      "app_fee":0.38,
      "merchant_fee":0,
      "processor_response":"Payment token retrieval has been initiated",
      "auth_model":"GOOGLEPAY_NOAUTH",
      "currency":"USD",
      "ip":"54.75.56.55",
      "narration":"Test Google Pay charge",
+     "status":"pending",
      "auth_url":"https://rave-api-v2.herokuapp.com/flwv3-pug/getpaid/api/short-url/XPtNw-WkQ",
      "payment_type":"googlepay",
      "fraud_status":"ok",
      "charge_type":"normal",
      "created_at":"2022-05-11T20:36:15.000Z",
      "account_id":20937,
      "customer":{
         "id":955307,
         "phone_number":null,
         "name":"Flutterwave Developers",
         "email":"developers@flutterwavego.com",
         "created_at":"2022-05-11T20:36:14.000Z"
      },
      "meta":{
         "authorization":{
            "mode":"redirect",
+           "redirect":"https://rave-api-v2.herokuapp.com/flwv3-pug/getpaid/api/short-url/XPtNw-WkQ"
         }
      }
   }
}
```

Let us take a closer look at the response:

* `status` is `"successful"`, which means the charge was initiated successfully.
* `data.status` is `"pending"`, meaning that the payment has been initiated but the payment has not yet authorized/approved by the User.
* `meta.authorization` contains the important details to complete the payment. The `meta.authorization.redirect` field has the redirect URL to complete the payment.

This redirect URL houses the Google Pay button. After redirecting your customers to the page, they should see the hosted page with the Google pay button.

On clicking the button, the Google Pay modal opens up and the customer selects their preferred card to complete the transaction.

<img src="https://mintcdn.com/flutterwaveinc/8LJ4mpYLmd_SNb9Z/images/Base.png?fit=max&auto=format&n=8LJ4mpYLmd_SNb9Z&q=85&s=c0e041a6f45346d4e11271033e5c7181" alt="Base" width="1440" height="860" data-path="images/Base.png" />

### Step 3: Completing the payment

After completing the payment, we'll send you a webhook response to your server. Here is an example webhook response:

```json Sample Response theme={null}
{
	"event": "charge.completed",
	"data": {
		"id": 2615978,
		"tx_ref": "OD3fed90d2-b441-4998-8d72-fd537acd37f1098hs_success_mock",
		"flw_ref": "XIPY8364001385338",
		"device_fingerprint": "N/A",
		"amount": 1,
		"charged_amount": 1,
		"app_fee": 0.04,
		"merchant_fee": 0,
		"processor_response": "Payment token retrieval has been initiated",
		"auth_model": "GOOGLEPAY_NOAUTH",
		"currency": "USD",
		"ip": "54.194.143.237",
		"narration": "GooglePay Transaction FOR Flutterwave Developers",
		"status": "pending",
		"auth_url": "https://rave-api-v2.herokuapp.com/flwv3-pug/getpaid/api/short-url/rjNCjCm5K",
		"payment_type": "googlepay",
		"fraud_status": "ok",
		"charge_type": "normal",
		"created_at": "2022-05-19T08:17:02.000Z",
		"account_id": 718972,
		"customer": {
			"id": 955498,
			"phone_number": null,
			"name": "Anonymous customer",
			"email": "user@flw.com",
			"created_at": "2022-05-19T08:17:01.000Z"
		}
	},
	"meta_data": {},
	"event.type": "GOOGLEPAY_TRANSACTION"
}
```

In your webhook implementation, on receipt of the hook, you must [verify](/api-reference/transactions/verify-a-transaction) the payment and give value to the customer. See our guide to [transaction verification](/transaction-verification) for details

## Testing Google Pay

You can find test credentials and mock data for your Integration tests in the [testing helpers](/testing#testing-apple-pay-or-google-pay) section.

## Next Steps

That’s it! You’ve successfully implemented Google Pay. You can also improve your app's payment experience with

1. Google [brand guide](https://developers.google.com/pay/api/android/guides/brand-guidelines).
2. Google Pay [UX best practices](https://developers.google.com/pay/api/web/guides/ux-best-practices).