---
title: "Connect a Revolut payment method"
method: POST
path: "/api/v1/agents/connect-payment"
tags: ["Authentication"]
---

# Connect a Revolut payment method

`POST /api/v1/agents/connect-payment`

## Request

- Base URL: `https://letsfg.co/developers/api/v1`
- URL: `https://letsfg.co/developers/api/v1/api/v1/agents/connect-payment`
- Auth: API key in header `X-API-Key`

Returns a one-time `connect_url`. Open it in a browser — yourself, or hand it to whoever
pays for this account — and save a card or Revolut Pay. The page saves the method for
merchant use with a zero-amount order: **nothing is charged to connect**.

The link is valid for one hour. `GET /agents/me` → `payment.connected` turns true once the
method is saved. Connecting again replaces the previous method.

A connected method is what opens flight search; it is also what bookings, top-ups and
auto-refills are charged to, customer not present.

## Request body

- object
  - `return_url` string, uri: Where to send the browser after the method is saved.

## Response `200`

Connect link minted

- ConnectPaymentResponse
  - `status` string
  - `connect_url` string, uri: Open in a browser to save a card or Revolut Pay. Nothing is charged.
  - `expires_in_seconds` integer
  - `payment` object: The currently connected method, if any.
  - `message` string

## Other responses

- `401`: Invalid or missing API key
- `503`: Card connection temporarily unavailable

## Changes

- **2026-09-08** `177953280ce4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/letsfg/apis/letsfg-api/changes/api/v1/agents/connect-payment/post.md)

---

[API](https://skmtc.dev/letsfg/apis/letsfg-api.md) · [All operations](https://skmtc.dev/letsfg/apis/letsfg-api/llms.txt) · [OpenAPI document](https://skmtc.dev/letsfg/apis/letsfg-api/revisions/3c4b139ca14f?raw)