> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paybyrd.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Revolut Pay

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

## How it works

<img src="https://mintcdn.com/paybyrd/_2RsTPIIlIKxMrgj/accept-payments/img/revolut-payment-flow.png?fit=max&auto=format&n=_2RsTPIIlIKxMrgj&q=85&s=e81231e5a064c2bd552bca4f522c2d7d" alt="Flowchart depicting Revolut Pay payment flow" width="2126" height="1304" data-path="accept-payments/img/revolut-payment-flow.png" />

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:

```bash theme={null}
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"
   ]
 }
}'
```

```json theme={null}
{
 "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"
}
```