Para integrar Webpay en una página web, el servidor crea una transacción, recibe un token y una URL, envía al cliente al formulario de pago y confirma el resultado al regresar. Solo después de esa confirmación la orden debe marcarse como pagada.
La parte crítica no es mostrar el formulario. Es mantener sincronizados monto, orden, estado y respuesta cuando el pago se aprueba, rechaza, interrumpe o el cliente cierra el navegador.
Primero: elegir la forma correcta de integrar Webpay
Un ecommerce conocido puede usar una aplicación o extensión mantenida. Una plataforma propia necesita SDK o API. La elección depende de quién mantendrá el flujo y cuánta personalización requiere la operación.
- Plugin o aplicación para Shopify, WooCommerce u otra plataforma compatible.
- Integración mediante SDK para una aplicación propia.
- Desarrollo específico si existe una lógica de órdenes o conciliación particular.
Cómo funciona el flujo de Webpay Plus
Crear la transacción
El backend envía orden de compra, sesión, monto y URL de retorno. Según los ejemplos oficiales de Transbank, la respuesta incluye token y URL para continuar. Las credenciales se usan en el servidor y nunca deben exponerse en el navegador.
Redirigir al formulario
La página envía el token al formulario de Webpay. La experiencia debe explicar que el usuario saldrá momentáneamente del sitio y qué ocurrirá al finalizar.
Confirmar el resultado
Al volver, el servidor confirma la transacción y registra la respuesta. La pantalla de éxito debe representar ese resultado, no una simple visita a la URL de retorno.
Resolver interrupciones
Si el navegador se cierra o la respuesta se corta, el sistema necesita consultar estado o conciliar después. Los ejemplos y referencias oficiales están disponibles en el portal Transbank Developers para Webpay.
Datos que debes guardar en cada intento
El registro permite responder al cliente y conciliar. Guarda identificadores útiles sin almacenar información sensible de tarjeta que no corresponde a tu sistema.
- Orden interna y orden enviada al proveedor.
- ID de sesión o usuario cuando aplique.
- Monto y moneda esperados.
- Token o referencia de la transacción.
- Estado, código de respuesta y fecha.
- Historial de cambios y reintentos.
Pruebas necesarias antes de producción
- Pago aprobado y actualización correcta de la orden.
- Pago rechazado con mensaje comprensible y opción de reintento.
- Cliente que abandona antes de pagar.
- Retorno duplicado o actualización repetida.
- Monto u orden que no coincide con el registro local.
- Caída temporal del sistema o respuesta tardía.
- Anulación, reversa o conciliación según el producto contratado.
Transbank ofrece un ambiente de integración y proyectos de ejemplo para probar el flujo antes de usar credenciales productivas. La revisión debe cubrir backend, interfaz, correo y sistema de pedidos.
Seguridad y operación
Credenciales y ambientes
Separa integración y producción. Guarda claves en variables seguras del servidor, limita accesos y rota credenciales si se exponen.
HTTPS y validación
La web debe usar HTTPS, validar entradas y no confiar en datos manipulables desde el cliente. Montos y productos se calculan nuevamente en el servidor.
Monitoreo y conciliación
Registra errores y define una alerta cuando el pago y la orden no coinciden. Una revisión diaria puede detectar cobros autorizados que no activaron el pedido por una interrupción.
Responsable del incidente
La empresa debe saber quién revisa una diferencia, qué datos solicita y cómo responde al cliente sin cobrar dos veces.
Señal de una integración controlada
Cada pago puede rastrearse desde la orden hasta su estado final sin depender de capturas enviadas por el comprador.
Webpay en WordPress, WooCommerce y Shopify
En plataformas conocidas suele convenir una integración soportada, siempre que sea compatible con la versión actual, mantenga estados correctamente y tenga responsable de actualizaciones. Personalizar el checkout sin entender el ciclo de órdenes puede crear errores difíciles de conciliar.
Para Shopify, revisa además las restricciones y opciones vigentes de pagos en la plataforma. La guía de pasarelas de pago para Shopify en Chile ayuda a comparar el contexto completo.
Qué pedir al cotizar una integración Webpay
- Producto Webpay y plataforma exacta que se integrará.
- Responsable del contrato y credenciales productivas.
- Flujos, estados y casos de error cubiertos.
- Registro, conciliación y alertas incluidas.
- Pruebas y criterio de aceptación antes de publicar.
- Documentación, soporte y mantenimiento posterior.
Preguntas frecuentes
¿Cómo se integra Webpay en una página web?
La web crea una transacción desde el servidor, recibe una URL y token, redirige al formulario de pago y luego confirma el resultado en el retorno antes de marcar la orden como pagada.
¿Puedo integrar Webpay en WordPress o WooCommerce?
Sí. Puede usarse una extensión compatible o una integración específica. Debes revisar mantenimiento, compatibilidad, manejo de estados y soporte, no solo que aparezca el botón de pago.
¿Qué se necesita para pasar Webpay a producción?
Se requiere la relación comercial y credenciales correspondientes, una integración probada, HTTPS, manejo seguro de secretos y validación de flujos aprobados, rechazados, anulados e interrumpidos.
¿Cómo evito pedidos pagados que aparecen pendientes?
Confirma la transacción en el servidor, registra orden, monto, token y estado, evita depender del navegador del cliente y agrega conciliación o consulta de estado para casos interrumpidos.
¿Prefieres que Webpay quede funcionando y probado?
La integración de pasarelas entra en el plan de Integraciones API, $99.000 netos, que cubre WebPay, Mercado Pago, Stripe o PayPal, la conexión con tus sistemas y la documentación técnica. Se entrega con pedidos de prueba hechos y los estados conciliados, no solo "conectado".