Solo kiosco Android. POS, web e iOS no usan este paquete. No es POS Integrado ni el POS Autoservicio PAX IM30.
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 Android que ya cobra con
@fire-spark/core(setPaymentAdapters,setPaymentOptions,payIntent). - Un development build. Expo Go no carga el módulo nativo.
- Los binarios de Hasar, fuera de git. El pinpad va en
/dev/ttyACM0. - El kiosco puede escribir
Download/SDKChile.
Activarlo
- En el dashboard, abre tu comercio, ve a Payments y crea un pago con el proveedor Transbank y el método PIN pad.
- En Connection Settings, completa:
- En cada tienda, agrega los ajustes de tienda:
- 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 campo de tienda o de dispositivo no llega al kiosco, así que su botón no sale en el checkout.
Botón del checkout
Cada pago Transbank 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.
paymentInstructionKind trata un pago PIN_PAD como tarjeta, salvo que ese pago sea solo Pix. Las modalidades de Transbank son CREDIT y DEBIT, así que el template muestra la ilustración de tarjeta. El texto del botón es payment.name.
- Las dos modalidades en un pago: el cliente elige una antes de que arranque el pinpad. El adaptador pregunta con
ui.select, títuloCard typey opcionesCredityDebit. Muestra esas cadenas tal como llegan. Si cierra el selector, la promesa se rechaza y el pinpad no arranca. Después el adaptador llamaui.messageconPresent the card on the pinpadykind: "waiting". - Una sola modalidad: no hay selector. El cobro pasa directo al aviso de espera.
- Crédito y débito en botones propios: crea un segundo pago con una sola modalidad, por ejemplo
modalities: ["DEBIT"]. Queda al lado del primero. Los dos muestran la ilustración de tarjeta. No hay un helper de Transbank comoisPixOnlyPayment. No trates Transbank como Pix.
useCheckoutPayments oculta solo el datáfono de personal de Fire spark (firespark y PIN_PAD). Un pago Transbank se queda en la lista.
Binarios
Agrega los dos paquetes a la app del kiosco del comercio. Fíjalos a la misma versión que@fire-spark/payments. No los agregues al template público del kiosco.
binariesDir es absoluta o relativa a la app. Tiene que verse así:
android/app/libs y las .so a jniLibs. El prebuild falla con [transbank] missing ... si falta un archivo.
Usarlo en el SDK
Registra el adaptador una vez por orden.transbankPinPadPayments() no recibe llaves. Cada cobro lee el contexto que arma PaymentSession desde getKioskConfig.
kioskConfig es lo que devuelve getKioskConfig. Los valores del dispositivo llegan en overrides.payment_settings. No hay secretos.
Si las dos modalidades están activas, el adaptador llama ui.select con el título Card type y las opciones Credit y Debit. Después llama ui.message con Present the card on the pinpad y kind: "waiting".
payIntent. Eso solo vale antes de que empiece la llamada nativa. Una venta que ya está en el pinpad no se aborta.
Cobra el pago que eligió el cliente:
PENDING con metadata.confirm_after_inject. El core la confirma después de inyectar la orden. No la confirmes antes.
El plazo del adaptador es 180 segundos. Deja runtime.timeout_ms vacío para conservarlo. Un valor más corto en el pago lo reemplaza.
La moneda tiene que ser CLP. Cualquier otra devuelve INVALID_REQUEST y no llama al pinpad.
Qué ve el cliente
La elección de tipo de tarjeta, cuando van las dos modalidades, y después el aviso de espera. EnPAID, imprime metadata.receipt.customer y metadata.receipt.merchant. Los dos son el texto de VOUCHER. No lo decodifiques.
Webhooks
Ninguno.Anulaciones
El core elige la reversa conreversalFor del adaptador. Una venta que sigue PENDING (la orden no se inyectó) se reversa con procesaReversa(). Eso lo hace el core solo. Una venta PAID se deshace con una devolución (devolucion) y después una confirmación (confirmacion()). order.cancel() la corre en una orden no entregada. order.refund() la corre en una orden entregada.
Errores comunes
Compatibilidad
Prompt para un agente
Pega esto en el agente que edita la app del kiosco. Cubre solo Transbank Hasar H2H. Las secciones de arriba son el mismo trabajo, escrito para una persona.Prompt de integración