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

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. Si operas una plataforma, pasa account_id para que la venta y su DTE se registren bajo una cuenta conectada (se emite bajo el NIT de esa cuenta).

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. Si operas una plataforma, pasa `account_id` para que la venta y su DTE se registren bajo una cuenta conectada (se emite bajo el NIT de esa cuenta).

Authentication

X-SECRET-KEYstring

Tu clave secreta de API

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.

account_idstringOptional

(Opcional) ID de la cuenta conectada (hijo) que será el comercio de registro de la venta (modelo directo). El DTE en efectivo se emite bajo su NIT usando su facturación administrada. Si se omite, la venta y el DTE quedan bajo la cuenta dueña del API key.

Response

Venta en efectivo registrada

idstring

statusstring

amount_in_centsinteger

currencystring

descriptionstring

tax_idstring or null

created_atdatetime

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	}