# Manage Google Pay™ (API)

> Manage your Google Pay integration with flexible domain and service controls. Add domains, cascade settings across organizations, and toggle Google Pay acceptance as needed

<AudienceInfo audiences={['developers']} />

You can manage Google Pay payment method domains and settings via the Payabli APIs.

## Domain management

### Add a domain

Send a POST request to [/api/PaymentMethodDomain](/developers/api-reference/paymentmethoddomain/paymentmethoddomain-add) to add more domains to an organization.

<EndpointRequestSnippet endpoint="POST /PaymentMethodDomain" example="Paypoint" />

### Cascade domain

Send a POST request to [/api/PaymentMethodDomain/\{domainId}/cascade](/developers/api-reference/paymentmethoddomain/paymentmethoddomain-cascade) to cascade the domain to all of the organization's children (both suborganizations and paypoints).

<EndpointRequestSnippet endpoint="POST /PaymentMethodDomain/{domainId}/cascade" example="CascadeDomains" />

### Stop accepting Google Pay

To stop accepting Google Pay from a domain, send a PATCH request to [/api/PaymentMethodDomain/\{domainId}](/developers/api-reference/paymentmethoddomain/paymentmethoddomain-update) and send `googlePay.isEnabled` as `false`.

<EndpointRequestSnippet endpoint="PATCH /PaymentMethodDomain/{domainId}" example="UpdatePaymentMethodDomain" />

<Note>
  You can't deactivate an inherited domain. You must deactivate domains at the domain owner organization's level.
</Note>

### Start accepting Google Pay

To start accepting Google Pay on a domain, send a POST request to [/api/PaymentMethodDomain/\{domainId}/verify](/developers/api-reference/paymentmethoddomain/paymentmethoddomain-verify) to verify the domain. If verification succeeds, Google Pay is activated automatically for the domain.

<Note>
  You can't verify an inherited domain. You must verify domains at the domain owner organization's level.
</Note>

### View domain details

To view a domain's details, send a GET request to [/api/PaymentMethodDomain/\{domainId}](/developers/api-reference/paymentmethoddomain/paymentmethoddomain-get) retrieve a domain's details. The response includes `cascades.jobStatus`, which gives the status of the domain cascade process.

### Delete domain

You can remove a domain from an organization by sending a DELETE request to the [/PaymentMethodDomain/\{domainId}](/developers/api-reference/paymentmethoddomain/paymentmethoddomain-delete) endpoint.

<EndpointRequestSnippet endpoint="DELETE /PaymentMethodDomain/{domainId}" example="Delete" />

<Note>
  You can't delete an inherited domain. You must delete a domain at the owning organization's level.
</Note>

### Get list of domains

To get a list of domains associated with an entity, send a POST request to the [/PaymentMethodDomain/list](/developers/api-reference/paymentmethoddomain/get-list-of-payment-method-domains) endpoint.

<EndpointRequestSnippet endpoint="GET /PaymentMethodDomain/list" example="ListDomains" />

* Send `entityType` as `organization` and the organization ID in `entityId` to get the details for the organization.
* Send `entityType` as `paypoint` and the paypoint's ID in `entityId` to get the details for the paypoint.

## Google Pay service management

You can activate and deactivate the Google Pay service for an organization and cascade the settings to all of the organization's children (including suborganizations and paypoints).

### Activate Google Pay

To activate Google Pay via the API, see [Activate Google Pay (API)](/guides/pay-in-developer-wallets-google-pay-enable).

### Deactivate Google Pay

To deactivate the Google Pay service, make a POST request to the [/Wallet/googlepay/configure-organization](/developers/api-reference/wallet/googlepay/googlepay-configure-organization).

In the body, send `isEnabled` as `false` and `cascade` as `true` to deactivate Google Pay on the organization and cascade the deactivation to all of the organization's children.

```bash Example deactivation request {7-8}
  curl --request POST \
    --url https://api-sandbox.payabli.com/api/Wallet/googlepay/configure-organization \
    --header 'Content-Type: application/json' \
    --header 'requestToken: <api-key>' \
    --data '{
    "orgId": 123,
    "isEnabled": false,
    "cascade": true
}'
```

After you've sent the deactivation request, Payabli deactivates the service and cascades the settings, if applicable. This can take a few minutes, depending on how your entities are structured.

To check whether Google Pay is deactivated, send a GET request to [/api/Organization/settings/\{orgId}](/developers/api-reference/organization/get-organization-settings). Check the response for `forWallets`, when Google Pay isn't active, you can see the following in the response:

```json
 "forWallets": [
    {
      "key": "IsGooglePayEnabled",
      "value": "false",
      "readOnly": true
    }
  ]
```

## Related resources

See these related resources to help you get the most out of Payabli.

<AccordionGroup>
  <Accordion title="Prerequisites">
    * **[Google Pay™ overview](/guides/pay-in-wallets-google-pay-overview)** - Learn about using Google Pay with Payabli
    * **[Activate Google Pay™ (API)](/guides/pay-in-developer-wallets-google-pay-enable)** - Learn about setting up Google Pay via the Payabli API
  </Accordion>
</AccordionGroup>