Menú: Documentación

Pay at counter y APK · Local API

Nuevo pago

Cómo hacer un cobro directamente contra el terminal en la red local y consultar su resultado.

Este es el flujo que debes seguir para hacer un nuevo pago directamente contra el terminal, por la red local.

Flujo de integración

↻ Mientras el estado sea processingInicia el pago con tu ref1202 · status: processing23Muestra la pantalla de cobroConsulta el estado por ref4status: processing5Consulta el estado por ref6Estado final y paymentId7TPVTerminal

1. Inicia el pago

Genera un ref propio. Esta llamada abre en el terminal la pantalla para pasar o acercar la tarjeta y responde de inmediato: no espera a que el cliente pague.

El mismo ref siempre devuelve el mismo resultado, así que reintentar nunca genera un segundo cobro.

POSTIniciar un pago/device-bridge/init-paymentAPI reference

2. Consulta el estado

Hazlo con short polling mientras status siga en processing.

GETConsultar pago o devolución/device-bridge/payments/:ref/statusAPI reference
processingEsperando al clientecompletedPago correctodeclinedRechazadoerrorError durante la operación

El terminal guarda el resultado durante 7 días. Después, responde not_found.