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í.
SPIDI recibe pagos de dos formas — esta es una:
| Tu cliente paga… | Dónde | Con qué | Solución |
|---|---|---|---|
| En tu local, con el datáfono | Presencial | Tarjeta | Pagos en punto de venta |
| Desde una web, app o un enlace | Online | Cuenta, Pago Móvil, cripto | Pagos en línea |
¿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…
- Recibes pagos online (web, app o enlace) → esa es Pagos en línea.
- No programas → usa SPIDI Center o un plugin.
¿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 · Modo integrador
Próximamente: las guías paso a paso y la referencia completa de la API Merchant.