Skip to content

Latest commit

 

History

History
143 lines (81 loc) · 5.2 KB

File metadata and controls

143 lines (81 loc) · 5.2 KB

Manual de instalación para Plugin Virtuemart

Descripción

Este plugin oficial ha sido creado para que puedas integrar Webpay fácilmente en tu comercio, basado en Virtuemart. Esta versión utiliza un API REST para comunicarse con transbank.

Requisitos

Debes tener instalado previamente Virtuemart.

Habilitar los siguientes módulos / extensiones para PHP:

  • ext-curl
  • ext-json
  • ext-mbstring
  • OpenSSL 1.0.1 o superior
  • DOM 2.7.8 o superior

Instalación de Plugin

  1. Si tienes la versión anterior del plugin, entonces debes desinstalarlo antes de comenzar con este proceso de instalación. Puedes eliminar el módulo anterior en 'Extensions > Manage > Manage'. Selecciona el módulo 'Transbank Webpay' y haz click sobre 'Uninstall'.

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

Una vez descargado el plugin, ingresa a la página de administración de VirtueMart (usualmente en http://misitio.com/administrator, http://localhost/administrator) y dirígete a (Extensions / Manage / Install), indicado a continuación:

Paso 1

  1. Arrastra o selecciona el archivo que descargaste en el paso anterior. Al finalizar aparecerá que fue instalado exitosamente.

Paso 2

Paso 3

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.

IMPORTANTE: El plugin solamente funciona con moneda chilena (CLP). Dado esto VirtueMart debe estar configurado con moneda Peso Chileno y país Chile para que se pueda usar Webpay.

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

  1. Dirígete a la página de administración de VirtueMart (usualmente en http://misitio.com/administrator, http://localhost/administrator) e ingresa usuario y clave.

  2. Dentro del sitio de administración dirígete a (VirtueMart / Payment Methods).

Paso 4

  1. Debes crear un nuevo medio de pago presionando el botón [New].

Paso 5

  1. Ingresar los datos para "Transbank Webpay" como se muestra en la siguiente imagen.

    • Payment Name: Transbank Webpay
    • Sef Alias: transbank_webpay_rest
    • Published: Yes
    • Payment Method: Transbank Webpay
    • Currency: Chilean peso

Paso 6

  1. Presiona el botón [Save] para guardar el nuevo medio de pago. Se informará que ha sido guardado.

Paso 7

  1. Selecciona la sección "Configuration" para configurar el plugin.

Paso 8

  1. ¡Ya está! Estás en la pantalla de configuración del plugin, debes ingresar la siguiente información:
  • Ambiente: Ambiente hacia donde se realiza la transacción.
  • Código de comercio: Es lo que te identifica como comercio.
  • API KEY: Llave que te entregará Transbank que autentifica la comunicación con Transbank.

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.

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 9

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

    demo1

  • Ya con la sesión iniciada, ingresa a cualquier sección para agregar productos

    demo2

  • Agrega al carro de compras un producto, selecciona el carro de compras y selecciona Transbank Webpay, selecciona términos de servicio y luego presiona el botón [Confirm Purchase]:

    demo3

  • 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

demo4

demo5

Para pruebas puedes usar los siguientes datos:

  • Rut: 11.111.111-1
  • Clave: 123

demo6

Puedes aceptar o rechazar la transacción

demo7

demo8

demo9

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

demo10

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

order1

order2