Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

download Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

of 23

Transcript of Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    1/23

    Gua para integrar PagosOnLine con PrestaShop.

    VERSION 2.0

    Mayo 2011

    Ing. Diego Armando Zarate.Ing. Ana Fernanda Parra E.

    MMaa nn uu aa ll DDee CCaa rr rr iittoo DDee CCoo mm pp rraa ss PP rree ss ttaa SS hh oop

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    2/23

    PagosOnLine S.A. Bogot D.C.PBX. (1) 576 3126FAX. (1) 6161540www.pagosonline.com e-mail: [email protected]

    2

    Tabla de contenido

    Introduccin ........................................................................................................................................ 3

    Prerrequisitos integracin con PagosOnLine en Prestashop .............................................................. 4Versiones Compatibles Con PrestaShop ............................................................................................. 7

    Instalacin de PrestaShop ................................................................................................................... 8

    Instalacin Y Configuracin Del Plugin De PagosOnLine ................................................................... 12

    Como realizar pruebas de pagos ....................................................................................................... 19

    Como revisar las transacciones en nuestro sistema y los pedidos en Prestashop ........................... 21

    Como pasar a produccin ................................................................................................................. 23

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    3/23

    PagosOnLine S.A. Bogot D.C.PBX. (1) 576 3126FAX. (1) 6161540www.pagosonline.com e-mail: [email protected]

    3

    Introduccin

    PrestaShop es un sitio web dinmico que permite la creacin de tiendas de comercio electrnico.

    El software PrestaShop se distingue de otros por la simplicidad de uso y la flexibilidad de su

    arquitectura que contiene variedad de aplicaciones. Esto es algo que resulta extremadamente

    atractivo para cualquier pequea y mediana empresa, interesada en vender por Internet.

    Para poder aceptar pagos con tarjeta dbito y crdito a travs de PagosOnLine, es necesario

    realizar una configuracin de manera que el medio de pago quede activo y sea capaz de

    conectarse con nuestro sistema transaccional. Esta gua le proporciona la informacin necesaria

    para implementar esta funcionalidad en su tienda PrestaShop.

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    4/23

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    5/23

    PagosOnLine S.A. Bogot D.C.PBX. (1) 576 3126FAX. (1) 6161540www.pagosonline.com e-mail: [email protected]

    5

    Al oprimir aqu podremos introducir los datos de ingreso que tenemos en el correo. El sistema nos

    pedir actualizar la contrasea. Para que esta nueva contrasea sea permitida debe cumplir unos

    requisitos mnimos, sabremos que los cumplimos cuando en la parte inferior del campo de texto

    haya una barra verde con la descripcin Fuerte . Por facilidad podemos agregarle a la contraseaque recibimos algunos caracteres. Ejemplos de claves validas teniendo en cuenta que la recibida

    en el correo fue X0GMILP$rnP$uo.

    X0GMILP$rnP$uo1

    X0GMILP$rnP$uoabc

    X0GMILP$rnP$uopruebas

    ABC!#abc123

    123!#ABCabc

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    6/23

    PagosOnLine S.A. Bogot D.C.PBX. (1) 576 3126FAX. (1) 6161540www.pagosonline.com e-mail: [email protected]

    6

    Una vez hayamos ingresado a este mdulo debemos entrar a la pestaa Opciones, donde

    podemos visualizar la llave de encripcin.

    Para ingresar al modulo administrativo en el ambiente pruebas https://secure2.pagosonline.net/ ,

    debe solicitar de nuevo una contrasea, la cual es diferente a la anterior. Esto le permitir revisar

    las transacciones realizadas en modo de prueba.

    https://secure.pagosonline.net/https://secure.pagosonline.net/https://secure.pagosonline.net/https://secure.pagosonline.net/
  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    7/23

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    8/23

    PagosOnLine S.A. Bogot D.C.PBX. (1) 576 3126FAX. (1) 6161540www.pagosonline.com e-mail: [email protected]

    8

    Instalacin de PrestaShop

    Despus de descargar y descomprimir el archivo correspondiente a PrestaShop, es necesario que

    suba los archivos a su hosting mediante un cliente FTP como FileZilla. Una vez haya terminado la

    transferencia de los archivos, cargue la ruta de la tienda en su navegador. Para este ejemplo se

    cre una carpeta prestashop en la raz de hosting:

    http://www.misitio.com/prestashop

    Seleccione el idioma que desea y de clic en siguiente.

    En la siguiente pantalla obtendr los resultados de un anlisis que se realiza por defecto a los

    permisos de los archivos. Si su configuracin es vlida de clic en siguiente; de lo contrario verifique

    los permisos de los archivos que le indique PrestaShop.

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    9/23

    PagosOnLine S.A. Bogot D.C.PBX. (1) 576 3126FAX. (1) 6161540www.pagosonline.com e-mail: [email protected]

    9

    A continuacin, se colocan los datos de la base de datos:

    Servidor de base de datos (normalmente localhost)

    Usuario (nombre del usuario de la base de datos)

    Password

    Nombre de la base de datos

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    10/23

    PagosOnLine S.A. Bogot D.C.PBX. (1) 576 3126FAX. (1) 6161540www.pagosonline.com e-mail: [email protected]

    10

    En la siguiente imagen debe configurar los datos principales de su tienda.

    Si todo termin bien, saldr el mensaje mostrando que PrestaShop est listo!

    Despus seleccione El BackOffice para administrar su tienda, y configurar los siguientes pasos. Es

    muy posible que obtenga la siguiente imagen; en la cual se advierte que no se puede continuar si

    no ha cambiado el nombre de la carpeta admin y no se ha eliminado la carpeta instalar. Recuerde

    que esto lo debe hacer directamente en su hosting mediante el cliente FTP.

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    11/23

    PagosOnLine S.A. Bogot D.C.PBX. (1) 576 3126FAX. (1) 6161540www.pagosonline.com e-mail: [email protected]

    11

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    12/23

    PagosOnLine S.A. Bogot D.C.PBX. (1) 576 3126FAX. (1) 6161540www.pagosonline.com e-mail: [email protected]

    12

    Instalacin Y Configuracin Del Plugin De PagosOnLine

    Despus de terminar de instalar la tienda PrestaShop, se contina con la instalacin del plugin, el

    cual lo puede encontrar en la siguiente URL:http://ayuda.pagosonline.com/index.php/manuales/carritosdecompras/prestashop

    CARGAR EL PLUGIN

    Usando un cliente FTP, suba la carpeta pagosonline del plugin en la ruta: raiz/modules/

    Carga del Plugin por FTP

    CONFIGURACIN DE LAS DIVISAS

    1. Ingrese en el administrador de su tienda PrestaShop.

    2. Debe verificar que las divisas admitidas en su tienda, estn disponibles en el sistema de

    PagosOnLine y el cdigo ISO corresponda con el que se maneja en PrestaShop. Para esto

    debe ingresar en el back office de PrestaShop, hacer clic en la pestaa Pago->Divisas

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    13/23

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    14/23

    PagosOnLine S.A. Bogot D.C.PBX. (1) 576 3126FAX. (1) 6161540www.pagosonline.com e-mail: [email protected]

    14

    Nota : Recuerde verificar que el cdigo ISO corresponde al de la tabla de divisas soportadas

    por PagosOnLine.

    MODIFICACIN DEL ARCHIVO

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

    2. Busque en este archivo (defines.inc.php) los estados de las rdenes (/* Order states */)

    y modifquelo de la siguiente forma:

    Busque la lnea del ltimo estado que probablemente ser:

    define('_PS_OS_PAYPAL_', 11);

    Agregue la siguiente lnea despus del ltimo estado:

    define('_PS_OS_PAGOSONLINE_', 12);

    Si hay otra lnea define se debe colocar el nmero consecutivo.

    Guarde el archivo y crguelo en la respectiva carpeta del servidor.

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    15/23

    PagosOnLine S.A. Bogot D.C.PBX. (1) 576 3126FAX. (1) 6161540www.pagosonline.com e-mail: [email protected]

    15

    INSTALACIN Y CONFIGURACIN DEL PLUGIN

    1. Si se realiz correctamente la carga del plugin al servidor FTP, entonces al dar clic en la

    pestaa Mdulos seccin Pago aparecer Pagosonline como se ve en la imagen:

    2. De clic en instalar y obtendr la siguiente imagen.

    3. Luego es necesario configurar el plugin. En la misma pestaa busque el modulo de

    PagosOnLine y de clic enConfigurar .

    4. En este paso debe tener presente los datos de su cuenta, como el usuario ID y la llave deencripcin. Luego complete los campos solicitados y de clic en Actualizar Configuracin,

    obteniendo como resultado la siguiente imagen:

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    16/23

    PagosOnLine S.A. Bogot D.C.PBX. (1) 576 3126FAX. (1) 6161540www.pagosonline.com e-mail: [email protected]

    16

    IMPORTANTE:

    El campo UsuarioId = 0000; debe cambiarlo por el nmero de usuario que se le asign

    cuando se registr con PagosOnLine.

    El campo llaveEncripcion = "0000000000000000"; debe cambiarlo por la llave para

    realizar encripciones que la encuentra en el modulo administrativo de PagosOnLine.

    En Prueba seleccione la opcin SI

    Account Gateway: Es el Gateway de la aplicacin de PagosOnLine, all debe colocar el

    siguiente link:

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

    5. En seguida es necesario que vaya a la pestaa Pedidos-> Estados. All debe agregar un

    nuevo estado:

    https://gateway2.pagosonline.net/apps/gateway/index.htmlhttps://gateway2.pagosonline.net/apps/gateway/index.htmlhttps://gateway2.pagosonline.net/apps/gateway/index.html
  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    17/23

    PagosOnLine S.A. Bogot D.C.PBX. (1) 576 3126FAX. (1) 6161540www.pagosonline.com e-mail: [email protected]

    17

    All obtendr el siguiente formulario:

    Complete el formulario con los siguientes datos:

    - Nombre del estado:

    Espaol: Espera confirmacin Pagosonline

    Ingls: Waiting payment in Pagosonline

    Francs: Paiement en attente Pagosonline- cono: Cargue la imagen logo.gif que se encuentra dentro de la carpeta del mdulo de

    PagosOnLine

    - Color: #F2C11A

    - Las casillas debajo de la opcin de color se deben ajustar a las necesidades de su tienda.

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    18/23

    PagosOnLine S.A. Bogot D.C.PBX. (1) 576 3126FAX. (1) 6161540www.pagosonline.com e-mail: [email protected]

    18

    6. Una vez guarde el estado podr ver el listado de los mismos algo como:

    Nota importante: Una vez el pago sea procesado y el sistema de PagosOnLine enve la

    pgina de confirmacin, el estado del pedido cambiar automticamente a:

    2. Pago Aceptamos (Transaccin aprobada)

    6. Cancelada (Transaccin rechazada, declinada o cancelada)

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    19/23

    PagosOnLine S.A. Bogot D.C.PBX. (1) 576 3126FAX. (1) 6161540www.pagosonline.com e-mail: [email protected]

    19

    Como realizar pruebas de pagos

    En este captulo veremos cmo realizar pruebas de pagos con las tarjetas de crdito y tarjetas decuentas corrientes. Despus confirmar el pedido en PrestaShop, entramos a la pasarela de pagos

    de la plataforma y all tendremos todos los medios de pago de PagosOnLine.

    Para realizar pruebas de pago con tarjetas de crdito podemos ingresar al logo de VISA y pararealizar pruebas de pagos con tarjetas de cuentas corriente podemos ingresar al logo de PSE.

    En el caso de escoger VISA tendremos el siguiente formulario.

    Se deben ingresar todos los datos, teniendo en cuenta que la fecha de expiracin de la tarjeta de

    crdito debe ser mayor a la fecha actual. Podemos usar las siguientes tarjetas de crdito y

    obtendremos los siguientes resultados.

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    20/23

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    21/23

    PagosOnLine S.A. Bogot D.C.PBX. (1) 576 3126FAX. (1) 6161540www.pagosonline.com e-mail: [email protected]

    21

    Como revisar las transacciones en nuestro sistema y los pedidosen PrestaShop

    EN EL SISTEMA DE PAGOSONLINE : Para este fin entraremos al mdulo administrativo en

    pruebas https://secure2.pagosonline.net/ ya que las pruebas se realizaron apuntando a

    https://gateway2.pagosonline.net/apps/gateway/index.html, en la pestaa transacciones,

    y en el link Reporte de transacciones, podremos diligenciar un formulario con los datos

    que estamos buscando. Las fechas son importantes ya que no deben superar a tres meses,

    es importante que seleccionemos la variable prueba en la bsqueda, ya que en la

    configuracin de la tienda se est enviando la variable prueba activa, es decir, en 1.

    https://secure2.pagosonline.net/https://secure2.pagosonline.net/https://gateway2.pagosonline.net/apps/gateway/index.htmlhttps://gateway2.pagosonline.net/apps/gateway/index.htmlhttps://secure2.pagosonline.net/
  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    22/23

    PagosOnLine S.A. Bogot D.C.PBX. (1) 576 3126FAX. (1) 6161540www.pagosonline.com e-mail: [email protected]

    22

    Cuando oprimimos buscar, en la parte inferior aparecer una serie de datos de todas las

    transacciones, si se desea mayor informacin de una en particular debemos darle clic a la

    transaccin deseada.

    Si deseamos un reporte mucho mayor debemos habilitar la opcin Detalle tem y oprimir

    en exportar a Excel.

    EN PRESTASHOP:A cada pedido que es generado, se le puede hacer seguimiento en el

    back-office; para esto, de clic en la pestaa pedidos:

  • 8/6/2019 Pagosonline_-_Manual_de_instalacion_plugin_Prestashop_V_2.0

    23/23

    PagosOnLine S A Bogot D C PBX (1) 576 3126FAX (1) 6161540

    Como pasar a produccin

    Luego de que se realizaron todas las pruebas del sistema y se verifica que todo est funcionando

    correctamente, podemos pasar a produccin. Para realizar esto, es necesario que este seguro que

    los datos de su cuenta estn en la configuracin de PagosOnLine en PrestaShop, es decir, que su

    llave de encripcin y su usuario Id sean los correctos.

    Realmente son pasos muy sencillos, primero ingrese de nuevo a la pestaa Mdulos y en la

    seccin Payment seleccione Pagosonline->Configurar, en este formulario se deben realizar los

    siguientes cambios:

    1. En la opcinPrueba seleccione NO.

    2. En el campo Account Gateway debe cambiar el link de la siguiente forma:

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

    Al realizar estos pasos de clic en Actualizar Configuracin, obteniendo la siguiente configuracin.

    IMPORTANTE:

    En el campo UsuarioId = 0000; debe estar configurado el nmero de usuario que le fue

    asignado cuando se registro con PagosOnLine.

    En el campo llaveEncripcion = "0000000000000000"; debe estar configurada la llave

    para realizar encripciones.

    Para revisar las transacciones realizadas en su sitio Web, debe ingresar al modulo administrativo

    https://secure.pagosonline.net/ y realizar los mismos pasos de la consulta de transacciones en el

    modo de prueba. Como en produccin no se enva la variable prueba en 1, entonces no seleccione

    la casilla prueba del formulario de consulta de transacciones.

    https://gateway.pagosonline.net/apps/gateway/index.htmlhttps://gateway.pagosonline.net/apps/gateway/index.htmlhttps://secure.pagosonline.net/https://secure.pagosonline.net/https://gateway.pagosonline.net/apps/gateway/index.html