README

Transbank Magento2 Webpay Plugin

Plugin oficial de Webpay para Magento2

Descripción

Este plugin oficial de Transbank te permite integrar Webpay fácilmente en tu sitio Magento2. Está desarrollado en base al SDK oficial de PHP

¿Cómo instalar?

Puedes ver las instrucciones de instalación y su documentación completa en transbankdevelopers.cl/plugin/magento/

Paso a producción

Al instalar el plugin, este vendrá configurado para funcionar en modo 'integración'(en el ambiente de pruebas de Transbank). Para poder operar con dinero real (ambiente de producción), debes:

Tener tu propio código de comercio. Si no lo tienes, solicita Webpay Plus en transbank.cl
Luego de finalizar tu integración debes generar tus credenciales (llave privada y llave pública) usando tu código de comercio.
Enviar esta planilla de integración a soporte@transbank.cl, junto con la llave pública (generada en el paso anterior) y tu logo (130x59 pixeles en formato GIF). Estos dos archivos deben ser incluidos como un link y no como adjuntos para evitar problemas en la entrega.
Cuando Transbank confirme que ha cargado tu certificado público y logo, debes entrar a la pantalla de configuración del plugin dentro de Prestashop y colocar tu código de comercio, llave privada, llave pública y poner el ambiente de 'Producción'.
Debes hacer una compra de $10 en el ambiente de producción para confirmar el correcto funcionamiento.

Puedes ver más información sobre este proceso en este link.

Desarrollo

A continuación, encontrarás información necesaria para el desarrollo de este plugin.

Dependencias

Requiere Composer

El plugin depende de las siguientes librerías:

transbank/transbank-sdk
tecnickcom/tcpdf

Nota

La versión del sdk de php se encuentra en el archivo composer.json
La versión del plugin se encuentra en los archivos composer.json y etc/module.xml
Recomendamos utilizar el docker de desarrollo si vas a modificar el código

Instalación

NOTA: El plugin se puede instalar de dos formas desde packagist.org o directamente desde el repositorio git.

Ir a la carpeta base de Magento2
[Opción 1] Ejecutar los siguientes comandos para instalar el plugin directamente desde packagist.org:
```
composer require transbank/webpay-magento2
```
Esperar mientras las dependencias son actualizadas.

[Opción 2] Ejecutar los siguientes comandos para instalar el plugin directamente desde git:

composer config repositories.transbankwebpay vcs https://github.com/TransbankDevelopers/transbank-plugin-magento2-webpay.git
composer require transbank/webpay-magento2:dev-master

Esperar mientras las dependencias son actualizadas.

Ejecutar los siguientes comandos para habilitar el modulo:

magento module:enable Transbank_Webpay --clear-static-content
magento setup:upgrade && magento setup:di:compile && magento setup:static-content:deploy

Habilitar y configurar el plugin Webpay en la sección de administración de magento2 bajo Stores/Configuration/Payment Methods/Webpay
Configurar los certificados necesarios para que funcione el plugin de Webpay.

Actualización

Ir a la carpeta base de Magento2
Ejecutar los siguientes comandos para actualizar el plugin

magento module:disable Transbank_Webpay --clear-static-content
composer update
magento module:enable Transbank_Webpay --clear-static-content
magento setup:upgrade && magento setup:di:compile && magento setup:static-content:deploy

Otras Notas

Webpay solo trabaja con CLP! Si CLP no es tu moneda principal, no podrás usar este plugin en el proceso de checkout. Esto se encuentra en duro en payment model

Si no sabes como realizar esta configuracion puedes verlo en este documento

Reinstalación

Ir a la carpeta base de Magento2
Ejecutar los siguientes comandos para deshabilitar y eliminar el plugin:

magento module:disable Transbank_Webpay --clear-static-content
composer remove transbank/webpay-magento2:dev-master
rm -rf vendor/transbank/webpay*
rm -rf app/code/Transbank/Webpay*

Seguir el proceso de instalación descrito anteriormente.

Ambiente de Desarrollo

Para apoyar el levantamiento rápido de un ambiente de desarrollo, hemos creado la especificación de contenedores a través de Docker Compose.

Para usarlo seguir el siguiente README Magento 2

Crear el instalador del plugin

./package.sh

Para generar una nueva versión, se debe crear un PR (con un título "Prepare release X.Y.Z" con los valores que correspondan para X, Y y Z). Se debe seguir el estándar semver para determinar si se incrementa el valor de X (si hay cambios no retrocompatibles), Y (para mejoras retrocompatibles) o Z (si sólo hubo correcciones a bugs).

En ese PR deben incluirse los siguientes cambios:

Modificar el archivo CHANGELOG.md para incluir una nueva entrada (al comienzo) para X.Y.Z que explique en español los cambios.
Modificar el archivo etc/module.xml y cambiar el valor de setup_version por el X.Y.Z nuevo.

Luego de obtener aprobación del pull request, debes mezclar a master e inmediatamente generar un release en GitHub con el tag vX.Y.Z. En la descripción del release debes poner lo mismo que agregaste al changelog.

Con eso Travis CI generará automáticamente una nueva versión del plugin y actualizará el Release de Github con el zip del plugin.

transbank / webpay-magento2

Maintainers

Details