Cerrar lote de terminal | Documentación API de Recurrente

Cierra el lote abierto actual de una terminal POS. Recurrente marca el lote como closed, calcula sus totales y deja la terminal lista para abrir un nuevo lote automáticamente con el próximo pago.

Este endpoint es útil para integraciones que controlan el POS desde un sistema externo y necesitan cerrar lote sin operar la pantalla de la terminal.

Envía Idempotency-Key para reintentos seguros: si tu sistema pierde la respuesta después de cerrar el lote, repetir el mismo request con la misma clave devuelve la respuesta original en vez de intentar cerrar otro lote.

Cierra el lote abierto actual de una terminal POS. Recurrente marca el lote como `closed`, calcula sus totales y deja la terminal lista para abrir un nuevo lote automáticamente con el próximo pago. Este endpoint es útil para integraciones que controlan el POS desde un sistema externo y necesitan cerrar lote sin operar la pantalla de la terminal. Envía `Idempotency-Key` para reintentos seguros: si tu sistema pierde la respuesta después de cerrar el lote, repetir el mismo request con la misma clave devuelve la respuesta original en vez de intentar cerrar otro lote.

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.

terminal_idstringRequired

ID de la terminal POS cuyo lote abierto quieres cerrar

Response

Lote cerrado exitosamente

idstringOptional

ID del lote cerrado

statusenumOptional

Estado del lote

terminal_idstringOptional

ID de la terminal POS

transaction_countintegerOptional

Cantidad de transacciones exitosas incluidas en el lote

total_in_centsintegerOptional

Total agregado del lote en centavos

total_currencyenumOptional

Moneda principal del lote

totals_by_currencymap from strings to integersOptional

Totales del lote agrupados por moneda

opened_atdatetimeOptional

Fecha y hora en que se abrió el lote

closed_atdatetime or nullOptional

Fecha y hora en que se cerró el lote

Errors

404

Not Found Error

422

Unprocessable Entity Error

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

1	{
2	"id": "tb_abc123",
3	"status": "closed",
4	"terminal_id": "trm_abc123",
5	"transaction_count": 12,
6	"total_in_cents": 125000,
7	"total_currency": "GTQ",
8	"totals_by_currency": {
9	"GTQ": 125000
10	},
11	"opened_at": "2026-07-07T08:00:00-06:00",
12	"closed_at": "2026-07-07T17:30:00-06:00"
13	}

Authentication

Headers

Request

Response

Errors