Pay at counter y APK · Cloud API
Nuevo pago
Cómo hacer un cobro en un terminal desde la nube de honei: elegir el terminal, iniciar el pago, consultar su estado y cancelarlo.
Con la Cloud API, tu TPV pide el cobro a honei, honei avisa al terminal y tú consultas el estado hasta tener un resultado final.
Flujo de integración
1. Elige el terminal
Cada llamada necesita un terminalId. Obtén la lista de terminales del local:
/terminalsAPI reference
2. Inicia el pago
Esta llamada abre en el terminal la pantalla para pasar la tarjeta y responde de inmediato con la URL para consultar el estado.
POSTIniciar un pago/terminals/:terminalId/init-paymentAPI reference
3. Consulta el estado
Hazlo con long polling mientras status siga en processing. Cuando el pago termina, la respuesta incluye la propina, si se ha dejado, y los datos de la tarjeta.
/terminals/:terminalId/payments/:paymentId/statusAPI reference
Un pago en curso acaba en uno de estos estados:
Cancelar un pago
Si el cliente se arrepiente mientras el terminal espera la tarjeta, puedes interrumpir la operación. Solo es posible si el terminal lo permite: en ese caso, la respuesta del paso 2 incluye paymentAbortUrl.
/terminals/:terminalId/payments/:paymentId/abortAPI reference