Skip to content

Latest commit

 

History

History
175 lines (94 loc) · 5.92 KB

INSTALLATION.md

File metadata and controls

175 lines (94 loc) · 5.92 KB

Manual de instalación para Plugin Magento2

Descripción

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

Requisitos

  1. Debes tener instalado previamente Magento2 y asegurarte de tener Composer instalado.
  2. Tus credenciales de Magento Market a mano. Si no sabes cuales son tus credenciales puedes revisar esta guia: https://devdocs.magento.com/guides/v2.2/install-gde/prereq/connect-auth.html

Habilitar los siguientes módulos / extensiones para PHP:

  • OpenSSL 1.0.1 o superior
  • SimpleXML
  • DOM 2.7.8 o superior

Instalación del Plugin

Nota: En este punto composer podría pedirte si lo requiere tus credenciales de magento2.

Versiones disponibles Aquí

En tu directorio de Magento2, ejecutar el siguiente comando para instalar la última versión:

`composer require transbank/webpay-magento2-rest`

Cuando finalice, ejecutar el comando:

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

paso8

Cuando finalice, ejecutar el comando:

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

paso9

Una vez realizado el proceso anterior, Magento2 debe haber instalado el plugin Webpay. Cuando finalice, debes activar el plugin en el administrador de Magento2.

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 Magento2 (usualmente en http://misitio.com/admin, http://localhost/admin) e ingresa usuario y clave.

paso10

  1. Dentro del sitio de administración dirígete a (Stores / Configuration).

paso11

  1. Luego a sección (Sales / Payments Methods).

paso12

  1. Elegir el país Chile

paso13

  1. Bajando al listado de métodos de pagos verás Webpay

paso14

  1. ¡Ya está! Estás en la pantalla de configuración del plugin, debes ingresar la siguiente información:
  • Habilitado: Al activarlo, Webpay estará disponible como medio de pago. Ten la precaución de que se encuentre marcada esta opción cuando quieras que los usuarios paguen con Webpay.
  • Ambiente: Ambiente hacia donde se realiza la transacción.
  • Código de comercio: Es lo que te identifica como comercio.
  • API Key: Es tu clave para acceder a los servicios REST de Webpay.

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
  • Llave Privada: 579B532A7440BB0C9079DED94D31EA1615BACEB56610332264630D42D0A36B1C
  1. Guardar los cambios presionando el botón [Save Config]

paso15

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

paso17

Configuración de Magento2 para CLP

El plugin solamente funciona con moneda chilena CLP dado esto Magento 2 debe estar correctamente configurado para que que se pueda usar Webpay.

  1. Ir a la sección de administración (Stores / General / Country Option) y elegir Chile tal como se muestra en la siguiente imagen, luego guardar los cambios.

clp1

  1. Ir a la sección de administración (Stores / Currency Setup / Country Option) y elegir Chile tal como se muestra en la siguiente imagen, luego guardar los cambios.

clp2

  1. Ir a la sección de administración (Stores / Currency) y verificar en las dos secciones (Currency Rates y Currency Symbols) que CLP se encuentre activo.

clp3

clp4

clp5

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:

    demo3

  • Selecciona el carro de compras y luego presiona el botón [Proceed to Checkout]:

    demo4

  • Selecciona método de envío y presiona el botón [Next]

    Debes asegurarte que tu dirección de envio sea en Chile.

    demo5

  • Selecciona método de pago Transbank Webpay, luego presiona el botón [Place Order]

    demo6

  • 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

demo7

demo8

Para pruebas puedes usar los siguientes datos:

  • Rut: 11.111.111-1
  • Clave: 123

demo9

Puedes aceptar o rechazar la transacción

demo10

demo11

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

demo13

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

order1

order2

order3