Operations for managing a merchant's domain registration and configuration with Apple for integration of Apple Pay via Revolut. This includes initiating domain validation with Apple, a necessary step for merchants to offer Apple Pay as a payment method on their websites or apps. These endpoints interact with Apple's [Apple Pay Web Merchant Registration services](https://developer.apple.com/documentation/applepaywebmerchantregistrationapi).
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/revolut-apple-pay-merchant-registration-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Apple Pay merchant registration API
version: '2026-04-20'
description: 'Welcome to the Revolut Merchant API - your solution to managing the core aspects of e-commerce and accepting online payments. Whether you''re a startup, a growing business, or an established enterprise in the e-commerce industry, our API helps you streamline your operations.
As a Revolut Business customer with a Merchant Account, you can use the
Merchant API to leverage the following features:
- [Order management](https://developer.revolut.com/docs/api/merchant#tag-orders)
- [Customer management](https://developer.revolut.com/docs/api/merchant#tag-customers)
- [Payment management](https://developer.revolut.com/docs/api/merchant#tag-payments)
- [Subscription management](https://developer.revolut.com/docs/api/merchant#tag-subscriptions)
- [Payout management](https://developer.revolut.com/docs/api/merchant#tag-payouts)
- [Dispute management](https://developer.revolut.com/docs/api/merchant#tag-disputes)
- [Reporting analytics](https://developer.revolut.com/docs/api/merchant#tag-report-runs)
- [Webhook management](https://developer.revolut.com/docs/api/merchant#tag-webhooks)
- [Location management](https://developer.revolut.com/docs/api/merchant#tag-locations)
... and more.
### API versions
:::warning
We highly recommend using versioning in your API calls. If you don''t provide a version header on the operations where it''s required, you will receive an error response.
:::
The Merchant API uses request header versioning. Where it is required you need to use the `Revolut-Api-Version` header parameter to specify an API version. Each request, where it is indicated in the API specification, must contain a version header in the following format:
```
''Revolut-Api-Version: 2026-04-20''
```
:::info
For more information, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions)
:::
### Test the Merchant API
You can test the Merchant API in Postman by forking this collection:
[](https://www.postman.com/revolut-api/workspace/revolut-developers/overview)'
contact: {}
servers:
- description: Production server (uses live data)
url: https://merchant.revolut.com
- description: Sandbox server (uses test data)
url: https://sandbox-merchant.revolut.com
security:
- Api-Key: []
tags:
- name: Apple Pay merchant registration
description: 'Operations for managing a merchant''s domain registration and configuration with Apple for integration of Apple Pay via Revolut.
This includes initiating domain validation with Apple, a necessary step for merchants to offer Apple Pay as a payment method on their websites or apps.
These endpoints interact with Apple''s [Apple Pay Web Merchant Registration services](https://developer.apple.com/documentation/applepaywebmerchantregistrationapi).'
paths:
/api/apple-pay/domains/register:
parameters:
- $ref: '#/components/parameters/Authorization'
post:
summary: Register domain for Apple Pay
operationId: registerDomainApplePay
description: "Register your website's domain to accept payments via Apple Pay. \n\nBefore you call this endpoint, make sure that you have completed the following steps:\n\n1. Download the latest [domain validation file](https://assets.revolut.com/api-docs/merchant-api/files/apple-developer-merchantid-domain-association).\n1. Upload the domain validation file to your website in the following folder `/.well-known/`. For example, if your website is `example.com`, the file should be available on `example.com/.well-known/apple-developer-merchantid-domain-association`, where `apple-developer-merchantid-domain-association` indicates the name of the file."
requestBody:
content:
application/json:
schema:
type: object
properties:
domain:
type: string
description: Domain name of your website without the scheme (i.e. without `http://` or `https://`).
example: revolut.com
required:
- domain
examples:
example_request:
summary: Example domain registration request for Apple Pay
value:
domain: revolut.com
responses:
'204':
description: Domain registered successfully
'400':
description: Bad Request
content:
application/json:
schema:
type: object
properties:
code:
type: string
description: 'An identifier that can be used to determine what went wrong.
Error codes are not globally unique, but uniqueness is guaranteed within endpoints.'
message:
type: string
description: Human readable text describing what went wrong.
required:
- code
examples:
error_message:
summary: Error message
value:
code: validation
message: Exactly one value must be supplied for client_id
security:
- Api-Key: []
tags:
- Apple Pay merchant registration
/api/apple-pay/domains/unregister:
parameters:
- $ref: '#/components/parameters/Authorization'
- $ref: '#/components/parameters/Revolut-Api-Version-Optional'
post:
summary: Unregister domain for Apple Pay
operationId: unregisterDomainApplePay
description: 'Unregister your website from Apple Pay''s registered domains. '
requestBody:
content:
application/json:
schema:
type: object
properties:
domain:
type: string
description: Domain name of your website without the scheme (i.e. without `http://` or `https://`).
example: revolut.com
reason:
type: string
description: A short explanation why you remove the domain.
maxLength: 1024
required:
- domain
- reason
examples:
example_request:
summary: Example domain registration request for Apple Pay
value:
domain: revolut.com
reason: Unregister due to domain change.
responses:
'204':
description: Domain ungistered successfully
'400':
description: Bad Request
content:
application/json:
schema:
type: object
properties:
code:
type: string
description: 'An identifier that can be used to determine what went wrong.
Error codes are not globally unique, but uniqueness is guaranteed within endpoints.'
message:
type: string
description: Human readable text describing what went wrong.
required:
- code
examples:
error_message:
summary: Error message
value:
code: validation
message: Exactly one value must be supplied for client_id
security:
- Api-Key: []
tags:
- Apple Pay merchant registration
components:
parameters:
Authorization:
name: Authorization
in: header
schema:
type: string
format: Bearer <yourSecretApiKey>
example: Bearer sk_1234567890ABCdefGHIjklMNOpqrSTUvwxYZ_1234567890-Ab_cdeFGHijkLMNopq
required: true
description: "This parameter accepts the [Merchant API Secret key](https://business.revolut.com/settings/apis?tab=merchant-api) to authorise requests coming from the merchant's backend. \n\nIt ensures that ensures that each request is authenticated and authorised by verifying the secret key. The secret key should be included in all request headers as a `Bearer` token.\n\n:::info\nFor more information, see: [Authentication](https://developer.revolut.com/docs/api/merchant#authentication)\n:::"
Revolut-Api-Version-Optional:
name: Revolut-Api-Version
in: header
schema:
type: string
format: date
example: '2026-04-20'
enum:
- '2023-09-01'
- '2024-05-01'
- '2024-09-01'
- '2025-10-16'
- '2025-12-04'
- '2026-03-12'
- '2026-04-20'
description: 'The version of the Merchant API, specified in `YYYY-MM-DD` format.
:::info
For more information about API versioning, see: [API versions](https://developer.revolut.com/docs/guides/merchant/reference/versioning/api-versions).
:::'
x-config-always-visible-in-example: true
securitySchemes:
Api-Key:
type: apiKey
in: header
name: Authorization
description: 'Each Merchant API request must contain an authorization header in the following format:
```
''Authorization: Bearer <yourSecretApiKey>''
```
To use this API, you need to generate API keys from your Revolut Business account. The Secret key is used in the authorization header for all server calls, while the Public key is provided with payment methods at checkout.
:::info
For detailed instructions on generating your API keys, see: [Generate API keys](https://developer.revolut.com/docs/guides/merchant/get-started#generate-api-keys).
:::'