Este plugin ha sido deprecado y reemplazado por la nueva versión REST de Webpay Plus. Puedes encontrar el nuevo plugin acá: https://github.com/TransbankDevelopers/transbank-plugin-woocommerce-webpay-rest
Si aún usas esta versión (SOAP) del plugin, te recomendamos cambiar lo antes posible, ya que este plugin no recibirá nuevas actualizaciones, ni mejoras. Adicionalmente, dejará de funcionar el 01 de Julio de 2022.
Deprecado: Plugin oficial de Webpay para WooCommerce
Este plugin oficial de Transbank te permite integrar Webpay fácilmente en tu sitio WooCommerce. Está desarrollado en base al SDK oficial de PHP
Puedes ver las instrucciones de instalación y su documentación completa en la página de Transbank Developers
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).
- Cuando Transbank confirme que ha cargado tu certificado público y logo, debes entrar a la pantalla de configuración del plugin dentro de WooCommerce 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.
A continuación, encontrarás información necesaria para el desarrollo de este plugin.
- PHP 5.6 o superior
- Woocommerce 3.4 o superior
El plugin depende de las siguientes librerías:
- transbank/transbank-sdk
- tecnickcom/tcpdf
- apache/log4php
Para cumplir estas dependencias, debes instalar Composer, e instalarlas con el comando composer install.
- La versión del sdk de php se encuentra en el archivo composer.json
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 testear los ejemplos estos estan disponibles en:
- WooCommerce 3.4.0 con php 5.6
- WooCommerce 3.4.0 con php 7.1
- WooCommerce 3.6.3 con php 7.2
- WooCommerce 3.9.1 con php 7.3
- WooCommerce 3.9.1 con php 7.4
Si necesitas subir el plugin a Woocommerce y obtienes un error por que no se puede mover el archivo a wp-contentent entonces ejecuta
docker-compose run webserver chmod -Rv 767 wp-content/Para actualizar la versión del SDK de Transbank se debe editar el archivo composer.json y cambiar
el valor de la propiedad "transbank/transbank-sdk" por la versión que se desea instalar y luego ejecutar el bash update
que esta en la carpeta docker-woocommerce-php* lo que actualizara la dependencia 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.mdpara incluir una nueva entrada (al comienzo) paraX.Y.Zque explique en español los cambios.
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.