# Revolut Payment intents API

**Canonical:** https://apis.io/apis/revolut/revolut-payment-intents-api/  
**Provider:** Revolut — https://apis.io/providers/revolut/  
**Base URL:** https://b2b.revolut.com/api/1.0  
**Documentation:** https://developer.revolut.com/docs/business/business-api

Revolut Payment intents API is one of 46 APIs that [Revolut](https://apis.io/providers/revolut/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Payment Intents. The published artifact set on APIs.io includes an OpenAPI specification.

Operations for managing payment intents in the push payments to Revolut Terminal flow. A **payment intent** represents the intention to complete payment for a specific order on a specific Revolut Terminal device. Payment intents are the mechanism that links orders created via the Merchant API with physical terminal devices in **Pay at Counter** mode. ## What is a payment intent? When you create a payment intent, you're pushing a payment request from your POS system to a Revolut Terminal. The payment intent: - Links an order to a specific terminal device - Triggers the payment request to appear on the terminal screen - Tracks the customer's interaction with the terminal (pending → processing → completed) - Provides a `payment_id` when completed, which you use to retrieve the final payment status ## Payment intent lifecycle 1. **Create:** Push a payment intent to a terminal by [creating a payment intent](https://developer.revolut.com/docs/api/merchant#create-payment-intent) 1. **Track:** Poll the payment intent status by [retrieving payment intent details](https://developer.revolut.com/docs/api/merchant#retrieve-payment-intent) until it reaches a final state 1. **Complete:** When state is `completed`, extract the `payment_id` and [retrieve the final payment status](https://developer.revolut.com/docs/api/merchant#retrieve-payment-details) 1. **Cancel (optional):** Cancel pending payment intents using [Cancel a payment intent](https://developer.revolut.com/docs/api/merchant#cancel-payment-intent) ## Important notes - A payment intent reaching `completed` state means the checkout process finished on the terminal, but it does **not** guarantee the payment succeeded - You must check the actual payment status using the `payment_id` returned in the completed payment intent - Payment status can be `captured`/`completed` (successful), `declined` (card rejected), `failed` (technical error), or `cancelled` :::info For the complete push payments integration guide, see: [Push payments to Revolut Terminal](https://developer.revolut.com/docs/guides/merchant/accept-payments/in-person-payments/terminal/push-payments). :::

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/revolut/refs/heads/main/openapi/revolut-payment-intents-api-openapi.yml

## Other Revolut APIs (12)

- [Revolut Accounting API](https://apis.io/apis/revolut/revolut-accounting-api/)
- [Revolut Accounting categories API](https://apis.io/apis/revolut/revolut-accounting-categories-api/)
- [Revolut Accounts API](https://apis.io/apis/revolut/revolut-accounts-api/)
- [Revolut Apple Pay merchant registration API](https://apis.io/apis/revolut/revolut-apple-pay-merchant-registration-api/)
- [Revolut Applications API](https://apis.io/apis/revolut/revolut-applications-api/)
- [Revolut Balance API](https://apis.io/apis/revolut/revolut-balance-api/)
- [Revolut Card invitations API](https://apis.io/apis/revolut/revolut-card-invitations-api/)
- [Revolut Cards API](https://apis.io/apis/revolut/revolut-cards-api/)
- [Revolut Configuration API](https://apis.io/apis/revolut/revolut-configuration-api/)
- [Revolut Counterparties API](https://apis.io/apis/revolut/revolut-counterparties-api/)
- [Revolut Customers API](https://apis.io/apis/revolut/revolut-customers-api/)
- [Revolut Disputes API](https://apis.io/apis/revolut/revolut-disputes-api/)

## Tags

Payment Intents

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/revolut/revolut-payment-intents-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/revolut/.