Saltar al contenido principal
Transbank Hasar H2H es el pinpad de los kioscos de Fire spark en Chile. Un pago del dashboard es un botón del checkout. El kiosco escribe un archivo de propiedades y el JAR de Hasar habla con el pinpad por el puerto serial. Tu kiosco dibuja el aviso de espera que envía el adaptador. 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.
No commitees los cuatro JAR ni libjSerialComm.so. La app del kiosco apunta el config plugin a un binariesDir de la máquina de build.

Activarlo

  1. En el dashboard, abre tu comercio, ve a Payments y crea un pago con el proveedor Transbank y el método PIN pad.
  2. En Connection Settings, completa:
  1. En cada tienda, agrega los ajustes de tienda:
  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 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 de services.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ítulo Card type y opciones Credit y Debit. Muestra esas cadenas tal como llegan. Si cierra el selector, la promesa se rechaza y el pinpad no arranca. Después el adaptador llama ui.message con Present the card on the pinpad y kind: "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 como isPixOnlyPayment. No trates Transbank como Pix.
Los paquetes no forman parte del template público. Agrégalos en la app de kiosco del comercio. 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í:
El plugin copia los JAR a 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".
Cancelar en pantalla aborta la señal de 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:
Una venta aprobada vuelve 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. En PAID, 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 con reversalFor 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