Pagos en punto de venta — ¿para quién es?
¿Qué es Pagos en punto de venta?
Es la solución de SPIDI que le da a un terminal físico —un datáfono, una caja registradora, un POS— la capacidad de recibir pagos con tarjeta y entenderse con SPIDI. Por debajo corre la API Merchant. Si el pago ocurre en tu local, con el cliente presente y una tarjeta, es aquí.
¿Para quién es?
Para quien desarrolla el software de ese terminal: un POS, una caja registradora, una app para datáfono, o un ERP / sistema de tienda que necesita recibir pagos con tarjeta en el mostrador.
Es para ti si…
- Desarrollas software para terminales / datáfonos o cajas registradoras.
- Integras SPIDI como medio de pago presencial con tarjeta en un POS.
- Necesitas emparejar terminales, procesar el pago a dos tiempos y cerrar el lote del día.
NO es para ti si…
- El pago no ocurre en un terminal físico con el cliente presente. Esta no es la documentación que buscas — escríbele a SPIDI y te orientan.
- No desarrollas el software del terminal: habla con tu proveedor de POS.
¿Cómo funciona? (4 pasos)
- Das de alta el terminal una vez (lo "vinculas"): SPIDI le entrega una llave secreta que queda guardada en el aparato.
- En cada venta, tu sistema crea el pago y el terminal confirma el pago con la tarjeta.
- Si hace falta, anulas un pago ya confirmado.
- Al cerrar el día, el terminal envía el cierre de lote (el cuadre de caja).
Cada mensaje del terminal viaja firmado, para que nadie pueda falsificar un pago.
Dos actores, dos modelos de confianza
Por debajo, la API Merchant separa dos roles para que el robo de un dispositivo no comprometa la cuenta del comercio:
| Actor | Alcance | Seguridad |
|---|---|---|
| Merchant / Admin | Backend, ERP, dashboards | JWT (Bearer) — token de corta duración |
| Terminal / POS | El dispositivo físico | HMAC (POS Signature) — llave secreta persistente en el aparato |
→ Conceptos (Merchant) · Comunicación con punto de venta
Próximamente: las guías paso a paso de cada flujo. La referencia completa de la API Merchant ya está disponible en Referencia.