Skip to content

Latest commit

 

History

History
154 lines (82 loc) · 5.29 KB

INSTALLATION.md

File metadata and controls

154 lines (82 loc) · 5.29 KB

Manual de instalación para Plugin Opencart con Webpay REST

Descripción

Este plugin oficial ha sido creado para que puedas integrar Webpay fácilmente en tu comercio, basado en Opencart.

Requisitos

Debes tener instalado previamente Opencart.

Habilitar los siguientes módulos / extensiones para PHP:

  • OpenSSL 1.0.1 o superior
  • DOM 2.7.8 o superior

Instalación de Plugin

  1. Dirígete https://github.com/TransbankDevelopers/transbank-plugin-opencart-webpay-rest/releases , y descargue la última versión disponible del plugin.

Una vez descargado el plugin, ingresa a la página de administración de Opencart (usualmente en misitio.com/admin), y dirígete a (Extensions / Intaller) indicado a continuación:

Paso 1

  1. Haz click sobre el botón [Upload], selecciona el archivo del plugin y Opencart procederá a instalar el plugin. Una vez finalizado, se te indicará que el módulo fue instalado:

Paso 2

Refrescar el sistema de modificaciones de OpenCart

  1. Dirígete a (Extensions / Modifications) y selecciona el plugin "Transbank Webpay" indicado a continuación:

Paso 3

  1. Con el plugin "Transbank Webpay" seleccionado presiona el botón "Refresh" save de la parte superior derecha.

OpenCart indicará que las modificaciones han sido exitosas sobre el plugin:

Paso 4

  1. Dentro del sitio de administración dirígete a (Extensions / Extensions) y filtra por "Payments".

Paso 5

  1. Busca hacia abajo el plugin "Webpay Plus".

Paso 6

  1. Presiona el botón verde "+" para instalar el plugin.

Paso 7

  1. Cambiará a color rojo.

Paso 8

Configuración

Este plugin posee un sitio de configuración que te permitirá ingresar credenciales que Transbank te otorgará, y además podrás generar un documento de diagnóstico en caso que Transbank te lo pida.

Para acceder a la configuración, debes seguir los siguientes pasos:

  1. Dirígete a la página de administración de Opencart (usualmente en misitio.cl/admin), y luego dirígete a (Extensions / Extensions) , filtra por "Payments", busca "Webpay Plus" y presiona el botón "Edit" del plugin:

Paso 8

  1. ¡Ya está! Estás en la pantalla de configuración del plugin, debes ingresar la siguiente información:
  • Estado: Habilita o deshabilita el plugin, debes habilitarlo para que funcione como medio de pago en tu comercio.
  • Ambiente: Ambiente hacia donde se realiza la transacción.
  • Código de comercio: Es lo que te identifica como comercio.
  • API Key: Código secreto de webpay que te autoriza y valida a hacer transacciones.

Las opciones disponibles para Ambiente son: "Integración" para realizar pruebas y certificar la instalación con Transbank, y "Producción" para hacer transacciones reales una vez que Transbank ha aprobado el comercio.

Configuración de los estados de la orden

Asegurate de configurar correctamente los estados de la orden según corresponda a tu comercio:

  • Estado completado: Estado de una orden exitosa.
  • Estado rechazado: Estado de una orden rechazada.
  • Estado cancelado: Estado de una orden cancelada.

Paso 9

Credenciales de Prueba

Para el ambiente de Integración, puedes utilizar las siguientes credenciales para realizar pruebas:

  • Código de comercio: 597055555532
  • API Key: 579B532A7440BB0C9079DED94D31EA1615BACEB56610332264630D42D0A36B1C

  1. Guardar los cambios presionando el botón [Guardar]

  2. Además, puedes generar un documento de diagnóstico en caso que Transbank te lo pida. Para ello, haz click en el botón "Información" ahí podrás descargar un pdf.

Paso 10

Prueba de instalación con transacción

En ambiente de integración es posible realizar una prueba de transacción utilizando un emulador de pagos online.

  • Ingresa al comercio y con la sesión iniciada, ingresa a cualquier sección para agregar productos

    demo1

  • Agrega al carro de compras un producto, selecciona el carro de compras y luego presiona el botón [Checkout]:

    demo2

  • Ingresa todos los datos requeridos:

    demo3

  • Selecciona método de pago "Pago con Tarjetas de Crédito o Redcompra":

    demo4

  • Presiona el botón [Continuar a Webpay]

    demo5

  • Una vez presionado el botón para iniciar la compra, se mostrará la ventana de pago Webpay y deberás seguir el proceso de pago.

Para pruebas puedes usar los siguientes datos:

  • Número de tarjeta: 4051885600446623
  • Rut: 11.111.111-1
  • Cvv: 123

demo6

demo7

Para pruebas puedes usar los siguientes datos:

  • Rut: 11.111.111-1
  • Clave: 123

demo8

Puedes aceptar o rechazar la transacción

demo9

  • Serás redirigido a Opencart y podrás comprobar que el pago ha sido exitoso.

demo11

  • Además si accedes al sitio de administración sección (Sales / Orders) se podrá ver la orden creada y el detalle de los datos entregados por Webpay.

order1

order2