Skip to main content
POST
Preview a currency conversion for a ready customer account
Preview a cross-currency conversion between two accounts owned by this customer. Returns a signed preview_token, rate, amount_from / amount_to, and expires_at (often only a few minutes). Confirm before expiry.
Same-currency moves use book transfers. Corridor ramps use quote → accept.
Guide: Currency conversions.

Authorizations

X-API-Key
string
header
required

Path Parameters

customer_id
string
required

Public customer id returned by POST /partner/customers

Example:

"pcus_a1b2c3d4e5f6"

account_id
integer
required

Source account id owned by this customer

Example:

63

Body

application/json
to_account_id
integer
required

Destination partner account id (different currency, same customer)

amount
string
required

Decimal debit amount in the source account currency

Example:

"1.00"

Response

Cross-currency conversion preview

status
enum<string>
required
Available options:
success
message
string
required
data
object