currencyConversions

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.

post/currency_conversions

Headers

X-SECRET-KEYstring required

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Idempotency-Keystring

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 body

source_currency'GTQ' | 'USD' required
destination_currency'GTQ' | 'USD' required
source_amount_in_centsinteger

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

destination_amount_in_centsinteger

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

Response

Cotización creada

idstring
status'awaiting_confirmation' | 'pending' | 'processed' | 'reverted'
source_currencystring
source_amount_in_centsinteger
destination_currencystring
destination_amount_in_centsinteger
exchange_ratenumber double
expires_atstring date-time nullable
created_atstring date-time

Changes

No recorded changes to this endpoint across all 1 revision of this API.