Guía de Integración del Plug In de Pago Digital en VirtueMart Versión 1.0.0 1
ÍNDICE DE CONTENIDO 1. Objetivo... 3 2. Software necesario... 3 3. Pasos a seguir... 3 4. Pasos a seguir... 9 5. Código Generado... 10 6. Código Generado... 13 7. Tabla de Tarjetas de Prueba... 14 2
1. Objetivo En el presente documento se detalla el procedimiento básico para la integración del módulo de pago de Pago Digital en la tienda on-line VirtueMart versión 2.9.9.3.2. 2. Software necesario Para poder realizar el seguimiento de esta guía es necesario tener instalado los siguientes módulos: Joomla versión 3.3.6: Sistema de gestión de contenido. VirtueMart versión 2.9.9.3: Plug-in para la gestión de tiendas on-line en Joomla. Además deberemos tener descargado el módulo de pago de Pago Digital para VirtueMart. 3. Pasos a seguir Una vez descargado el módulo de Pago Digital se deben seguir los siguientes pasos: 1. Inicie sesión como administrador de su tienda online VirtueMart y diríjase al apartado de Extensiones y luego presione Gestor de Extensiones tal y como se muestra en la imagen: 3
2. Luego diríjase a la pestaña subir paquete, presione el botón Seleccionar Archivo y a continuación se desplegara una ventana para la búsqueda del archivo a subir, deberá ubicar el módulo de pago Pago Digital que previamente descargo y que tiene como extensión.zip, seleccione el archivo y presione aceptar, luego de que selecciona el archivo debe presionar el botón Subir e Instalar, tal y como se muestra en la imagen: 3. Después de presionar el botón Subir e Instalar la plataforma de VirtueMart instalara el Plug In de Pago Pago Digital, después de la correcta instalación deberá ver el siguiente mensaje tal y como se muestra en la imagen: 4
4. Genial! Ya se ha instalado el Plug In de Pago Digital, ahora deberá configurar el Plug In para su correcto funcionamiento para esto debemos dirigirnos a la pestaña VirtueMart y seleccionamos Métodos de Pago tal y como se muestra en la siguiente imagen: 5. Ahora deberá crear un nuevo método de pago para su tienda online, para esto presione el botón Nuevo tal y como aparece en la siguiente imagen: 5
6. En este punto deberá configurar el nuevo método de pago, la siguiente imagen ilustra una correcta forma de su creación. 7. Luego de llenar los campos correspondientes a la creación del método de pago deberá presionar el botón Guardar para almacenar los datos. 6
8. Luego de guardar los datos recibirá un mensaje que dirá que los datos han sido correctamente guardados, el siguiente paso será configurar este nuevo método de pago, para esto deberá presionar la pestaña configuración tal y como se ve en la pantalla. 9. En este punto deberá configurar los siguientes datos correspondientes a su tienda online, cabe recalcar que para esta configuración necesitara ciertos datos que le serán proporcionados en su cuenta de Pago Digital en el apartado de Datos Generales, es aconsejable que en este punto se dirija a su cuenta de Pago Digital y la mantenga abierta en su navegador ya que los datos que su cuenta le proporcióna serán de vital importancia para la correcta configuración del Plug In de Pago Digital, a continuación se señalaran los datos necesarios de su cuenta de Pago Digital para configuración de este Plug In. 7
10. Los datos necesarios para la configuración del plug in son: Numero de Comercio Clave Publica Plug In Numero de Terminal Clave Privada de Pago Digital 11. Ahora deberá dirigirse a la configuración del Plug In de Pago Digital tal y como se mostró en la imagen del numeral 8, a continuación se detallaran los campos a configurar. Logo de Pago Digital: al hacer click en este campo aparecerán las imágenes guardadas en la plataforma deberá seleccionar la de pago digital que lleva por nombre PagoDigital.png. 8
Entorno de Pago Digital: en este punto deberá seleccionar el entorno de pago del Plug In, el entorno real llevara a los clientes a la plataforma de pago digital en donde podrán realizar pago de sus productos y el entorno de pruebas lo conducirá a un entorno en donde podrá realizar transacciones Aprobadas y negadas para ver el comportamiento del Plug In con respecto a los pagos correctos, pagos negados y descuentos de stock de sus productos. Nombre del Comercio: Aquí deberá ingresar el nombre de su tienda virtual Número de Cliente (Pago Digital): Aquí deberá ingresar el número de comercio que aparece en los datos de su cuenta de Pago Digital anteriormente mencionados en el numeral 9. Tipos de Pago Permitidos: Seleccione Pagos con tarjeta de crédito Clave Publica de Comercio: Ingrese una clave para su comercio esta es de su libre elección, le recomendamos usar caracteres alfanuméricos y una longitud no menor a 8 dígitos Clave Privada de Pago Digital: Deberá ingresar la clave privada que género en su cuenta de Pago Digital cópiela y péguela este campo Nota: Recuerde que al generar la clave privada de Pago Digital es necesario presionar el botón de Actualizar ya que si no se hace la clave privada no será guardada y el comercio no podrá ser reconocido por la plataforma de Pago Digital. Número de Terminal: Ingrese el número de terminal proporcionado en su cuenta de Pago Digital. Tipo de Moneda: Seleccione el tipo de moneda disponible para este Plug In Genial en este punto ya ha terminado de configurar el Plug In de Pago Digital, le recomendamos realizar pruebas antes de poner en marcha este tipo de pago, recuerde que pago digital le provee de un entorno de pruebas en donde podrá saber en concreto el correcto funcionamiento de este Plug In. 12. Código Generado Esta es la etapa final de la instalación del plug In, a continuación se mostrara los diferentes estados en los que se verá envuelto el cliente según sea la respuesta de la transacción. Transacción Finalizada Con Éxito 9
Cuando el cliente finalice de llenar los datos correspondientes a la transacción y presione el botón Pagar Pago Digital le devolverá una respuesta con todos los datos correspondientes a dicha transacción esta es la primera de dos etapas en la que el cliente recibirá los resultados de la transacción. Respuesta de Pago Digital al Cliente (Primera Etapa) En esta etapa el cliente recibirá los datos correspondientes a la transacción en una tabla proporcionada por la plataforma de Pago Digital, a continuación se mostrara un ejemplo de dicho resultado 10
El cliente deberá presionar el botón Continuar para volver a tienda online del negocio y revisar el estado de su pedido en la tienda online del comercio. Al presionar continuar se enviaran los resultados de la transacción a la tienda online del comercio para realizar las operaciones de descuento de stock y pedidos aprobados, a continuación se mostrara una imagen con el resultado de la transacción en la tienda online del comercio. En este punto la tienda online del comercio ya habrá realizado internamente las operaciones de descuento de stock y pedidos aprobados, en este punto el cliente ya podrá revisar el estado del pedido en la cuenta de la tienda online del comercio a continuación se mostrara el estado del pedido en la cuenta del cliente de la tienda online del comercio. 11
A continuación se mostrara los pedidos desde el back-end de la tienda online del comercio 12
13. Tabla de números de tarjetas de prueba Transacción Exitosa Tipo Numero Nombre de la Tarjeta CCV Fecha de Expiración Visa 4507990000000010 Test Visa 123 Mes y Año en el Visa Electrón 4507920000000017 Test Visa Electrón 123 Mes y Año en el MasterCard 5323601111111112 Test MasterCard 123 Mes y Año en el Diners 36463664750005 Test Diners 123 Mes y Año en el AMEX 376411234531007 Test AMEX 123 Mes y Año en el Transacción Rechazada Tipo Numero Nombre de la Tarjeta CCV Fecha de Expiración Visa 4111111111111111 Test Visa 123 Mes y Año en el Visa Electrón 4007000000027 Test Visa Electrón 123 Mes y Año en el MasterCard 5431111111111111 Test MasterCard 123 Mes y Año en el Diners 36032416876226 Test Diners 123 Mes y Año en el AMEX 377814555409704 Test AMEX 123 Mes y Año en el 13