API Referencia
undefined

Descarga nuestro plugin.

Descargar Plugin

Compatibilidad

  • WooCommerce >= 7.0
  • PHP >= 7.4

Recuerda

  1. Contar con tu propio código de comercio y llave secreta
  2. Contar con WooCommerce instalado en tu sitio
  3. 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.

Cómo pasar de SOAP a REST
Youtube

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:

  1. Entra al panel de administración de tu Wordpress > Plugins > Agregar Nuevo
  2. Busca el plugin "Transbank Webpay Plus REST", instálalo y actívalo.
Cómo instalar el plugin de WooCommerce
Youtube

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.

  1. Descargar el archivo .zip del plugin
  2. 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:

Tutorial de "refunds" (41s)
Youtube

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

Tutorial de consulta de transacción (02:07)
Youtube

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:

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

Cómo pasar a producción
Youtube

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.