> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://beta-docs.payabli.com/developer-guides/wallet-apple-pay-manage/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://beta-docs.payabli.com/_mcp/server.

# Manage Apple Pay (API)

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](/api-reference/paymentmethoddomain/paymentmethoddomain-add) to add more domains to an organization.

### Cascade domain

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

### Stop accepting Apple Pay

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

```bash
curl --request PATCH \
  --url https://api-sandbox.payabli.com/api/PaymentMethodDomain/{domainId} \
  --header 'Content-Type: application/json' \
  --header 'requestToken: <api-key>' \
  --data '{
  "applePay": {
    "isEnabled": false
  }
}'
```

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

### Start accepting Apple Pay

To start accepting Apple Pay on a domain, send a POST request to  [/api/PaymentMethodDomain/\{domainId}/verify](/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.

### View domain details

To view a domain's details, send a GET request to [/api/PaymentMethodDomain/\{domainId}](/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}](/api-reference/paymentmethoddomain/paymentmethoddomain-delete) endpoint.

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

### Get list of domains

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

* 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 entryname 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)](/developer-guides/wallet-apple-pay-enable).

### Deactivate Apple Pay

To deactivate the Apple Pay service, make a POST request to the [/Wallet/applepay/configure-organization](/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.

**`Example deactivation request`**

```bash Example deactivation request {8-9}
  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}](/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
    }
  ]
```

> If you're a software company, you're a payments company™