Authentication

Connect a Revolut payment method

Changed on

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.

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

Request body

return_urlstring uri

Where to send the browser after the method is saved.

Response

Connect link minted

statusstring
connect_urlstring uri

Open in a browser to save a card or Revolut Pay. Nothing is charged.

expires_in_secondsinteger
paymentobject

The currently connected method, if any.

messagestring

Example response

{
  "status": "connect_required",
  "connect_url": "https://letsfg.co/connect?dev=sess_abc123",
  "expires_in_seconds": 3600
}

Changes