RErecurrente
currencyConversions

Crear una cotización de conversión

Changed on

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

Request

Headers

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

  • 3d76463f9fd8Revision changes
    • warning

      deleted the header request parameter X-SECRET-KEY

    • info

      the endpoint scheme security secretKey was added to the API

  • 3f07af5cbba7Revision changes
    • info

      api operation id create-currency-conversion removed and replaced with currencyConversions_createCurrencyConversion