Crear una cotización de conversión | Documentación API de Recurrente

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.

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.

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.

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`.

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

idstringOptional

statusenumOptional

source_currencystringOptional

source_amount_in_centsintegerOptional

destination_currencystringOptional

destination_amount_in_centsintegerOptional

exchange_ratedoubleOptional

expires_atdatetime or nullOptional

created_atdatetimeOptional

$	curl -X POST https://app.recurrente.com/api/currency_conversions \
>	-H "X-SECRET-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"source_currency": "GTQ",
>	"destination_currency": "GTQ"
>	}'

1	{
2	"id": "cu_ab12cd34",
3	"status": "awaiting_confirmation",
4	"source_currency": "USD",
5	"source_amount_in_cents": 10000,
6	"destination_currency": "GTQ",
7	"destination_amount_in_cents": 75000,
8	"exchange_rate": 7.5,
9	"expires_at": "2024-01-15T09:30:00Z",
10	"created_at": "2024-01-15T09:30:00Z"
11	}

Authentication

Headers

Request

Response