# Manage Apple Pay (API)

> Control your Apple Pay integration with domain management APIs. Add, verify, cascade domains across organizations, and enable or disable Apple Pay acceptance as your business needs change

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

You can manage Apple 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 Apple Pay

To stop accepting Apple Pay from a domain, send a PATCH request to [/api/PaymentMethodDomain/\{domainId}](/developers/api-reference/paymentmethoddomain/paymentmethoddomain-update) and send `applePay.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 Apple Pay

To start accepting Apple 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, Apple 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.

## Apple Pay service management

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

### Activate Apple Pay

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

### Deactivate Apple Pay

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

In the body, send `isEnabled` as `false` and `cascade` as `true` to deactivate Apple 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/applepay/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 Apple 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 Apple Pay isn't active, you can see the following in the response:

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

## Related resources

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

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