Descarga nuestro plugin.
Descargar PluginCompatibilidad
- WooCommerce >= 7.0
- PHP >= 7.4
Recuerda
- Contar con tu propio código de comercio y llave secreta
- Contar con WooCommerce instalado en tu sitio
- Contar con un sitio 'https' seguro
WooCommerce | Plugin Webpay Plus
Webpay REST
Descripción
Este plugin oficial ha sido creado para que puedas integrar Webpay fácilmente en tu comercio, basado en WooCommerce.
Estás viendo la nueva documentación REST de este plugin. Si aún estás usando la versión anterior SOAP (la que te solicita certificados y una llave privada), revisa este video para actualizarte.
Requisitos
Debes tener instalado previamente WooCommerce. Asegúrate de tener habilitados los siguientes módulos / extensiones para PHP:
- Extensión de PHP JSON (ext-json)
- OpenSSL 1.0.1 o superior
- DOM 2.7.8 o superior
- PHP 7.4 o superior
Al instalar el plugin, podrás revisar si todas estos requisitos se cumplen, a través de la pantalla de diagnóstico que se incluye.
Esta pantalla de diagnóstico se encuentra en la sección de configuración del plugin (en donde configuras tu código de comercio y tu llave secreta). Ahí verás un tab "Diagnóstico".
Instalación
Como se puede ver en el video, los pasos para instalar el plugin son los siguientes:
- Entra al panel de administración de tu Wordpress > Plugins > Agregar Nuevo
- Busca el plugin "Transbank Webpay Plus REST", instálalo y actívalo.
Instalación manual
Si no puedes instalarlo de manera automática, también puedes descargar el archivo .zip del plugin y cargarlo manualmente en tu Wordpress.
- Descargar el archivo .zip del plugin
- Sube el archivo zip en la sección Plugin > Subir nuevo plugin en el administrador de tu Wordpress Las instrucciones detalladas de instalación las puedes encontrar en el siguiente link.
Cómo usar
Una vez instalado, se agregará un nuevo método de pago al proceso de checkout. Si no se activa correctamente, revisa que el plugin esté activo y que tu tienda está configurada en Pesos Chilenos.
Ambiente de pruebas
Una vez instalado el plugin, este viene configurado en el ambiente de Integración de Transbank, por lo que puedes realizar todas las pruebas de pago que necesites, ya que no se usa dinero real. En este ambiente solo funcionan las tarjetas de crédito y débito de prueba que puedes encontrar acá.
Anulaciones
Dentro del detalle de una orden, podrás realizar una anulación o reversa de un pago. Puedes ver el detalle de una reversa o anulación ("refund") en este link
Las tarjetas de débito solo soportan Reversas (refunds realizados dentro de los primeros 30 minutos de aprobada la transacción). En tarjetas de crédito se permiten reversas, anulaciones y anulaciones parciales.
En el siguiente video te mostramos como realizar el proceso:
Consultar estado
También en el detalle de una orden, se puede revisar el estado actual de una transacción (hasta por 7 días de realizada la transacción). Se puede revisar si una transacción está autorizada, anulada, parcialmente anulada o reversada.
En el siguiente video te dejamos las instrucciones para realizar este proceso
Obtener tu llave secreta (proceso de validación)
Para usar el plugin en el ambiente de producción (donde se utiliza dinero real), necesitas tener tu llave secreta, que es un código especial que está asociado a tu código de comercio. Para obtenerla necesitas pasar un proceso de validación, que está explicado acá.
Este proceso pretende verificar que el comercio transacciona de manera segura y sin problemas. Esta validación es un requisito para dejar al comercio en producción y no se permitirá que un comercio utilice productivamente el servicio Webpay sin poseer esta validación.
Para integración con plugins, creamos un nuevo formulario online para que comiences el proceso de validación: Comenzar formulario de integración
Soporte validará el formulario enviado y, de estar todo correcto, se te notificará la conformidad para pasar a producción, recibiendo tu llave secreta (Api Key Secret) de producción y algunas instrucciones.
Nota: Esta llave secreta es una contraseña de tu código de comercio, por lo que no debes compartirla.
Puesta en producción
Si ya tienes tu código de comercio de producción y llave secreta, solo debes entrar a la configuración de tu plugin (instrucciones en este link) y colocar:
- Ambiente: Producción
- Código de comercio: tu código de comercio de producción
- Api Key: Tu llave secreta
Al guardar, el plugin funcionará inmediatamente en ambiente de producción y podrás operar con tarjetas y transacciones reales. Se te solicitará realizar una transacción real en este ambiente de producción por $50 para finalizar tu proceso.
Problemas, Dudas, Sugerencias
Si tienes algún problema, duda o sugerencia, puedes contactarnos en nuestra comunidad de Slack, a la que puedes unirte acá
Adicionalmente, puedes revisar si más comercios han presentado algún error o dudas similares en los issues del repositorio github. Si nadie ha comentado algo similar, puedes crear un nuevo issue con tu sugerencia, bug, problema, etc.