---
title: "Connect a Revolut payment method (nothing is charged)"
method: POST
path: "/agents/connect-payment"
tags: ["agents"]
---

# Connect a Revolut payment method (nothing is charged)

`POST /agents/connect-payment`

## Request

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

Returns a one-time connect_url, valid for one hour, to open in a browser. The page takes a card or Revolut Pay and saves it for this account with a zero-amount order: nothing is charged to connect. GET /agents/me shows payment.connected once it is saved. Top-ups, auto-refills and bookings are then charged to the connected method. Connecting again replaces the previous method.

## Request body

- object
  - `return_url` string, uri: Optional. Where the connect page returns the browser afterwards.

## Response `200`

A one-time connect link.

- object
  - `status` string
  - `connect_url` string, uri
  - `expires_in_seconds` integer
  - `payment` object
  - `message` string

---

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