Native Apple Pay API
The Native Apple Pay API provides server-side endpoints for the native Apple Pay flow — getting a quote, fetching the Terms of Service links, sending the payment with the Apple Pay token, and optionally verifying the user before the payment.
Base URLs
| Environment | Base URL |
|---|---|
| Production | https://api.mercuryo.io/v1.6 |
| Sandbox | https://sandbox-api.mrcr.io/v1.6 |
Authentication
| Header | Obtained from | Description |
|---|---|---|
Sdk-Partner-Token |
Your integration manager | Your partner authentication token. Used in POST /sdk-partner/native-mobile-pay/mobile-pay, POST /sdk-partner/native/user/sign-in and GET /sdk-partner/native/rate |
X-Signature |
Calculated by you | HMAC-SHA256 of the request body string with your Sign Key, hex-encoded — see Signature. Used in POST /sdk-partner/native-mobile-pay/mobile-pay |
Sdk-User-Token |
bearer_token from POST /sdk-partner/native/user/sign-in |
The user's token for the user-scoped requests in KYC Before Payment |
Sdk-User-IP |
Your end user | The end user's real IP address, sent with the quote and the KYC requests — see Get a Quote and KYC Before Payment |
Callbacks
Transaction status updates are sent by Mercuryo to your server:
- Callback Reference — payload schema, field descriptions, and examples. Native Apple Pay transactions use the
buy(payment_method: mobile_pay) andwithdrawpayloads - Callbacks & Webhooks — setup, delivery, and retries
- Signature — callback signature verification
- Transaction Statuses — statuses and transitions