Saltar al contenido principal
Webpay Plus es el formulario de pago de Transbank para tarjetas en Chile. Fire spark crea la transacción con tus llaves de comercio, tu canal abre el formulario de Webpay y Fire spark confirma el pago cuando Webpay devuelve al cliente. Las llaves nunca llegan al navegador ni a la app. 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).
  • setPaymentUI con challenge. 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 597055555532 con la llave pública de integración.

Actívalo

  1. En el dashboard, abre tu merchant, ve a Payments y crea un pago con el proveedor Transbank y el método Card.
  2. 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

El adaptador no recibe opciones. Implementa 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:
En una app React Native, carga 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 en result.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 pago PAID 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.
Una devolución que Transbank rechaza (por ejemplo después de 90 días) falla en el ledger de la orden con el mensaje de Webpay, y se devuelve a mano.

Errores comunes

Pasar a producción

  1. Aprueba la validación de Transbank en validador.transbankdevelopers.cl con tu código de comercio de producción y tu logo de 130x59.
  2. Pon el código de comercio de producción y la llave que te envía Transbank en el pago de producción.
  3. 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