curl "https://api.khaime.com/api/v1/payment-method-domains/status?domain_name=checkout.example.com" \
-H "X-API-Key: pk_live_your_key"
{
"success": true,
"message": "Payment method domain status retrieved.",
"data": {
"domain_name": "checkout.example.com",
"environment": "live",
"results": [
{
"target": "platform_us",
"merchant_account_id": null,
"success": true,
"registered": true,
"apple_pay_status": "active",
"google_pay_status": "active"
},
{
"target": "merchant_2454",
"merchant_account_id": "acct_1ABC...",
"success": true,
"registered": true,
"apple_pay_status": "inactive",
"google_pay_status": "active"
}
]
}
}
Payments
Get Payment Method Domain Status
Check Apple Pay / Google Pay validation status for a registered checkout domain.
GET
/
payment-method-domains
/
status
curl "https://api.khaime.com/api/v1/payment-method-domains/status?domain_name=checkout.example.com" \
-H "X-API-Key: pk_live_your_key"
{
"success": true,
"message": "Payment method domain status retrieved.",
"data": {
"domain_name": "checkout.example.com",
"environment": "live",
"results": [
{
"target": "platform_us",
"merchant_account_id": null,
"success": true,
"registered": true,
"apple_pay_status": "active",
"google_pay_status": "active"
},
{
"target": "merchant_2454",
"merchant_account_id": "acct_1ABC...",
"success": true,
"registered": true,
"apple_pay_status": "inactive",
"google_pay_status": "active"
}
]
}
}
Intro
Returns the registration and wallet validation status of a checkout domain across every merchant account it applies to — the Khaime platform accounts, your own connected account, and your sub-merchants’ connected accounts.Context
This is the read counterpart to Register Payment Method Domain. Use it after registering to confirm Apple Pay wentactive, or any time later to diagnose why a wallet button isn’t showing on a live checkout — for example after adding a new sub-merchant whose connected account hasn’t been registered yet.
Hows
Query parameters
string
required
The checkout domain to check, e.g.
checkout.example.com.Response
string
The normalized domain that was checked.
string
live or sandbox, derived from your API key.array
One entry per merchant account.
Show Result fields
Show Result fields
string
platform_us, platform_uk, business_<id>, or merchant_<id>.string | null
The connected account ID, or
null for platform accounts.boolean
Whether the domain is registered on this account at all.
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.string | null
Google Pay status for the domain.
string
Present when the account could not be queried.
curl "https://api.khaime.com/api/v1/payment-method-domains/status?domain_name=checkout.example.com" \
-H "X-API-Key: pk_live_your_key"
{
"success": true,
"message": "Payment method domain status retrieved.",
"data": {
"domain_name": "checkout.example.com",
"environment": "live",
"results": [
{
"target": "platform_us",
"merchant_account_id": null,
"success": true,
"registered": true,
"apple_pay_status": "active",
"google_pay_status": "active"
},
{
"target": "merchant_2454",
"merchant_account_id": "acct_1ABC...",
"success": true,
"registered": true,
"apple_pay_status": "inactive",
"google_pay_status": "active"
}
]
}
}
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 again to re-validate.Whys
The status check is read-only and per-account (rather than a single aggregate boolean) because the same domain can be validlyactive on the platform account while inactive on a newly added sub-merchant’s account — a single yes/no answer would hide exactly the information you need to fix the problem.
Why nots
- This endpoint does not re-run Apple Pay validation or fix anything — it only reports the last known status. Re-register (via Register Payment Method Domain) to trigger a fresh validation attempt.
- It has no bearing on Paystack, Flutterwave, or StartButton checkouts — status here is purely about the Stripe Payment Element’s wallet support.