Referencia APICurrency Conversions

Crear una cotización de conversión

Crea una cotización con tipo de cambio fijo (estado `awaiting_confirmation`, válida 1 hora) para convertir balance entre GTQ y USD. Envía **uno solo de los dos montos**: `source_amount_in_cents` si sabes cuánto quieres convertir, o `destination_amount_in_cents` si sabes cuánto quieres recibir — la dirección se infiere del monto que envíes. Confírmala con `POST /currency_conversions/{id}/confirm`. Requiere movimiento de dinero habilitado.

Authentication

X-SECRET-KEYstring
Tu clave secreta de API

Headers

Idempotency-KeystringOptional

Clave de idempotencia para reintentos seguros de operaciones críticas, especialmente las que mueven dinero o cambian estado operativo. Reintentar con la misma clave y el mismo cuerpo devuelve la respuesta original (header Idempotency-Replayed: true); reusarla con parámetros distintos devuelve 409.

Request

This endpoint expects an object.
source_currencyenumRequired
Allowed values:
destination_currencyenumRequired
Allowed values:
source_amount_in_centsintegerOptional

Envía este monto si sabes cuánto quieres convertir del balance de origen (exact-in)

destination_amount_in_centsintegerOptional

O envía solo este monto si sabes cuánto quieres recibir en la moneda destino (exact-out)

Response

Cotización creada

idstring
statusenum
source_currencystring
source_amount_in_centsinteger
destination_currencystring
destination_amount_in_centsinteger
exchange_ratedouble
expires_atdatetime or null
created_atdatetime