Registrar una venta cobrada en efectivo | Documentación API de Recurrente

La respuesta devuelve el ID del recurso unificado (in_…). Persiste ese ID para reconciliar el evento intent.succeeded y para consultar el estado actual mediante GET /intents/{id}. También aparece como checkout.latest_intent.id; solo el id superior del evento legacy cash_intent.succeeded usa el ID concreto del CashIntent (ca_…).

tax_invoice_url en los webhooks refleja el estado del DTE al momento de la entrega. Puede ser null si la emisión todavía no concluyó o falló y luego se recupera. Ese cambio no genera un segundo webhook de éxito; recupera la URL actual con GET /intents/{id}.

Si operas una plataforma, envía X-ACCOUNT-ID tanto al crear como al consultar para que la venta y su DTE pertenezcan a la cuenta conectada y se emitan bajo su NIT. X-CUSTOM-ACCOUNT-ID no selecciona el contexto de lectura.

Registra una venta cobrada en efectivo. No mueve dinero por Recurrente: no se descuenta comisión, no impacta el balance del merchant, y no se genera transacción en el ledger. Si pasas `tax_id`, se intenta emitir la factura electrónica (DTE) automáticamente. La respuesta devuelve el ID del recurso unificado (`in_…`). Persiste ese ID para reconciliar el evento `intent.succeeded` y para consultar el estado actual mediante `GET /intents/{id}`. También aparece como `checkout.latest_intent.id`; solo el `id` superior del evento legacy `cash_intent.succeeded` usa el ID concreto del `CashIntent` (`ca_…`). `tax_invoice_url` en los webhooks refleja el estado del DTE al momento de la entrega. Puede ser `null` si la emisión todavía no concluyó o falló y luego se recupera. Ese cambio no genera un segundo webhook de éxito; recupera la URL actual con `GET /intents/{id}`. Si operas una plataforma, envía `X-ACCOUNT-ID` tanto al crear como al consultar para que la venta y su DTE pertenezcan a la cuenta conectada y se emitan bajo su NIT. `X-CUSTOM-ACCOUNT-ID` no selecciona el contexto de lectura.

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.

amount_in_centsintegerRequired

Monto en centavos

currencyenumOptional

Moneda. Default — la moneda principal de la cuenta.

Allowed values:

descriptionstringOptional

(Opcional) Descripción visible en el recibo y la actividad

tax_idstringOptional

(Opcional) NIT del cliente. Si la cuenta tiene facturación electrónica configurada, se emite el DTE automáticamente.

Response

Venta en efectivo registrada

idstringOptionalformat: "^in_"

ID del intent unificado. Úsalo con GET /intents/{id} y con el id superior de los eventos intent.*.

statusstringOptional

amount_in_centsintegerOptional

currencystringOptional

descriptionstringOptional

tax_idstring or nullOptional

created_atdatetimeOptional

Errors

401

Unauthorized Error

422

Unprocessable Entity Error

$	curl -X POST https://app.recurrente.com/api/cash_sales \
>	-H "X-SECRET-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"amount_in_cents": 5000
>	}'

1	{
2	"id": "in_abcdefgh",
3	"status": "succeeded",
4	"amount_in_cents": 5000,
5	"currency": "GTQ",
6	"description": "Pago en efectivo",
7	"tax_id": "CF",
8	"created_at": "2026-05-28T12:34:56Z"
9	}