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
- En el dashboard, abre tu comercio, ve a Payments y crea un pago con el proveedor Redeban y el método PIN pad.
- En Connection Settings, completa:
No hay ajustes por tienda. Estos valores los comparten todos los datáfonos Redeban del comercio.
- 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 deservices.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.
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. EnPAID, 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