Skip to main content
Revolut Pay allows you to make online payments directly from your Revolut account without entering card or bank details.

How it works

Flowchart depicting Revolut Pay payment flow Revolut Pay is an asynchronous payment method. When you create a payment, the customer authenticates and approves it through the Revolut Pay interface:
  • Desktop: a modal opens within the page.
  • Mobile: the customer is redirected to the Revolut Pay page or native app, then redirected back on completion.
The transaction remains in a processing status until the customer acts. Once the customer completes the payment, Revolut sends a notification and the transaction is updated to either succeeded or failed.

Create order

Generic order

The following request creates a generic Revolut Pay order:
curl --request POST \
 --url https://gateway.paybyrd.com/api/v2/orders \
 --header 'Accept: application/json' \
 --header 'Content-Type: application/json' \
 --header 'x-api-key: {your_api_key}' \
 --data '
{
 "isoamount": 2510,
 "orderRef": "Revolut Pay",
 "currency": "EUR",
 "shopper": {
   "email": "peter@parker.com",
   "firstName": "peter",
   "lastName": "parker",
   "phoneCountryCode": 55,
   "phoneNumber": ""
 },
 "orderOptions": {
   "redirectUrl": "https://www.paybyrd.com",
   "allowedPaymentMethods": [
     "REVOLUTPAY"
   ]
 }
}'
{
 "orderDate": "2024-12-11T17:40:56Z",
 "status": "created",
 "checkoutUrl": "https://link-s.paybyrd.com/chk_Wkjf5Bt8f",
 "tags": 0,
 "index": 1,
 "transactions": [],
 "orderId": "e83aa1a1-152c-439e-af1e-fc4178520807",
 "amount": "25.10",
 "currency": "EUR",
 "orderRef": "Revolut Pay",
 "shopper": {
   "customReference": "shp_KX9AvxCODFeaUQl4",
   "shopperId": "bc110bf5-d6df-4c65-a044-d1d5526846c2",
   "email": "peter@parker.com",
   "firstName": "peter",
   "lastName": "parker",
   "phoneCountryCode": 55,
   "phoneNumber": "",
   "shippingType": "Undefined",
   "firstPurchaseDate": "2024-12-11T17:40:56.9508076+00:00",
   "lastPurchaseDate": "2024-12-11T17:40:56.9508076+00:00"
 },
 "orderOptions": {
   "redirectUrl": "https://www.paybyrd.com",
   "culture": "en-US",
   "sendBy": []
 },
 "paymentOptions": {
   "useSimulated": true,
   "cardOptions": {
     "isPreAuth": false,
     "isDccEnabled": false
   },
   "tokenOptions": {
     "tokenizationMethod": "none"
   },
   "allowedPaymentMethods": []
 },
 "terminalOptions": {
   "notifyChanges": false
 },
 "code": "BYRD200",
 "description": "Operation successfully completed"
}