MANUAL DE INTEGRACIÓN

PLUGIN PRESTASHOP
VERSIÓN 1.0
 TABLA DE CONTENIDO

1. REQUERIMIENTOS

2. INSTALACIÓN DEL PLUGIN Y CONFIGURACIÓN

3. PRUEBA DE PAGO Y PASO A PRODUCCIÓN

4. NOTAS Y ACLARACIONES
 1. REQUERIMIENTOS

El plugin esta desarrollado para la versión 1.3 de prestashop que se puede descargar de:

http://www.prestashop.com/es/

Los requerimientos para prestashop son:

S.O. Linux, UNIX o Windows

Servidor Web Apache o similar
PHP 5.0 * o posterior
MySQL 5** o posterior

* Algunas versiones de PHP 5 presentan errores que impiden el funcionamiento correcto de

PrestaShop:

PHP 5.2.1 PHP 5.2.1 (Autenticación imposible)

PHP 5.2.6 la autentificación es imposible con un servidor por debajo de 64bits
PHP 5.2.9 (image management/upload broken)
PHP < 5.2 PHP < 5.2 (Zona y fecha horaria no válida)

** PrestaShop funciona desde MySQL 4.1.14 hasta la versión 5.0 pero algunas características
pueden no funcionar (p.e. la duplicación de productos) o puede tener comportamientos extraños.

Figura 1: Pantalla principal del instalador de prestashop.

 2. INSTALACIÓN Y CONFIGURACIÓN DEL PLUGIN

Una vez la tienda se ha instalado, los pasos para instalar el plugin son:

2.1. CARGA DEL PLUGIN

A través de un cliente FTP (p.e. filezilla) cargue la carpeta del plugin (pagosonline) en la ruta:

raiz/modules/

Figura 2: Carga del plugin por FTP

2.2. DIVISAS

Verifique que las divisas admitidas para su tienda, estén disponibles en el sistema de Pagosonline y
el código ISO corresponda con el que se maneja en prestashop:

Código ISO-4217 Divisa

COP Pesos Colombianos

EUR Euros
GBP Libras Esterlinas
MXN Pesos Mexicanos
USD U.S. Dolar
VEB Bolívares Fuertes

Tabla 1: Divisas soportadas por Pagosonline.net y códigos ISO-4217 respectivos de las divisas para las
transacciones.
Por lo tanto en el back-office del prestashop verifique en la pestaña Pago->Divisas

Allí agregue la moneda correspondiente a Pesos Colombianos como lo indica la imagen:

La tasa de conversión aplica para la moneda principal. En este caso la conversión se hizo de acuerdo
a la TRM frente a la tasa con la moneda Euro.

El listado de divisas quedaría así:

 Nota: Verifique que el código ISO corresponde al de la tabla 1

2.3. MODIFICACIÓN DEL ARCHIVO

En la ruta raiz/config/ se encuentra el archivo defines.inc.php

modifique el archivo defines.inc.php. Busque los estados de las órdenes:

/* Order states */

Y allí busque la línea del último estado que probablemente sea:

 define('_PS_OS_PAYPAL_', 11);

Coloque debajo la siguiente línea:

define('_PS_OS_PAGOSONLINE_', 12);

si hay otro define se debe colocar el número consecutivo. Guarde el archivo y cárguelo en la
respectiva carpeta del servidor.

2.4. INSTALACIÓN Y CONFIGURACIÓN DEL PLUGIN

Si se realizó correctamente el punto 2.1., al dar clic en la pestaña Modules sección Payment
aparecerá Pagosonline como se ve en la imagen:

De clic en instalar y le saldrá esta imagen:

En seguida es necesario configurar el plugin. En la misma pestaña busque el modulo de Pagosonline

y de clic en Configurar.
 - llaveEncripcion: La llave de encripción se encuentra en el panel administrativo de Pagosonline
en la pestaña Opciones.

- Usuario Id: Es el número de usuario dado automáticamente por el sistema de Pagosonline.

Esta información la encontrará en el correo de creación de su cuenta.

- Prueba: El sistema permite realizar pruebas con número de tarjetas de pruebas. Para hacer
pruebas, le recomendamos enviar la información al gateway2

- Account Gateway: Es el Gateway de la aplicación de Pagosonline:

Producción: https://gateway.pagosonline.net/apps/gateway/index.html

Pruebas: https://gateway2.pagosonline.net/apps/gateway/index.html

Una vez haya configurado y grabado los cambios se mostrará una pantalla como esta:
En seguida es necesario que vaya a la pestaña Pedidos-> Estados. Allí debe agregar un nuevo
estado:

Una vez allí se desplegara el siguiente formulario:

Coloque los siguientes datos:

- Nombre del estado:

o Español: Espera confirmación Pagosonline

o Inglés: Waiting payment in Pagosonline

o Francés: Paiement en attente Pagosonline

- Ícono: Cargue la imagen logo.gif que se encuentra dentro de la carpeta del módulo de
Pagosonline

- Color: #F2C11A
 - Las casillas debajo de la opción de color se deben ajustar a las necesidades de su tienda.

Una vez guarde el estado podrá ver el listado de los mismos algo así:

Nota importante: Una vez el pago sea procesado y el sistema de pagosonline envíe la página de
confirmación, el estado del pedido cambiará automáticamente a:

2. Pago Aceptamos (Transacción aprobada)

6. Cancelada (Transacción rechazada, declinada o cancelada)

 3. PRUEBA DE PAGO Y PASO A PRODUCCIÓN

Para realizar pruebas, en la configuración del plugin seleccione la variable prueba en si y coloque
como gateway:

https://gateway2.pagosonline.net/apps/gateway/index.html

Luego vaya a la tienda y realice el pago como normalmente lo haría. Si desea saber como hacer
pruebas, por favor remítase al Manual de Integración Tradicional de Pagosonline y utilice como guía
el capítulo 8.

Cada pedido que se genera, usted le puede hacer seguimiento en el back-office:

 4. NOTAS Y ACLARACIONES

- Pagosonline no se hace responsable por la utilización de este plugin. Es deber del comercio
verificar que se cumplen los requisitos de seguridad y configuración. Es responsabilidad total
del comercio la utilización del mismo.

- Por seguridad, le recomendamos verificar en el panel administrativo el resultado de la

transacción.

- No es obligación de Pagosonline prestar servicio de soporte sobre la tienda, únicamente sobre

el plugin de conexión sobre la versión mencionada en el primer capítulo.