Saltar al contenido principal
Redeban es el datáfono de los kioscos de Fire spark en Colombia. Un pago del dashboard es un botón del checkout. El kiosco llama a SIPConnector por HTTPS y el datáfono toma la venta de esa nube. Tu kiosco dibuja el aviso de espera que envía el adaptador. Solo kiosco. POS, web e iOS no usan este paquete. No hay módulo nativo, config plugin de Expo ni binario. Sigue las secciones de abajo para integrarlo a mano. Para dárselo a un agente, copia el prompt de Prompt para un agente.

Requisitos

  • Un kiosco que ya cobra con @fire-spark/core (setPaymentAdapters, setPaymentOptions, payIntent).
  • El pago del comercio completo en el dashboard: URL del servicio, código único, usuario, clave y clave de supervisor.
  • En cada kiosco: código de terminal, número de caja y código de cajero. Los tres tienen que estar guardados. Si falta uno, la API no manda el pago y el botón no sale en el checkout.

Activarlo

  1. En el dashboard, abre tu comercio, ve a Payments y crea un pago con el proveedor Redeban y el método PIN pad.
  2. En Connection Settings, completa:
No hay ajustes por tienda. Estos valores los comparten todos los datáfonos Redeban del comercio.
  1. En cada kiosco, abre el dispositivo y la pestaña Payments. Los valores viven en settings_overrides.payment_settings, con el id del pago como clave. Ver Configurar un dispositivo.
Un pago al que le falta un dato del dispositivo no llega al kiosco, así que su botón no aparece en el checkout. En el listado de dispositivos, la columna Payments muestra lo que sigue vacío.

Botón del checkout

Cada pago Redeban es un botón. El template del kiosco ya pinta una tarjeta por pago a partir de services.payments.list (CheckoutPaymentMethodCard). No agregas un componente de botón. Redeban no tiene modalidades. paymentInstructionKind trata un pago PIN_PAD como tarjeta, así que el template muestra la ilustración de tarjeta. El paquete no forma parte del template público. Agrégalo en la app de kiosco del comercio. useCheckoutPayments oculta solo el datáfono de personal de Fire spark (firespark y PIN_PAD). Un pago Redeban se queda en la lista.

Usarlo en el SDK

Agrega el paquete a la app del kiosco. No forma parte del template público. Fíjalo a la misma versión que @fire-spark/payments.
Este pago no tiene config plugin de Expo ni paso de prebuild. Registra el adaptador una vez por pedido. redebanPinPadPayments() no recibe URL ni claves. Cada cobro lee el contexto que arma PaymentSession a partir de getKioskConfig.
kioskConfig es lo que devuelve getKioskConfig. Los valores del dispositivo llegan en overrides.payment_settings. La config autenticada incluye secret_clave y secret_supervisor_password. El listado público del storefront quita esos secretos. Cada start pide un token nuevo a SIPConnector. El token dura 3 minutos. Déjalo en el adaptador. El adaptador no dibuja nada. Al empezar el cobro llama a ui.message con el texto Present the card on the pinpad y kind: "waiting".
Cancelar aborta la señal de payIntent. El kiosco no llama a Borrar y no arma la trama de la venta. Cobra el pago que eligió el cliente:
payIntent({ payment }) sigue colocando un tender. Para partir Redeban con otro método, llama a setTenders con una asignación y después a payIntent(). Ver Usar pagos en el SDK. El plazo del cobro es de 370 segundos. Cubre dos fases de consulta de 184 segundos. Deja runtime.timeout_ms sin definir para conservar ese plazo. Un valor en el pago lo reemplaza, así que uno más corto corta la venta a la mitad. order.getMissingPaymentFields(payment) lista los campos del dispositivo que siguen vacíos. La API ya oculta un pago incompleto. Usa el helper en la pantalla de administración del kiosco cuando quieras mostrar qué falta.

Qué ve el cliente

El aviso de espera y un control para cancelar. En PAID, sigue con el pedido. El código de autorización, la marca, los últimos 4 dígitos, el número de recibo y el terminal están en result.metadata.payment. No hay texto de vía del cliente para imprimir. El kiosco no los guarda por su cuenta. AMBIGUOUS es el código del error, no un estado. El estado sigue en FAILED. El texto sale de formatPaymentError en @fire-spark/payments.

Webhooks

Ninguno.

Anulaciones

order.cancel() anula un pedido que no se entregó. order.refund() reembolsa uno que sí. reversalFor siempre devuelve cancel, así que las dos corren la anulación total del adaptador. No hay devolución parcial, y el adaptador no tiene operación refund. La anulación envía el recibo guardado y secret_supervisor_password del pago. El kiosco no pide esa clave.

Errores comunes

Compatibilidad

Prompt para un agente

Pega esto en el agente que edita la app del kiosco. Cubre solo Redeban. Las secciones de arriba son el mismo trabajo, escrito para una persona.
Prompt de integración