Revolut Merchant
Accept online card payments and manage orders, customers, refunds, and webhooks via the Revolut Merchant API.
Authentication
This connector uses Token-based authentication.
info
Set up your connection in the Abstra Console before using it in your workflows.
How to use
Using the Smart Chat
Execute the action "CHOOSE_ONE_ACTION_BELOW" from my connector "YOUR_CONNECTOR_NAME" using the params "PARAMS_HERE".
Using the Web Editor
from abstra.connectors import run_connection_action
result = run_connection_action(
connection_name="your_connection_name",
action_name="your_action_name",
params={
"param1": "value1",
"param2": "value2"
})
Available Actions
This connector provides 71 actions:
| Action | Purpose | Parameters |
|---|---|---|
| post_api_orders | Create an Order object. Full documentation: Merchant API - Create an orderhttps://developer.revolut.com/docs/merchant/create-order | data: { . amount (integer) . currency (string) } (object) required |
| get_api_orders | Retrieve all the orders that you’ve created. You can also use the query parameters for: - Filtering - Pagination The response contains an array of simplified Order objects. This endpoint is only supported from version 2024-09-01 Full documentation: Merchant API - Retrieve an order listhttps://developer.revolut.com/docs/merchant/retrieve-order-list | limit (string) |
| get_api_orders_by_order_id | Retrieve the details of an order that has been created. Provide the unique order ID, and the corresponding order information is returned. Full documentation: Merchant API - Retrieve an orderhttps://developer.revolut.com/docs/merchant/retrieve-order | order_id (string) required |
| patch_api_orders_by_order_id | Update the details of an order. Specific limitations apply based on the state of the order, see full documentation: Merchant API - Update an orderhttps://developer.revolut.com/docs/merchant/update-order. | order_id (string) required data: { . amount (integer) . currency (string) . merchant_order_data (object) } (object) required |
| post_api_orders_by_order_id_increment_authorisation | Increment authorised amount of an order. Full documentation: Merchant API - Increment authorisationhttps://developer.revolut.com/docs/merchant/increment-authorisation | order_id (string) required data: { . amount (integer) } (object) required |
| post_api_orders_by_order_id_capture | Capture the funds of an existing, uncaptured order. When the payment for an order is authorized, the order is captured and sent to the processing stage. Full documentation: Merchant API - Capture an orderhttps://developer.revolut.com/docs/merchant/capture-order | order_id (string) required data: { . amount (integer) } (object) required |
| post_api_orders_by_order_id_cancel | Cancel an existing uncaptured order. Specific limitations apply based on the state of the order, see full documentation: Merchant API - Cancel an orderhttps://developer.revolut.com/docs/merchant/cancel-order | order_id (string) required |
| post_api_1_0_orders_by_order_id_refund | Issue a refund for a completed order. A refund can be either full or partial. You can initiate a refund for an order only when it is in the COMPLETED state. Full documentation: Merchant API - Refund an orderhttps://developer.revolut.com/docs/merchant/refund-order | order_id (string) required data: { . amount (integer) . currency (string) . merchant_order_ext_ref (string) . description (string) } (object) required |
| post_api_orders_by_order_id_payments | Initiate a payment to pay full amount for an order using a customer's saved payment method. Full documentation: Merchant API - Pay for an orderhttps://developer.revolut.com/docs/merchant/pay-order | order_id (string) required data: { . saved_payment_method (object) } (object) required |
| post_api_customers | Create a customer that has the information in the body of the request. This endpoint is only supported from version 2024-09-01 Full documentation: Merchant API - Create a customerhttps://developer.revolut.com/docs/merchant/create-customer | data: { . full_name (string) . email (string) . phone (string) } (object) required |
| get_api_customers | Get a list of all your customers. This endpoint is only supported from version 2024-09-01 Full documentation: Merchant API - Retrieve a customer listhttps://developer.revolut.com/docs/merchant/retrieve-customer-list | No parameters |
| get_api_customers_by_customer_id | Get the information about a specific customer, based on its ID. This endpoint is only supported from version 2024-09-01 Full documentation: Merchant API - Retrieve a customerhttps://developer.revolut.com/docs/merchant/retrieve-customer | customer_id (string) required |
| patch_api_customers_by_customer_id | Update the attributes of a specific customer. This endpoint is only supported from version 2024-09-01 Full documentation: Merchant API - Update a customerhttps://developer.revolut.com/docs/merchant/update-customer | customer_id (string) required data: { . full_name (string) . email (string) . phone (string) } (object) required |
| delete_api_customers_by_customer_id | Delete the profile of a specific customer. This endpoint is only supported from version 2024-09-01 Full documentation: Merchant API - Delete a customerhttps://developer.revolut.com/docs/merchant/delete-customer | customer_id (string) required |
| get_api_customers_by_customer_id_payment_methods | Retrieve all the payment methods for a specific customer. This endpoint is only supported from version 2024-09-01 Full documentation: Merchant API - Retrieve payment method list of a customerhttps://developer.revolut.com/docs/merchant/retrieve-payment-method-list | customer_id (string) required |
| get_api_customers_by_customer_id_payment_methods_by_payment_method_id | Retrieve the information of a specific payment method that is saved. This endpoint is only supported from version 2024-09-01 Full documentation: Merchant API - Retrieve a customer's payment methodhttps://developer.revolut.com/docs/merchant/retrieve-payment-method | customer_id (string) required payment_method_id (string) required |
| patch_api_customers_by_customer_id_payment_methods_by_payment_method_id | When you use this request to update a customer's payment method, the payment method can't be used by the merchant to initiate transactions any more. This payment method can be used only when the customer is on the checkout page. This endpoint is only supported from version 2024-09-01 Full documentation: Merchant API - Update a customer's payment methodhttps://developer.revolut.com/docs/merchant/update-payment-method | customer_id (string) required payment_method_id (string) required data: { . saved_for (string) } (object) required |
| delete_api_customers_by_customer_id_payment_methods_by_payment_method_id | Delete a specific payment method. This endpoint is only supported from version 2024-09-01 Full documentation: Merchant API - Delete a customer's payment methodhttps://developer.revolut.com/docs/merchant/delete-payment-method | customer_id (string) required payment_method_id (string) required |
| get_api_payments_by_payment_id | Retrieve information about a specific payment, based on the payment's ID. Full documentation: Merchant API - Retrieve payment detailshttps://developer.revolut.com/docs/merchant/retrieve-payment-details | payment_id (string) required |
| post_api_subscription_plans | Create a new subscription plan with one or more pricing variations. Full documentation: Merchant API - Create a subscription planhttps://developer.revolut.com/docs/merchant/create-subscription-plan | data: { . name (string) . variations (array) } (object) required |
| get_api_subscription_plans | Retrieve all subscription plans configured for your merchant account. Full documentation: Merchant API - Retrieve a subscription plan listhttps://developer.revolut.com/docs/merchant/retrieve-subscription-plan-list | No parameters |
| get_api_subscription_plans_by_subscription_plan_id | Retrieve a specific subscription plan by its unique identifier. Full documentation: Merchant API - Retrieve a subscription planhttps://developer.revolut.com/docs/merchant/retrieve-subscription-plan | subscription_plan_id (string) required |
| post_api_subscriptions | Create a new subscription for a customer using a subscription plan variation. Full documentation: Merchant API - Create a subscriptionhttps://developer.revolut.com/docs/merchant/create-subscription | data (object) required |
| get_api_subscriptions | Retrieve all subscriptions for the merchant account. Full documentation: Merchant API - Retrieve a subscription listhttps://developer.revolut.com/docs/merchant/retrieve-subscription-list | No parameters |
| get_api_subscriptions_by_subscription_id | Retrieve a subscription by its unique identifier. Full documentation: Merchant API - Retrieve a subscriptionhttps://developer.revolut.com/docs/merchant/retrieve-subscription | subscription_id (string) required |
| patch_api_subscriptions_by_subscription_id | Update a subscription's details. Full documentation: Merchant API - Update a subscriptionhttps://developer.revolut.com/docs/merchant/update-subscription | subscription_id (string) required data: { . external_reference (string) } (object) required |
| post_api_subscriptions_by_subscription_id_change_plan | Change a subscription plan | subscription_id (string) required data: { . plan_variation_id (string) . scheduled (string) } (object) required |
| post_api_subscriptions_by_subscription_id_update_renewal_date | Reschedule the upcoming payment date for an active subscription cycle. Full documentation: Merchant API - Update a subscription renewal datehttps://developer.revolut.com/docs/merchant/update-subscription-renewal-date | subscription_id (string) required data: { . renewal_date (string) } (object) required |
| post_api_subscriptions_by_subscription_id_cancel | Cancel a subscription. Full documentation: Merchant API - Cancel a subscriptionhttps://developer.revolut.com/docs/merchant/cancel-subscription | subscription_id (string) required |
| get_api_subscriptions_by_subscription_id_cycles | Retrieve all billing cycles for a specific subscription. Full documentation: Merchant API - Retrieve a subscription cycle listhttps://developer.revolut.com/docs/merchant/retrieve-subscription-cycle-list | subscription_id (string) required |
| get_api_subscriptions_by_subscription_id_cycles_by_cycle_id | Retrieve a specific billing cycle for a subscription by its unique identifier. Full documentation: Merchant API - Retrieve a subscription cyclehttps://developer.revolut.com/docs/merchant/retrieve-subscription-cycle | subscription_id (string) required cycle_id (string) required |
| post_api_subscription_usages | Report a unit of consumption against a usage-based subscription item. Revolut accumulates reported records throughout the billing cycle and processes the charge after the cycle's usage_cutoff_date. Full documentation: Merchant API - Create a subscription usagehttps://developer.revolut.com/docs/merchant/create-subscription-usage | data: { . subscription_id (string) . subscription_item_code (string) . usage_date (string) . quantity (integer) . metadata (object) } (object) required |
| get_api_subscription_usages | Retrieve all usage records for the merchant account. Results are ordered by usage_date, unlike other list endpoints which order by created_at. Full documentation: Merchant API - Retrieve a subscription usage listhttps://developer.revolut.com/docs/merchant/retrieve-subscription-usage-list | No parameters |
| get_api_subscription_usages_by_usage_id | Retrieve a usage record by its unique identifier. Full documentation: Merchant API - Retrieve a subscription usagehttps://developer.revolut.com/docs/merchant/retrieve-subscription-usage | usage_id (string) required |
| patch_api_subscription_usages_by_usage_id | Update the quantity or metadata of a subscription usage record. Full documentation: Merchant API - Update a subscription usagehttps://developer.revolut.com/docs/merchant/update-subscription-usage | usage_id (string) required data: { . quantity (integer) . metadata (object) } (object) required |
| delete_api_subscription_usages_by_usage_id | Delete a subscription usage record. This operation is only permitted while the billing cycle is still open. Full documentation: Merchant API - Delete a subscription usagehttps://developer.revolut.com/docs/merchant/delete-subscription-usage | usage_id (string) required data: { . quantity (integer) . metadata (object) } (object) required |
| get_api_payouts | Retrieve all the payouts you made from your Merchant account. You can also use the query parameters for: - Filtering - Pagination Full documentation: Merchant API - Retrieve a payout listhttps://developer.revolut.com/docs/merchant/retrieve-payout-list | limit (string) |
| get_api_payouts_by_payout_id | Retrieve the details of a payout. Provide the unique payout ID, and the corresponding payout information is returned. Full documentation: Merchant API - Retrieve a payouthttps://developer.revolut.com/docs/merchant/retrieve-payout | payout_id (string) required |
| get_api_disputes | Retrieve all the disputes linked to your Merchant account. You can also use the query parameters for: - Filtering - Pagination Full documentation: Merchant API - Retrieve a dispute listhttps://developer.revolut.com/docs/merchant/retrieve-dispute-list | No parameters |
| get_api_disputes_by_dispute_id | Retrieve the details of a dispute. Provide the unique dispute ID, and the corresponding dispute information is returned. Full documentation: Merchant API - Retrieve a disputehttps://developer.revolut.com/docs/merchant/retrieve-dispute | dispute_id (string) required |
| post_api_disputes_by_dispute_id_accept | Marks a specific dispute as accepted. After accepting a dispute, you cannot challenge it. Full documentation: Merchant API - Accept a disputehttps://developer.revolut.com/docs/merchant/accept-dispute | dispute_id (string) required |
| post_api_disputes_by_dispute_id_evidences | Allows uploading a single evidence file for a specific dispute. Use these evidences to provide proof for claims when challenging a dispute. Full documentation: Merchant API - Upload evidence for a disputehttps://developer.revolut.com/docs/merchant/upload-dispute-evidence | dispute_id (string) required |
| post_api_disputes_by_dispute_id_challenge | Allows challenging a dispute with a reason, comment and associated evidences. Use the uploaded evidences to provide proof for the challenge. A dispute previously accepted, cannot be challenged. Full documentation: Merchant API - Challenge a disputehttps://developer.revolut.com/docs/merchant/challenge-dispute | dispute_id (string) required data: { . reason (string) . comment (string) . evidences (array) } (object) required |
| post_api_report_runs | Start generating a new report of the relevant transactions. Full documentation: Merchant API - Create a new report runhttps://developer.revolut.com/docs/merchant/create-report-run | data: { . filter (object) . format (string) . type (string) } (object) required |
| get_api_report_runs_by_report_run_id | Retrieve details of a report run, based on the report_run_id. Full documentation: Merchant API - Retrieve report run detailshttps://developer.revolut.com/docs/merchant/retrieve-report-run-details | report_run_id (string) required |
| get_api_report_runs_by_report_run_id_file | Use this endpoint to download the generated report file. Full documentation: Merchant API - Download report filehttps://developer.revolut.com/docs/merchant/download-report-file | report_run_id (string) required |
| post_api_webhooks | Set up a webhook URL so that the Merchant API can push event notifications to the specified URL. This endpoint is only supported from version 2024-09-01 Full documentation: Merchant API - Create a webhookhttps://developer.revolut.com/docs/merchant/set-webhook | data (object) required |
| get_api_webhooks | Get a list of webhooks that you are currently subscribed to. This endpoint is only supported from version 2024-09-01 Full documentation: Merchant API - Retrieve a webhook listhttps://developer.revolut.com/docs/merchant/retrieve-webhook-list | No parameters |
| get_api_webhooks_by_webhook_id | Get the details of a specific webhook. This endpoint is only supported from version 2024-09-01 Full documentation: Merchant API - Retrieve a webhookhttps://developer.revolut.com/docs/merchant/retrieve-webhook | webhook_id (string) required |
| patch_api_webhooks_by_webhook_id | Update the details of a specific webhook. This endpoint is only supported from version 2024-09-01 Full documentation: Merchant API - Update a webhookhttps://developer.revolut.com/docs/merchant/update-webhook | webhook_id (string) required data (object) required |
| delete_api_webhooks_by_webhook_id | Delete a webhook so that events are not sent to the specified URL any more. This endpoint is only supported from version 2024-09-01 Full documentation: Merchant API - Delete a webhookhttps://developer.revolut.com/docs/merchant/delete-webhook | webhook_id (string) required |
| post_api_webhooks_by_webhook_id_rotate_signing_secret | Rotate the signing_secret for a specific webhook. This endpoint is only supported from version 2024-09-01 Full documentation: Merchant API: Rotate a webhook signing secrethttps://developer.revolut.com/docs/merchant/rotate-webhook-signing-secret | webhook_id (string) required data: { . expiration_period (string) } (object) required |
| post_api_locations | Create a Location object. Full codumentation: Merchant API: Create a locationhttps://developer.revolut.com/docs/merchant/create-location | data: { . name (string) . type (string) . details (object) } (object) required |
| get_api_locations | Retrieve a list of locations registered for the merchant. Full documentation: Merchant API: Retrieve location listhttps://developer.revolut.com/docs/merchant/retrieve-location-list | No parameters |
| get_api_locations_by_location_id | Retrieve details of a specific location, based on its ID. Full documentation: Merchant API: Retrieve a locationhttps://developer.revolut.com/docs/merchant/retrieve-location | location_id (string) required |
| patch_api_locations_by_location_id | Update details of a specific location, based on its ID. NOTE: The value of the location's type cannot be updated. Full documentation: Merchant API: Update a locationhttps://developer.revolut.com/docs/merchant/update-location | location_id (string) required data: { . name (string) . details (object) } (object) required |
| delete_api_locations_by_location_id | Delete a specific location, based on its ID. Full documentation: Merchant API: Delete a locationhttps://developer.revolut.com/docs/merchant/delete-location | location_id (string) required |
| get_api_terminals | Retrieve a list of Revolut Terminal devices available to the merchant. Full documentation: Merchant API - Retrieve terminal listhttps://developer.revolut.com/docs/merchant/retrieve-terminal-list | operation_mode (string) location_id (string) |
| post_api_orders_by_order_id_payment_intents | Create a payment intent to push a payment request to a specific Revolut Terminal device. Full documentation: Merchant API - Create a payment intenthttps://developer.revolut.com/docs/merchant/create-payment-intent | order_id (string) required data: { . amount (integer) . terminal_id (string) } (object) required |
| get_api_payment_intents_by_payment_intent_id | Retrieve the current state and details of a payment intent. Full documentation: Merchant API - Retrieve a payment intenthttps://developer.revolut.com/docs/merchant/retrieve-payment-intent | payment_intent_id (string) required |
| post_api_payments_by_payment_id_cancel | Cancel a payment intent while it's still in pending state, before the customer has completed the payment. Full documentation: Merchant API - Cancel a payment intenthttps://developer.revolut.com/docs/merchant/cancel-payment-intent | payment_id (string) required |
| post_api_apple_pay_domains_register | Register your website's domain to accept payments via Apple Pay. Full documentation: Merchant API - Register domain for Apple Payhttps://developer.revolut.com/docs/merchant/register-domain-apple-pay | data: { . domain (string) } (object) required |
| post_api_synchronous_webhooks | Use this endpoint to register a URL where Revolut can send shipping addresses from a Revolut Pay customer for validation during the Fast checkout processhttps://developer.revolut.com/docs/guides/accept-payments/payment-methods/accept-payments-via-revolut-pay2/fast-checkout. Full documentation: Merchant API - Register address validation endpoint for Fast checkouthttps://developer.revolut.com/docs/merchant/register-address-validation-endpoint | data (object) required |
| get_api_synchronous_webhooks | Retrieve a list of synchronous webhook objects. You can use this endpoint to see your different address validation endpoints registered to different locations. Full documentation: Merchant API - Retrieve synchronous webhook listhttps://developer.revolut.com/docs/merchant/retrieve-synchronous-webhook-list | No parameters |
| delete_api_synchronous_webhooks_by_synchronous_webhook_id | Delete a specific synchronous webhook registration, based on its ID. Full documentation: Merchant API - Delete a synchronous webhookhttps://developer.revolut.com/docs/merchant/delete-synchronous-webhook | synchronous_webhook_id (string) required |
| post_api_1_0_orders | Create an Order object. Full documentation: Merchant API - Create an order Deprecatedhttps://developer.revolut.com/docs/merchant/legacy/create-order-deprecated | data: { . amount (integer) . merchant_order_ext_ref (string) . email (string) . currency (string) } (object) required |
| get_api_1_0_orders_by_order_id | Retrieve the details of an order that has been created. Provide the unique order ID, and the corresponding order information is returned. Full documentation: Merchant API - Retrieve an order Deprecatedhttps://developer.revolut.com/docs/merchant/legacy/retrieve-order-deprecated | order_id (string) required |
| patch_api_1_0_orders_by_order_id | Update the details of an order. Specific limitations apply based on the state of the order, see full documentation: Merchant API - Update an order Deprecatedhttps://developer.revolut.com/docs/merchant/legacy/update-order-deprecated | order_id (string) required data: { . amount (integer) . currency (string) . merchant_order_ext_ref (string) } (object) required |
| post_api_1_0_orders_by_order_id_capture | Capture the funds of an existing, uncaptured order. When the payment for an order is authorized, the order is captured and sent to the processing stage. Full documentation: Merchant API - Capture an order Deprecatedhttps://developer.revolut.com/docs/merchant/legacy/capture-order-deprecated | order_id (string) required data: { . amount (integer) } (object) required |
| post_api_1_0_orders_by_order_id_cancel | Cancel an existing uncaptured order. Specific limitations apply based on the state of the order, see full documentation: Merchant API - Cancel an orderhttps://developer.revolut.com/docs/merchant/legacy/cancel-order-deprecated | order_id (string) required |
| custom | Call any endpoint of the connected service while reusing the connection auth. Pass the full URL as _url. Other reserved keys: _method, _query, _body, _headers. Remaining params flow naturally — empty → GET, non-empty → POST JSON body. | _url (string) required _method (string) _query (object) _body _headers (object) |
Webhook Events
This connector emits 7 events back to your workflow. To receive one, create a hook whose path is <connection-name>/<event> — the connection name you configured plus the event from the table below.
| Event | Description |
|---|---|
| order-authorised | Triggered when an order is authorised. |
| order-completed | Triggered when an order is completed. |
| order-cancelled | Triggered when an order is cancelled. |
| order-payment-authenticated | Triggered when a payment is authenticated e.g. after 3-D Secure. |
| order-payment-declined | Triggered when a payment is declined. |
| order-payment-failed | Triggered when a payment fails. |
| payment-method-updated | Triggered when the saved payment method of a customer is updated. |