Skip to main content
POST
Generates a rate-locked quote for a cross-border payment. The quote guarantees the displayed rate and fee for 5 minutes. Use the returned quote_id when executing the payment with POST /sendmoney.
Requires an Idempotency-Key header.
Quotes are valid for 5 minutes. Execute POST /sendmoney with the quote_id within this window to guarantee the rate.

Authorizations

X-Api-Key
string
header
required

Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.

X-Api-Secret
string
header
required

Your API secret (yativo_sk_...), shown once when the key is created.

Headers

Idempotency-Key
string
required

A unique string per request to ensure idempotent processing.

Body

application/json
from_currency
string
required

Source currency code (e.g. "USD", "EUR").

Example:

"USD"

to_currency
string
required

Destination currency code (e.g. "CLP", "MXN", "BRL").

Example:

"MXN"

amount
number
required

Amount in the source currency to send.

Example:

200

Response

200 - application/json

Quote created

status
string
status_code
integer
message
string
data
object