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

# Get Payment Method Domain Status

> Check Apple Pay / Google Pay validation status for a registered checkout domain.

# Get Payment Method Domain Status

Returns the registration and wallet validation status of a checkout domain across every Stripe account it applies to — the Khaime platform accounts, your own connected account, and your sub-merchants' connected accounts.

Use this after [registering a domain](/api-reference/payments/register-payment-method-domain) to confirm Apple Pay went `active`, or to diagnose why a wallet button isn't showing on checkout.

## Query Parameters

<ParamField query="domain_name" type="string" required>
  The checkout domain to check, e.g. `checkout.example.com`.
</ParamField>

## Response

<ResponseField name="domain_name" type="string">
  The normalized domain that was checked.
</ResponseField>

<ResponseField name="environment" type="string">
  `live` or `sandbox`, derived from your API key.
</ResponseField>

<ResponseField name="results" type="array">
  One entry per Stripe account.

  <Expandable title="Result fields">
    <ResponseField name="target" type="string">
      `platform_us`, `platform_uk`, `business_<id>`, or `merchant_<id>`.
    </ResponseField>

    <ResponseField name="stripe_account_id" type="string | null">
      The connected account ID, or `null` for platform accounts.
    </ResponseField>

    <ResponseField name="registered" type="boolean">
      Whether the domain is registered on this account at all.
    </ResponseField>

    <ResponseField name="apple_pay_status" type="string | null">
      `active` when Apple Pay validation passed; `inactive` when the domain association file could not be verified. `null` when the domain isn't registered on this account.
    </ResponseField>

    <ResponseField name="google_pay_status" type="string | null">
      Google Pay status for the domain.
    </ResponseField>

    <ResponseField name="error" type="string">
      Present when the account could not be queried.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.khaime.com/api/v1/partner/payment-method-domains/status?domain_name=checkout.example.com" \
    -H "X-API-Key: pk_live_your_key"
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "success": true,
    "message": "Payment method domain status retrieved.",
    "data": {
      "domain_name": "checkout.example.com",
      "environment": "live",
      "results": [
        {
          "target": "platform_us",
          "stripe_account_id": null,
          "success": true,
          "registered": true,
          "apple_pay_status": "active",
          "google_pay_status": "active"
        },
        {
          "target": "merchant_2454",
          "stripe_account_id": "acct_1ABC...",
          "success": true,
          "registered": true,
          "apple_pay_status": "inactive",
          "google_pay_status": "active"
        }
      ]
    }
  }
  ```
</ResponseExample>

<Note>
  An `apple_pay_status` of `inactive` almost always means the domain association file at
  `https://<domain>/.well-known/apple-developer-merchantid-domain-association` was missing or
  unreachable during validation. Fix the file, then call the
  [register endpoint](/api-reference/payments/register-payment-method-domain) again to re-validate.
</Note>