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.

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.

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	}

$	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	}