Web y apps móviles. Los kioscos con pinpad Hasar usan Transbank pinpad.
Sigue las secciones de abajo para integrarlo a mano. Para pasarle el mismo trabajo a un agente, copia el prompt de Prompt para agentes de IA.
Requisitos
- Un canal que ya cobra con
@fire-spark/core(setPaymentAdapters,setPaymentOptions,payIntent). setPaymentUIconchallenge. Webpay se abre como un challenge de pago: popup o pestaña nueva en la web, WebView en una app. Transbank desaconseja el iframe.- Un código de comercio de Webpay Plus. Para integración, usa
597055555532con la llave pública de integración.
Actívalo
- En el dashboard, abre tu merchant, ve a Payments y crea un pago con el proveedor Transbank y el método Card.
- En Connection Settings, completa:
El ambiente sandbox llama a
webpay3gint.transbank.cl y producción a webpay3g.transbank.cl. En sandbox, usa el código 597055555532 y la llave 579B532A7440BB0C9079DED94D31EA1615BACEB56610332264630D42D0A36B1C. Transbank envía la llave de producción cuando apruebas la validación.Úsalo en el SDK
challenge en setPaymentUI. El adaptador lo llama con method: "POST" y un parámetro, token_ws. En la web, paymentChallengeDocument(challenge) de @fire-spark/payments arma la página que envía el formulario:
paymentChallengeDocument(challenge) en un WebView con source={{ html }} y resuelve con el mensaje fire-spark:payment-challenge de window.ReactNativeWebView.
Cobra el pago que eligió el cliente:
payIntent({ payment }) crea un tender real. Para dividir Webpay con otro método, llama order.setTenders con una asignación y después payIntent(). Ver Usar pagos en el SDK.
Cuando el challenge termina, el adaptador le pide el resultado a Fire spark. Si el cliente cerró la ventana antes de que Webpay lo devolviera, Fire spark confirma el token igual, así que un pago que pasó no se pierde.
Qué ve el cliente
El formulario de Webpay y después tu pantalla de resultado. Transbank pide que muestres tu propio comprobante: número de orden, comercio, monto, código de autorización, fecha, tipo de pago, cuotas y los últimos 4 dígitos. Están enresult.details y result.metadata.payment.
Webhooks
Ninguno. Webpay devuelve el navegador a una URL de Fire spark firmada por intento. Fire spark confirma ahí y cierra el pago.Anulaciones
Cancela o devuelve la orden. Fire spark devuelve un pagoPAID con las llaves del comercio. Webpay decide el tipo:
- El monto total dentro de las 3 horas del pago es una reversa.
- Después de eso, o un monto parcial, es una anulación, hasta 90 días. La anulación parcial no funciona en cuotas con interés.
Errores comunes
Pasar a producción
- Aprueba la validación de Transbank en validador.transbankdevelopers.cl con tu código de comercio de producción y tu logo de 130x59.
- Pon el código de comercio de producción y la llave que te envía Transbank en el pago de producción.
- Haz una compra de $50 en producción.
Compatibilidad
No incluye: captura diferida, Webpay Plus Mall, Oneclick ni USD.
Prompt para agentes de IA
Pega esto en el agente que edita tu canal web o app. Cubre solo Transbank Webpay Plus.Prompt de integración