API Referencia
undefined

Descarga nuestro plugin.

Descargar Plugin

Compatibilidad

  • Magento2 2.2.X , 2.3.X y 2.4.X
  • PHP >= 7.0

Recuerda

  1. Contar con tu propio código de comercio y llave secreta
  2. Contar con Magento2 instalado en tu sitio
  3. Contar con un sitio 'https' seguro

Webpay REST Magento2

Webpay REST

Descripción

Este plugin oficial ha sido creado para que puedas integrar Webpay fácilmente en tu comercio, basado en Magento2. Puedes encontrar el repositorio Open Source de este plugin acá.

Requisitos

Debes tener instalado previamente Magento2. Asegúrate de tener habilitados los siguientes módulos / extensiones para PHP:

  • OpenSSL 1.0.1 o superior
  • SimpleXML
  • DOM 2.7.8 o superior
  • PHP 7.0 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í debes presionar el botón "Información del sistema"

Instalación

A) Con composer (recomendado)

Esta es la opción recomendada para instalar el paquete en Magento.

Primero, entrar con la terminal al directorio raíz de Magento e instalar el paquete usando Composer.

composer require transbank/webpay-magento2-rest

Cuando finalice, ejecutar el comando:

magento module:enable Transbank_Webpay --clear-static-content

y finalmente:

magento setup:upgrade && magento setup:di:compile && magento setup:static-content:deploy

Puedes encontrar las instrucciones detalladas de instalación las puedes encontrar en el siguiente link del repositorio.

B) Como archivo

  1. Descargar el archivo .zip del plugin
  2. Descomprimir el archivo en la carpeta app/code/Transbank/WebpayRest
  3. Edita el archivo app/etc/config.php y agrega Transbank_Webpay_Rest => 1 a la lista de módulos.
  4. Entra al admin de magento y elimina el caché. (System > Cache Management)
  5. El módulo debería estar instalado.

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á.

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á.

Al finalizar este proceso de validación, obtendrás tu llave secreta. Nota: Esta llave secreta es como la contraseña de tu código de comercio, por lo que no debes compartirla. Se usa para identificar que tu comercio es quién realmente está realizando cada operación (transacción, anulación de un pago, etc).

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.

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/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.