¿Para quién es?
¿Qué es la API Merchant?
Es la que le da a un terminal físico —un datáfono, una caja registradora, un POS— la capacidad de cobrar con tarjeta y entenderse con SPIDI. Si el pago ocurre en tu local, con el cliente presente y una tarjeta, es aquí.
SPIDI cobra de dos formas — esta es una:
| Tu cliente paga… | Dónde | Con qué | API |
|---|---|---|---|
| En tu local, con el datáfono | Presencial | Tarjeta | Merchant |
| Desde una web, app o un enlace | Online | Cuenta, Pago Móvil, cripto | Productos |
¿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 cobrar 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 la API Productos.
- 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 cobro y el terminal confirma el pago con la tarjeta.
- Si hace falta, anulas un pago ya cobrado.
- 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 cobro.
Dos actores, dos modelos de confianza
Por debajo, 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
La rama Merchant está tomando forma: el modelo y la comunicación con el POS están documentados a partir del contrato. Las guías paso a paso y la referencia se completan a continuación.