Merchant API
Create an order
api
post
/api/orders

Create an order

Create an Order object.

Creating orders is one of the basic operations of the Merchant API. Most of the other operations are related to creating orders. Furthermore, the payment methods merchants can use to take payments for their orders are also building on order creation.

To learn more about how you can accept payments, see:

Request​

Header Parameters
Header Parameters
Request body
Body object 

Response​

Order created

Response body
Body object 
Was this page helpful?
POST
/api . /orders . 
Revolut-Api-Version *header
Parameters
curl -L -X POST 'https://merchant.revolut.com/api/orders' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <yourSecretApiKey>' \
--data-raw '{
  "amount": 500,
  "currency": "GBP"
}'
Request body samples
{
  "amount": 500,
  "currency": "GBP"
}
Response body samples
{
  "id": "6516e61c-d279-a454-a837-bc52ce55ed49",
  "token": "0adc0e3c-ab44-4f33-bcc0-534ded7354ce",
  "type": "payment",
  "state": "pending",
  "created_at": "2023-09-29T14:58:36.079398Z",
  "updated_at": "2023-09-29T14:58:36.079398Z",
  "amount": 500,
  "currency": "GBP",
  "outstanding_amount": 500,
  "capture_mode": "automatic",
  "checkout_url": "https://checkout.revolut.com/payment-link/0adc0e3c-ab44-4f33-bcc0-534ded7354ce",
  "enforce_challenge": "automatic"
}