[Tutorial - Webpay] Instalar y Configurar Módulo Webpay para Drupal 7

El comercio electrónico en Chile cada vez toma más fuerza y para muchas tiendas es primordial contar con un comercio que tenga elementos diferenciadores que los distinga claramente de sus competencia entregándole una ventaja competitiva. Específicamente esto es lo que permite Drupal junto con dos alternativas (módulos) para generar un verdadero e-commerce, hablo de Ubercart y de Drupal Commerce. De todas sus características, ambos pueden habilitar distintos métodos de pago, pero hasta hace muy poco solo estaban disponibles los más usados internacionalmente. En cambio en Chile, lo más usado es Webpay de Transbank y su integración puede llegar a ser algo complejo, es por eso que nace Webpay API, un módulo que centraliza las funcionalidades de comunicación entre el sistema de pago con nuestro sitio en Drupal para luego facilitar la integración con cualquier módulo de comercio, ya sea con alguno de los dos que ya he mencionado u otro sistema personalizado.

Objetivo del Tutorial

Este tutorial tiene como objetivo dejar funcionando Webpay en nuestro sitio, asegurándonos solo si existe conexión en todo el proceso de pago en el ambiente de certificación. En el próximo tutorial se especificará como configurar Ubercart y Drupal Commerce para operar con este método de pago, sin embargo es primordial este primer paso.

Requerimientos

• Descargar el Kit de Conexión de Comercio (KCC).
• Instalar en Drupal el módulo Webpay API, el cual incluye un sub módulo para hacer pruebas de conexión.

Recomendaciones/Configuraciones Apache y PHP

Para que el sistema de KCC pueda operar sin problemas en el servidor del comercio, se necesita tener en cuenta que algunos parámetros de Apache y de PHP deben estar deshabilitados, en caso contrario puede no haber conexión con Webpay. Los parámetros son:

• mod_security de Apache *Si requieren contar con dicho módulo de apache, deberán configurar una regla para que haya conexión entre el KCC y la página de cierre la cual es http://misitio.com/?q=webpay/close/(CLP|USD). No he tenido experiencia con ello, si alguien cuenta con dicha información, se le agradecería si la pudiera compartir. EDIT: Mod_Security y Webpay
• safe_mode de PHP

Importante

El servidor debe ejecutar programas CGI.

Tu sitio debe ser accesible desde internet. Si estas probando en tu local (ej: http://localhost) difícil le será a Webpay encontrar tu sitio, por lo que fallará en el proceso.

Permisos de escritura

La documentación de Transbank define los permisos que deben tener cada archivo del sistema de KCC, adicionalmente, Apache debe contar con permisos de escritura sobre el archivo datos/tbk_config.dat, esto para configurar sus parámetros desde la administración de Drupal, si por algún motivo Apache no tiene permisos, el sistema generará el archivo para reemplazarlo en la carpeta correspondiente.

Instalando y Comprobando que KCC esta andando en mi Servidor

Antes de empezar a trabajar con Drupal, debemos asegurarnos de que el sistema de KCC esta bien instalado y operando en nuestro servidor, para ello debemos crear una carpeta (recomendado en la raiz de Drupal) que se llame "cgi-bin" (es como lo más común, muchos hosting dejan establecido dicha carpeta en la raíz de los sitios para ejecutar programas cgi.). Aquí podemos pegar todos los archivos y carpetas del KCC, a continuación como se vería: Una vez que este hecho y los permisos bien dados, haremos un prueba accediendo a tbk_bp_pago.cgi por el browser, por ejemplo entrando a http://misitio.com/cgi-bin/tbk_bp_pago.cgi, debería aparecer esto: Si no te aparece esto, entonces debes configurar adecuadamente Apache.

Habilitando y Configurando el módulo Webpay API

Ya teniendo el KCC operando en nuestro sitio, podremos empezar a trabajar en Drupal. Descargamos e instalamos el módulo Webpay, pueden hacerlo con drush. drush dl webpay drush en webpay

Luego vamos a la página de configuración, podemos acceder desde /admin/config/webpay, veremos las siguientes opciones:

Primero debemos decirle a Drupal donde esta nuestro KCC y que datos debería tener nuestro archivo tbk_config.dat, entramos a la segunda opción (KCC Settings):

Como se ve en la imagen, existen secciones para la moneda chilena y para la del dolar ¿Por qué? Webpay permite que un sitio pueda operar con moneda nacional o con dolares, sin embargo no pueden operar al mismo tiempo en una misma configuración, ya que ambos usan distintos códigos, en otras palabras, si necesitan operar con las dos opciones, tendrán que tener instalado dos KCC en sus servidores, exactamente iguales, el único archivo que cambiará será el tbk_config.dat y se generarán otros archivos en la carpeta logs. Especificamente podríamos tener adentro de la carpeta cgi-bin, dos sub carpetas, una que se llame clp y otra usd, y en cada una de ellas un KCC completo. En esta oportunidad solo vamos a trabajar con CLP, así que configuraremos dicha sección solamente.

Por defecto, solo bastaría con definir la ruta del KCC, en este caso en cgi-bin, los otros datos ya vienen definidos para operar en certificación. Ahora vamos a la sección de arriba (General Data):

Aquí lo único que debemos completar sería la IP de nuestro sitio y el puerto con el que este opera, normalmente es 80, pero nunca se sabe. Otro detalle podría ser la extensión del check_mac, ya que si usan Linux debe ser *.cgi pero si están en Windows, entonces deben seleccionar la extensión *.exe. Listo, con todo esto ya dado le damos en guardar, aquí es donde el sistema generará el archivo tbk_config.dat e intentará reemplazarlo en la carpeta datos del KCC, avisará si pudo o no, en caso contrario se dispondrá un link con el archivo generado para que puedas descargarlo y luego reemplazarlo manualmente, en este ejemplo quedaría algo así:

Probando Conexión

Para probar la conexión podemos instalar el módulo Webpay Test, el cual viene incluido en Webpay API, simplemente se habilita. Pueden comprobar en /admin/config/webpay/configure-basic si el sistema de Prueba esta habilitado para operar con Webpay, debería aparecer esto:

(Aquí mismo deberán estar Ubercart o Drupal Commerce cuando se integren con Webpay API.) Desde aquí menciona a que link se debe ir para probar la conexión, entrando a http://misitio.com/webpay-test. Entramos a la opción de probarlo en CLP y nos mostrará los datos que se enviará a Webpay:

Simplemente hacemos click sobre Go to Webpay, si todo esta bien, debería redirigirnos a la siguiente página:

Si les dio un error, pueden ir a ver en la carpeta log del KCC, aquí buscan el archivo TBK_EVNyyyymmdd.log para ver que sucedio. Normalmente puede ser error de las llaves, adjunto las llaves en modo de certificación que use:

privada.pem

tbk_public_key.pem

En la documentación de Webpay tienen los número de tarjetas que pueden usar de prueba. Una que asegura el éxito en la compra y otro que simula el fracaso. En el siguiente tutorial se verá el como integrar Ubercart y Drupal Commerce.

Consideraciones para la Certificación con Transbank

Para certificarse con Transbank, existe una serie de elementos que debe contar el comercio, la mayoría de ellos ya están abordados con el módulo, pero debemos configurar algunas cosas. Esto se configuran en la página de configuración básica de Webpay (admin/config/webpay/configure-basic), aquí deben:

• Ingresar el link en donde hablan de las devoluciones.
• Tener desactivado la opción "Active Access Restriction" para que puedan hacer pruebas en la página de cierre. Después, cuando estén en producción, la activan.