Integrar Webpay Plus tiene cinco pasos: conseguir un código de comercio productivo de Transbank, programar y probar la integración en el ambiente de pruebas, enviar el formulario de validación con evidencias, recibir la llave secreta y configurar producción haciendo una compra real de $50. El paso que más se atrasa es la validación.
1. Consigue tu código de comercio
Transbank solo valida integraciones de comercios que tienen un código de comercio productivo. Se solicita desde el portal de clientes de Transbank o con tu ejecutivo comercial. Mientras tanto, puedes desarrollar con las credenciales públicas del ambiente de integración.
2. Elige cómo integrar
- Plugin oficial para plataformas como WooCommerce: lo más rápido si tu tienda usa una de ellas.
- SDK oficial de Transbank en tu lenguaje, si la tienda es a medida.
- API directa, si necesitas control total del flujo.
3. Prueba en el ambiente de integración
Transbank entrega tarjetas de prueba para simular pagos aprobados y rechazados. Aquí se prueba lo que más falla en la práctica: que el retorno desde Webpay confirme la transacción en tu servidor y que el pedido cambie de estado solo cuando la confirmación es válida.
4. Envía la validación
Cuando la integración está lista, completas el formulario de validación con las evidencias de las transacciones de prueba (órdenes de compra, fecha y hora). Transbank responde por correo. Si aprueba, te entrega la llave secreta (API Key Secret) asociada a tu código de comercio. Trátala como una contraseña: nunca debe quedar en el código visible del navegador.
5. Pasa a producción
Cambias la configuración al ambiente de producción con tu código de comercio y tu llave secreta, y haces una compra real de $50 para confirmar que todo funciona, tal como indica la documentación de Transbank Developers.
Errores comunes
- Pago aprobado, pedido pendiente: la tienda no confirma la transacción al volver de Webpay o no guarda el resultado. Se corrige en el flujo de retorno y confirmación.
- Pedidos marcados pagados sin pagar: la tienda confía en lo que envía el navegador. El estado debe cambiar solo con la confirmación del servidor.
- Seguir en integración sin darse cuenta: las compras "funcionan" pero no llega dinero. Revisa que el ambiente sea producción.
- Plugin desactualizado: Transbank actualiza plugins y SDK; mantenerlos al día es parte de los deberes del comercio.
Así funciona el pago en Akim Pet Market: el pedido se marca pagado solo cuando Transbank lo confirma en el servidor.
Preguntas frecuentes
¿Cuánto demora integrar Webpay?
La parte técnica puede resolverse en pocos días; el total depende de cuándo obtengas tu código de comercio y de la respuesta de Transbank a la validación.
¿Qué es la llave secreta de Webpay?
Es el código que Transbank entrega tras aprobar la validación y que, junto al código de comercio, permite cobrar en producción. No se comparte.
¿Por qué hay que hacer una compra de $50?
Es la prueba que Transbank indica para confirmar que la tienda funciona correctamente en producción.