Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Revolut Draft payment API

You can create a draft payment to initiate a payment on behalf of a user, and request the approval for the draft payment in the user account.Then, you can retrieve or delete a draft payment.:::noteThe draft payments API is available only for Revolut Business customers.If you'd like to use this endpoint, reach out to us.:::For more information, see [Tutorials: Work with draft payments](https://developer.revolut.com/docs/guides/build-banking-apps/tutorials/work-with-draft-payments).

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

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

This API exposes 5 operations across 3 paths, and defines 14 schemas. It is described by OpenAPI 3.0.1, at version 1.0.

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

5 operations 3 paths 14 schemas 2 DELETE2 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.0
Base URL
https://b2b.revolut.com/api/1.0
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Revolut Draft payment API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (AccessToken).

  • AccessToken — Each Business API request must contain an authorization header in the following format to make a call: Bearer . The access token will be obtained the first tim…

Paths & Operations 5

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

Draft payment 5

You can create a draft payment to initiate a payment on behalf of a user, and request the approval for the draft payment in the user account. Then, you can retrieve or delete a dr…

GET
/draft-payments
List draft payments
listDraftPayment 3 params → 200400403default
POST
/draft-payments
Create a draft payment
createDraftPayment 3 params body → 201400403429503default
DELETE
/draft-payments/{DraftPaymentId}/transfers/{DraftPaymentTransferId}
Delete a draft payment transfer
deleteDraftPaymentTransfer 2 params → 204400403404422default
GET
/draft-payments/{DraftPaymentId}
Retrieve a draft payment
findDraftPayment 1 param → 200400403404default
DELETE
/draft-payments/{DraftPaymentId}
Delete a draft payment
deleteDraftPayment 1 param → 204400403404422default

Schemas 14

The contract defines 14 schemas that model the data the API accepts and returns. The most detailed are DraftPaymentTransfer (7 properties), DraftPaymentResponse (4 properties), CsvError (4 properties), FieldError (3 properties). Each schema is shown below with its type and property counts.

DraftPaymentTransfers
array
DraftPaymentTransferStatus
string
The status of the draft payment.
InstructedAmount
object
2 properties 2 required
ErrorDetails
array
The details of the error.
ErrorDetail
object
2 properties 2 required
FieldError
object
3 properties 2 required
DraftPaymentTransfer
object
7 properties 4 required
DraftPaymentResponse
object
4 properties 3 required
DraftPaymentListResponse
object
2 properties 2 required
Error
object
3 properties 3 required
Currency
string
[ISO 4217](https://en.wikipedia.org/wiki/ISO4217) currency code in upper case.
Amount
string
The amount of money.
DraftPaymentStatus
string
The status of the draft payment.
CsvError
object
4 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

revolut-draft-payment-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 Customers API
Revolut Disputes API