How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Revolut Customers API

The Customers resource in the Merchant API is a pivotal tool for tracking and managing customer-related transactions within your e-commerce or retail platform. This resource provides a structured approach to customer management, enabling you to maintain a consistent record of customer transactions.A `Customer` object can be created using the [Create a customer](https://developer.revolut.com/docs/api/merchant#create-customer) endpoint and you can then retrieve, update and delete a customer using its `id`. `Customer` objects enable you to track multiple transactions in your system associated with the same customer in the Merchant API.You can save and store payment methods of a customer in the `payment_method` object, for more information, see: [Charge a customer's saved payment method](https://developer.revolut.com/docs/guides/merchant/optimise-checkout/save-payment-methods/charge-saved-payment-method). A merchant can store the details of the payment securely and group transactions from the same payment method in their system.A payment method is unique for each customer. For example, if the same card is used for a transaction by two different customers, two payment method objects are created linked to each customer.Similar principle applies when saving payment methods via Revolut Pay for merchant initiated transaction (MIT - useful for recurring payments). If a customer saves their details through Revolut Pay for MIT in separate sessions, each session will create a new payment method object linked to the customer.:::noteYou cannot create a payment method explicitly because they are generated as part of a payment. You can only retrieve, update or delete a payment method, or you can retrieve all payment methods of a customer.:::

Revolut Customers API is one of 46 APIs that Revolut publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Customers. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 9 operations across 4 paths, and defines 37 schemas. It is described by OpenAPI 3.2.0, at version 2026-04-20.

Requests are made against 2 base URLs: https://merchant.revolut.com, https://sandbox-merchant.revolut.com.

9 operations 4 paths 37 schemas 2 DELETE4 GET2 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2026-04-20
Base URL
https://b2b.revolut.com/api/1.0
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Revolut Customers API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (Api-Key). By default, every request must be authenticated.

  • Api-Key — Each Merchant API request must contain an authorization header in the following format: 'Authorization: Bearer ' To use this API, you need to generate API keys…

Paths & Operations 9

Across 4 paths, the API surfaces 9 operations — 2 DELETE, 4 GET, 2 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Customers 9

The Customers resource in the Merchant API is a pivotal tool for tracking and managing customer-related transactions within your e-commerce or retail platform. This resource provi…

POST
/api/customers
Create a customer
createCustomer 2 params body → 201400401
GET
/api/customers
Retrieve a customer list
retrieveCustomerList 6 params → 200401
GET
/api/customers/{customer_id}
Retrieve a customer
retrieveCustomer 3 params → 200401404
PATCH
/api/customers/{customer_id}
Update a customer
updateCustomer 3 params body → 200400401404
DELETE
/api/customers/{customer_id}
Delete a customer
deleteCustomer 3 params → 204401404
GET
/api/customers/{customer_id}/payment-methods
Retrieve payment method list of a customer
retrievePaymentMethodList 4 params → 200401404
GET
/api/customers/{customer_id}/payment-methods/{payment_method_id}
Retrieve a customer's payment method
retrievePaymentMethod 4 params → 200401404
PATCH
/api/customers/{customer_id}/payment-methods/{payment_method_id}
Update a customer's payment method
updatePaymentMethod 4 params body → 200401404
DELETE
/api/customers/{customer_id}/payment-methods/{payment_method_id}
Delete a customer's payment method
deletePaymentMethod 4 params → 204401404

Schemas 37

The contract defines 37 schemas that model the data the API accepts and returns. The most detailed are Card-v2 (15 properties), Sepa-Direct-Debit-v2 (8 properties), Customer-v3 (7 properties), Customer-Created (6 properties). Each schema is shown below with its type and property counts.

Customer-Update-v2
object
The request body for updating a customer. All fields are optional. Only the fields provided in the request will be updated. :::note businessname is not support…
4 properties
Phone
string
The phone number of the customer in [E.164 format](https://en.wikipedia.org/wiki/E.164).
Customer-Id
string
Unique identifier for the customer.
Card-v2
object
A saved card payment method. :::info The checks object (3DS, CVV, address verification) is not included as it is specific to the transactional payment context.…
15 properties 3 required
Email
string
The email address of the customer.
Card-Expiry-Year
integer
The expiry year of the payment card.
Payment-Method-Update
object
Fields to update on a saved payment method.
1 property
Sepa-Direct-Debit-Mandate-Reference
string
The unique mandate reference generated by Revolut. Include this in pre-debit notifications sent to your customers.
Terminal-Hardware-Id
string
The hardware identifier of the Revolut Terminal device used to process the payment. :::note Only present for card-present transactions processed via Revolut Te…
Date-Of-Birth
string
The birth date of the customer.
Billing-Address
object
The billing address associated with the payment method.
6 properties 2 required
Card-Brand-v2
string
The brand of the payment card.
Customer-Payment-Methods-v2
object
1 property 1 required
Sepa-Direct-Debit-v2
object
A saved SEPA Direct Debit payment method on a customer profile. :::info For more information, see: [SEPA Direct Debit server-to-server integration](https://dev…
8 properties 3 required
Sepa-Direct-Debit-Debtor-Iban-Last-Four
string
The last four digits of the debtor's IBAN.
Payment-Method-Type-v2
string
The type of the payment method.
Payment-Method-Id
string
Unique identifier for the payment method.
Customer-v3
object
A customer object.
7 properties 5 required
Next-Page-Token
stringnull
Token for retrieving the next page of results. Use this token as the value of the pagetoken query parameter in your next request to retrieve the next page. If…
Payment-Method-v4
A saved payment method on a customer profile. Use the type field to determine the specific payment method variant. :::note This schema represents a stored cred…
Card-Funding-v2
string
The funding type of the payment card.
Customers
object
2 properties 1 required
Card-Issuer-Country
string
The ISO 3166-1 alpha-2 country code of the country where the payment card was issued.
Saved-For
string
Indicates in which case this saved payment method can be used for payments. | Value | Description | | ----- | ----------- | | customer | This payment method ca…
Customer-Created
object
A customer object.
6 properties 4 required
Card-Bin
string
The BIN (Bank Identification Number) of the payment card, typically the first 6-8 digits.
Sepa-Direct-Debit-Debtor-Name
string
The full name of the debtor as provided in the mandate.
Card-Expiry-Month
integer
The expiry month of the payment card.
Cardholder-Name
string
The name of the cardholder as it appears on the card.
Card-Issuer
string
The name of the card-issuing bank or institution.
Card-Last-Four
string
The last four digits of the payment card number.
Payment-Method-Created-At
string
The date and time the payment method was added.
Revolut-Pay-v2
object
A saved Revolut Pay payment method on a customer profile. Both Revolut Pay card-backed and account-to-account (A2A) variants are represented by this single typ…
4 properties 3 required
Error-v2
object
3 properties
Full-Name
string
The full name of the customer.
Customer-Simplified
object
A customer object.
6 properties 4 required
Customer-Creation-v2
object
The request body for creating a customer.
4 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

revolut-customers-api-openapi.yml Raw ↑

Other APIs Revolut publishes across the network.

Revolut Accounting API
Revolut Accounting categories API
Revolut Accounts API
Revolut Apple Pay merchant registration API
Revolut Applications API
Revolut Balance API
Revolut Card invitations API
Revolut Cards API
Revolut Configuration API
Revolut Counterparties API
Revolut Disputes API
Revolut Domestic payment API
Where this information came from

This is an independent, third-party profile of Revolut Customers API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.