Convert amounts from any supported currency into EUR/GBP/USD

Returns the live exchange rate and the converted amounts, for pricing a payment link or subscription offer in a local currency. The rate is not locked: it is accurate at the time of the call and moves continuously. Do NOT store the converted amount yourself — send sourceCurrency on the create endpoint and the API converts authoritatively.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

The currency you are pricing in (ISO 4217). Case-insensitive. Must differ from currency.

string
enum
required

The currency of the link or offer you are about to create — the one the converted amount is stored and charged in. Same name and meaning as currency on the create endpoints.

Allowed:
lines
array of objects
required

The lines you are about to price — one entry per line item, with its quantity. Send the same lines to the create endpoint and total.amountInCents below is the amount it stores at this rate.

lines*
Responses

400

FX_AUTHORING_DISABLED, FX_SOURCE_EQUALS_TARGET, FX_CURRENCY_NOT_SUPPORTED or FX_QUOTE_RATE_MISSING.

503

FX_RATE_UNAVAILABLE — no rate could be obtained; retry.

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json