---
title: "Register a wallet domain"
method: POST
path: "/v1/payment-methods/wallet/domains"
tags: ["Payment Methods"]
---

# Register a wallet domain

`POST /v1/payment-methods/wallet/domains`

Before adding Apple Pay to your checkout flow by integrating with the JavaScript SDK provided by Zuora, your domains that will show the Apple Pay button must be registered with Apple. Use this operation to register a domain. 

For more information about Zuora's JavaScript SDK for Apple Pay integration, see <a href="https://knowledgecenter.zuora.com/Zuora_Payments/Payment_Methods/B_Define_Payment_Methods/Set_up_Apple_Pay_for_gateway_integrations_other_than_Adyen_Integration_v2.0" target="_blank">Set up Apple Pay through the JavaScript SDK approach</a>.

## Headers

- `Idempotency-Key` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string

## Request body

- POSTRegisterApplePayDomainRequest
  - `domainName` string, required — The name of the domain to be registered. for example, `testapplepay.zuora.com`.
  - `walletType` 'ApplePay' | 'GooglePay', required — The type of digital wallet for the domain registration. This field is required and determines which wallet-specific domain management flow is executed.

## Response `200`

OK

- POSTRegisterApplePayDomainResponse
  - `domainName` string — The name of the domain registered with Apple Pay, such as `testapplepay.zuora.com`.
  - `domainVerified` boolean — Indicates whether the domain registration is successfully verified.
  - `id` string — The ID of the domain, such as `402881a38924ff1001892502da090021`.
  - `domainIdentifier` string — This identifier is automatically assigned during domain registration and is used for Apple Pay merchant validation and session initialization.
  - `walletType` string — The type of digital wallet associated with the domain.
  - `success` boolean — Indicates whether this call succeeds.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/7f43d4a77e8a/schema)