Pagos presenciales
El riel de tarjeta presente — terminales físicas y cómo una venta de terminal se convierte en una transacción de Vecnet.
El riel presencial (inperson_cp) maneja los pagos con tarjeta presente: un
cliente acerca, inserta o desliza una tarjeta en una terminal física en
sucursal. A diferencia de los pagos en línea, estas ventas se originan en el
dispositivo, no a través de la API. El trabajo de Vecnet es ingerir cada
venta, conciliarla y atribuirla al comercio correcto, para que el dinero
presencial caiga en el mismo libro mayor, la misma liquidación y la misma
bitácora que todo lo demás.
Cómo entra una venta de terminal
La venta ocurre en el dispositivo
Un cliente paga en una terminal física y la venta se autoriza en el dispositivo.
La venta llega a Vecnet
El resultado llega a Vecnet en tiempo real y, como red de seguridad, un proceso periódico de conciliación recoge cualquier venta que no haya llegado.
Vecnet registra una transacción
La venta se convierte en una fila de transactions con rail: "inperson_cp",
el terminal_id, el status y
metadata de punto de venta (código de autorización, número de ticket, modo de
lectura, meses sin intereses y más).
Se atribuye y se liquida
La transacción se atribuye al comercio dueño de la terminal y después fluye por el libro mayor y la liquidación como cualquier otro pago. La lees por la API de transacciones y te enteras por webhook.
Terminales y sucursales
Una terminal es un recurso terminales ligado a un comercio, opcionalmente
agrupado bajo una sucursal (tienda o punto de venta).
{
"id": "trm_6b5a49c2",
"serial": "TRM-DEMO-0001",
"model": "Terminal",
"merchant_id": "mrc_3f9a2c1b",
"sucursal_id": "suc_centro",
"status": "online",
"last_seen": "2026-06-22T14:30:00.000Z"
}| Campo | Descripción |
|---|---|
serial | El número de serie impreso en la terminal. |
model | El modelo del hardware. |
merchant_id | El comercio al que pertenece la terminal. |
sucursal_id | La sucursal o punto de venta (un recurso sucursales). |
status | online, offline o maintenance. |
last_seen | La última vez que el dispositivo reportó actividad. |
Lista las terminales de un comercio:
curl https://api.vecnet.io/api/terminales \
-H "Authorization: Token vk_live_1a2b3c4d5e6f7a8b9c0d"Vincular una terminal a un comercio
Una terminal se puede (re)asignar a un comercio desde el panel. Vincularla
actualiza el merchant_id y la sucursal de la terminal, y puede re-atribuir
sus transacciones históricas al nuevo comercio para que los libros queden
consistentes.
curl -X POST https://api.vecnet.io/api/terminales/trm_6b5a49c2/link \
-H "Authorization: Bearer <jwt>" \
-H "Content-Type: application/json" \
-d '{ "merchant_id": "mrc_3f9a2c1b", "reassign_transactions": true }'Vincular es una acción de operador. Una terminal cuyas ventas llegan antes de estar vinculada queda atribuida a una cuenta de resguardo de la plataforma hasta que se asigna, y entonces puede re-atribuirse al vincularla.