Contenido

TABLA DE CONTENIDO

Implementar Pagosonline.net a su carrito de compras ZenCart

Versión 3

Última actualización: Septiembre de 2009

Copyright 2009 (C) Pagosonline.net S.A

TABLA DE CONTENIDO

1. INTRODUCCIÓN2. INSTALACIÓN DE ZENCART3. INSTALACIÓN PLUGIN PAGOSONLINE.NET

1. INTRODUCCIÓN

El e-commerce ZenCart permite crear una tienda virtual administrable, para la gestión de catalogos y pedidos. Esta guia contiene la información necesaria para la instalación y puesta en funcionamiento del e-commerce asi como la confiuración del plugin para trabajar con pagosonline.net y proveer a sus clientes los medios de pago electrónico que maneja nuestra plataforma.

2. INSTALACIÓN ZENCART

Para instalar el carrito de compras descargue los archivos necesarios del sitio web http://www.zen-cart.com/index.php. Una vez tenga estos archivos siga los siguientes pasos:

a) en un explorador abra el root del sitio web en donde coloco los archivos previamente descargados. Si todo esta correcto se mostrará la siguiente pantalla.

b) Presionar sobre el link “zc_install/index.php via your browser” instalación via el explorador web. Este link me dirige al instalador del carrito en donde se debe aceptar los terminos y condiciones.

c) Precionar continuar en donde el instalador realizará una verificación de los pre requicitos de sistema. Si todo esta correcto, procedemos a precionar el botón “install” lo cual muestra la siguiente pantalla.

d) En la aterior pantalla configurar

• Database type: Mysql o Posgres según tengamos instaldo en nuestro servidor

• Database host: dominio o dirección ip del servidor de la base de datos• Database Username: usuario de la base de datos• Database Password: contraseña de usuario de base de datos• Database name: nombre de la base de datos

e) Luego de configurar estos parámetros, solicitará información del sistema como path, url y dominio. Por lo general el instalador detecta esta configuración, verifiquelos y presione “save system settings”

f) Luego de esto le dará la opción de usar phpBB Forum (Componente que instala un foro en la tienda), seleccione la opción que prefiera y presione el botón “save phpBB Settings”

g) Configure la información de la tienda

Nombre, propietario, email, pais, zona, direccion, lenguaje y moneda de la tienda.

h) Confire la información del administrador

i) Por último aparecerá la pantalla de finalización correcta de la instalación

j) es posible que al dirigirse al front-end se obtengan dos advertencias. Una informando que es necesario remover el directorio zc_install, y otra informando riesgo, por que el archivo /includes/configure.php tiene permisos de escritura. Par resolver esto puede cambiar el nombre de la carpeta zc_install y cambiar los permisos del archivo configre.php a 644.

3. INSTALACIÓN PLUGIN PAGOSONLINE.NET

Para la instalación del plugin de pagosonlien.net siga los siguientes pasos:

a) Descomprima el archivo zencartPOL.zipb) Coloque todos los archivos incluidos en el zip en su sitio en los directorios

correspondientes.c) Vaya a la parte administrativa del carrito de compras ZenCart, diríjase al a

Modulos -> Pago del menú superior y dé click en la imagen de PagosOnline y luego en la parte derecha dar click en el botón Instalar.

d) personalice los campos con los datos dados por PagosOnline en el momento de la creación de su cuenta:

El ID Comercio es el ID o Número de usuario que es generado por el sistema de PagosOnline en el momento que se creo su cuenta y es enviado en el correo de confirmación de la creación de su cuenta, si no tiene acceso a ese correo comuníquese con nosotros y pregunte por él. En el campo Clave de Encriptación actualice la clave secreta para generar la

firma digital, esta llave la puede encontrar ingresando por su modulo administrativo de pagosonline en https://secure.pagosonline.net de acuerdo al Usuario y clave enviados al correo a usted en el momento de crear la cuenta, en la pestaña "Opciones", la clave de encripción es una cadena alfanumerica por ejemplo: = "1a1b1c1d1".

El campo URL de la pasarela por defecto esta apuntando al servidor en producción de la pasarela, no es necesario cambiarlo.

Si desea generar transacciones de prueba deje el campo Prueba en 1, por default se encuentra en 1 que significa que la transacción no se tomara como real, al realizar una transacción de prueba por favor verifique que al entrar a pagar en pagosonline, aparezca el siguiente mensaje en recuadro amarillo "Transacción en modo de prueba"

Después siga los pasos mencionados en el manual de integración para la parte de pruebas al llenar los datos del formulario de las tarjetas de crédito.

e) En la línea 63 del archivo includes\modules\payment\pagosonline.php aparece la variable $this->tasa_iva para parametrizar el valor del impuesto que por default aparece en 0.16 que es el impuesto manejado en Colombia, este valor debe concordar con el impuesto parametrizado en la tienda de zencart, a continuación una breve descripción de como debería quedar configurada la parte de impuestos en la tienda:

• Vaya a "Zonas/Impuestos"->"Zonas de Impuestos" y agregue una nueva zona y colóquele "Colombia" en el nombre, la descripción no es necesaria.

• Dentro de la zona creada es necesario agregar una sub-Zona con la siguiente informacion: Pais->Colombia, Zona->Todas las zonas

• En esa misma seccion vaya a "Tipos de Impuestos" y agregue un nuevo tipo, en el nombre coloquele IVA, la descripción no es necesaria.

• En la misma seccion vaya a "Impuestos" y agregue un nuevo impuesto, verifique que en el nombre del Porcentaje aparezca IVA seleccionado, en Zona que aparezca Colombia seleccionada, en Porcentaje colóquele 16, Descripción puede colocar IVA 16% y en prioridad colóquele 1.

NOTA : El plugin depende de que esta configuración quede perfecta así que asegúrese que todos los datos son correctos, además solo tiene soporte para impuesto colombiano IVA, asi que si desea agregar un nuevo impuesto para otro país de todos modos el plugin aplicara la tasa especificada en el campo tasa_iva para pagosonline.

f) En el momento solo se están recibiendo pagos en dólares, pesos, y euros así que es necesario configurar estas dos monedas, ingrese al modulo administrativo del ZenCart en la sección "Localizacion" y de click en "Monedas", si no se encuentra alguna de las dos es necesario crearlas, acto seguido verificar que queden al menos con los siguientes datos:

NOTA: ZenCart fija la moneda que usan los valores dentro del administrador a la hora de adicionar productos de acuerdo a la configuración de las mismas, es decir si usted va a colocar los precios de los productos en pesos, entonces el valor que debe ser configurado a la moneda PESOS debe ser 1, y el calculo de los valores para las demás monedas se debe hacer simplemente dividiendo 1 sobre la TRM del día.

EJ:Para dolar : 1 / 2300 = 0.0004347826Para euro : 1 / 2800 = 0.0003571428

* EurosCodigo : EUR

Valor : Hacer la conversión de 1 euro a pesos según la tasa de cambio a la fecha ( ej : 2800 )

Lugares decimales : 2

* DolaresCodigo : USD

Valor : Hacer la conversión de 1 dolar a pesos según la tasa de cambio a la fecha ( ej : 2300 )

Lugares decimales : 2

* Pesos Colombianos Codigo : COP Valor : 1

Lugares decimales : 2

g) En el modulo administrativo, elija la opción Localización y haga click en el menú Estado Pedido haga click en el botón insertar e ingrese los siguientes estados de pedidos:

• English : Incomplete Español : Incompleto Deutsch : Unvollständig

• English : Approved Español : Aprobado Deutsch : Anerkannt

• English : Cancelled Español : Cancelado Deutsch : Annulliert

• English : Rejected Español : Rechazado Deutsch : Zurückgewiesen

NOTA: estados especificados en el idioma español no pueden ser cambiados, en los otros idiomas si puede cambiarlos.