Menú: Documentación

Pay at table

Flujo de integración

Conecta tu TPV con honei Terminal: cómo consulta honei las cuentas abiertas y cómo te envía los pagos.

Pay at table conecta tu TPV con honei Terminal para que los restaurantes partners cobren más rápido y con más flexibilidad. El camarero cobra desde el terminal y el pago llega a tu TPV.

Aquí es honei quien llama a tu sistema: debes exponer dos endpoints, además de enviarnos tus salas y mesas.

Lo que tienes que implementarhoneiConsulta cada minutoGET /tabTPVDevuelve la cuentahoneiCuando se cobraPOST /paymentTPVRegistra el pago

Obtener la cuenta

Una cuenta (tab) es el contenido de una mesa junto con los pagos relacionados con ese contenido.

Primero tenemos que conocer esa cuenta, así que la primera petición se refiere a la mesa por tableId. Cuando la cuenta es conocida, los servidores de honei la piden cada minuto por tabId, hasta que se cierra.

↻ Cada minuto, hasta que se cierrePide la cuenta con tableId1Devuelve la cuenta2Pide la cuenta con tabId3Devuelve la cuenta4honeiTPV
GETObtener una cuenta{yourApiURL}/tabAPI reference

Una cuenta abierta termina en uno de estos estados:

openCuenta abiertaclosedCerradacancelledCancelada

Recibir un pago

Cuando el camarero decide cubrir la cuenta, en parte o por completo, enviamos el pago al TPV.

Elige qué parte cobrar1Registra el cobro2Envía el pago3Confirma la recepción4CamareroTerminalhoneiTPV
POSTRecibir un pago{yourApiURL}/paymentAPI reference

Probar la integración

Cuando tengas los dos endpoints listos, sigue la guía de Testing.