Mercado En Línea MANUAL DE INTEGRACIÓN. Modo Pasarela. Equipos de Escritorio (PC), Dispositivos Móviles y Apps CONFIDENCIAL

Transcripción

1 Mercado En Línea MANUAL DE INTEGRACIÓN Modo Pasarela Compatibilidad con: Equipos de Escritorio (PC), Dispositivos Móviles y Apps Fecha de Creación: Revisión: AVISO LEGAL: PROTECCIÓN NACIONAL/INTERNACIONAL: Este Software, Aplicaciones y todos sus Procedimientos se encuentran Protegidos y Debidamente Registrados en la Dirección Nacional De Derecho De Autor del estado Colombiano, protegido igualmente bajo el Convenio de Berna en más de 160 Países, cualquier intento de copia parcial o total o intento de plagio será sancionado debidamente por la ley, - Copyright 2012 Todos los Derechos Reservados. PROTECCIÓN INTERNACIONAL: Este Software, Aplicaciones y todos sus Procedimientos se encuentran Protegidos, Patentados y Debidamente Registrados en la USPTO United States Patent and Trademark Office, cualquier intento de copia parcial o total o intento de plagio será sancionado debidamente por la ley de los Estados Unidos de Norte América - Copyright 2012 Todos los Derechos Reservados. 1 Toda la información presentada en este documento es

2 INDICE Introducción al Manual 3 Requisitos de Seguridad 3 Instalación 3 Configuración 4 Sistemas de Verificación 4 Inicio de una Transacción 5 Respuesta de una Transacción 6 Ejemplo de Recuperación de Respuesta en PHP 7 Transacciones de Prueba 8 Transacciones en Estado Pendiente 9 2 Toda la información presentada en este documento es

3 Introducción al Manual Este Manual de Instalación incluye la guía completa y el código de ejemplo necesario para Implementar en su Sitio Web un servicio de Pagos en Línea con Tarjetas de Crédito y PSE seguro en Colombia en Modo Pasarela, por favor siga detenidamente los pasos de instalación y configuración para lograr un óptimo funcionamiento del mismo. Requisitos de Seguridad Antes de realizar esta instalación usted deberá cumplir con los siguientes requisitos: 1. Servidor Web Apache / Tomcat / IBM / IIS / Etc 2. Soporte HTML Instalación 1. La instalación es realmente simple, nuestro sistema recibirá desde su Sitio Web los siguientes valores para iniciar una transacción: Nombre Campo Tipo Descripción Requerido Tipo valor usuario String Usuario de acceso Si Letras/Números llavemd5 String Llave MD5 de acceso Si Letras/Números referencia String Referencia Única de Pago Si Letras/Números moneda String Moneda / COP, USD, EUR, MXN Si Letras valor String Valor Total sin decimales, comas o puntos. Si Números Exclusivamente sin decimales, puntos ni comas. iva String IVA sin decimales, comas o puntos. baseiva String Base IVA sin decimales, comas o puntos. 3 Toda la información presentada en este documento es Si Si Números Exclusivamente sin decimales, puntos ni comas. Números Exclusivamente sin decimales, puntos ni comas. descripcion String Descripción del Pago Si Letras/Números documentonumero String Número de Documento de No Números Exclusivamente Identificación del sin decimales, puntos ni Tarjetahabiente comas. nombres String Nombres del Tarjetahabiente No Letras apellidos String Apellidos del Tarjetahabiente No Letras String del Tarjetahabiente No Letras/Números direccion String Dirección del Tarjetahabiente No Letras/Números telefono String Teléfono del Tarjetahabiente No Solo Números

4 Obtención de las Credenciales de Acceso Usted recibirá un correo electrónico de Bienvenida con los datos de acceso como el usuario y llave Md5, si desea regenerar su llave MD5 por favor ingrese a su cuenta desde nuestro Sitio Web opción Panel de Clientes, una vez haya ingresado al sistema visite la opción: Opciones Avanzadas - Webservice, recuerde que cada vez que genere una nueva llave Md5 desconectará todos los aplicativos que usen la anterior Llave. Configuración Usted puede configurar su Pasarela de Pagos desde su Administrador -> Opciones Avanzadas->Pasarela. Sistemas de Verificación Active o Desactive los Sistemas de Verificación de Transacciones para su Comercio desde su Administrador -> Opciones Avanzadas->Pasarela. IMPORTANTE: El sistema de verificación de transacciones telefónicas en modo de pruebas tiene un costo por cada llamada, este sistema llamará a cualquier parte del mundo por un costo único de $ IVA por Cada Verificación Telefónica. Los Sistemas de Verificación como lo son la Fotografía, Facebook y la Grabación de Voz son completamente GRATIS en cualquier Ambiente, esta información se almacenará directamente en nuestro Sitio Web, nosotros guardaremos las evidencias de sus Clientes de forma segura ya que en el futuro podría necesitarla en caso de que un Tarjetahabiente presente alguna reclamación en su banco. Dispositivos Móviles y Apps MercadoEnLinea detectará automáticamente el tipo de Dispositivo desde donde se está iniciando la transacción y activará el Ambiente Móvil en caso de que sea necesario, o en caso de que la transacción sea iniciada desde un APP para Dispositivos Móviles. 4 Toda la información presentada en este documento es

5 Inicio de una Transacción IMPORTANTE: Es obligatorio utilizar POST como método de envío de los datos de inicio de transacción ya que el usuario no tendrá acceso a la información desde la barra de direcciones del navegador, use su lenguaje de programación preferido para iniciar una nueva transacción. URL de Inicio de las Transacciones en Modo Pasarela POST: Ejemplo del inicio de una transacción usando un formulario HTML: <form id="form1" name="form1" method="post" action=" <input type="hidden" name="usuario" id="usuario" value="suusuario" /> <input type="hidden" name="llavemd5" id="llavemd5" value="sullavemd5" /> <input type="hidden" name="referencia" id="referencia" value="10001" /> <input type="hidden" name="moneda" id="moneda" value="cop" /> <input type="hidden" name="valor" id="valor" value="1000" /> <input type="hidden" name="iva" id="iva" value="160" /> <input type="hidden" name="baseiva" id="baseiva" value="840"/> <input type="hidden" name="descripcion" id="descripcion" value="primera Transacción"/> <input type="hidden" name="urlback" id="urlback" value=" /> <input type="hidden" name="documentonumero" id="documentonumero" value=" " /> <input type="hidden" name="nombres" id="nombres" value="juan MANUEL" /> <input type="hidden" name="apellidos" id="apellidos" value="perez RODRIGUEZ" /> <input type="hidden" name=" " id=" " value="pruebas@sudominio.com" /> <input type="hidden" name="direccion" id="direccion" value="cra 15 NRO 34 56" /> <input type="hidden" name="telefono" id="telefono" value=" " /> <input type="submit" name="button" id="button" value="iniciar Transacción" /> </form> Usted puede descargar este formulario de ejemplo desde la siguiente URL: 5 Toda la información presentada en este documento es

6 Respuesta de una Transacción Al finalizar una transacción, nuestro sistema llamará a su servidor por debajo (el usuario no verá este llamado) confirmando una transacción, para ello usted deberá especificar en el inicio de su transacción el valor urlback si desea activar esta opción. Los valores que nuestra Plataforma le enviará a su Servidor de Hosting son: Nombre Tipo Descripción Requerido referencia String Referencia de Pago Enviada Si moneda String Moneda Si valor String Valor Total procesado sin Si decimales, comas o puntos. respuesta String,, pendiente Si cuentanro String Número de su Cuenta en Si nuestra Plataforma metodousado String PSE, TC, PagaMovil, Deposito Si autorizacion String Número de Autorización Si nrotransaccion String Número de Transacción Si Un ejemplo de respuesta desde nuestro Servidor es: referencia=xxxx&moneda=cop&valor=20000&respuesta=&cuentanro= &metodousado=tc&autorizaci on=670087&nrotransaccion= Recuerde que esta llamada se hace por debajo usando método GET (El Cliente nunca lo vé), usted posteriormente podrá recuperar la respuesta utilizando su lenguaje de programación preferido como ASP, PHP, JSP, ASPX, etc. Importante: Si usted desea agregar otros valores a la respuesta como un Usuario y Clave interno o un Token único por transacción para proteger su respuesta y confirmar que la misma es legítima usted puede hacerlo, simplemente agregue los valores a la urlback y nuestro sistema enviará exactamente los valores que nos presente al iniciar la transacción. Ejemplo de una urlback personalizada protegida: usuario=xxxx&clave=xxxxx&token=xxxxxxxxxxx 6 Toda la información presentada en este documento es

7 Ejemplo de Recuperación de Respuesta en PHP El siguiente ejemplo en PHP recibe la respuesta de una transacción y la almacena en un archivo de texto de nombre respuesta.txt : <?php $fecha=date('l js \of F Y h:i:s A'); $referencia= $_REQUEST['referencia']; $moneda= $_REQUEST['moneda']; $valor= $_REQUEST['valor']; $respuesta= $_REQUEST['respuesta']; $cuentanro= $_REQUEST['cuentanro']; $metodousado= $_REQUEST['metodousado']; $autorizacion= $_REQUEST['autorizacion']; $nrotransaccion= $_REQUEST['nrotransaccion']; $fichero = 'respuesta.txt'; // Abre el fichero para obtener el contenido existente $actual = file_get_contents($fichero); // Añade una nueva persona al fichero $actual.= "$fecha Referencia: $referencia Moneda: $moneda Valor: $valor Respuesta: $respuesta CuentaNro: $cuentanro Metodo Usado: $metodousado Autorización: $autorizacion Nro transacción: $nrotransaccion \n"; // Escribe el contenido al fichero file_put_contents($fichero, $actual);?> Recuerde crear el archivo respuesta.txt, subirlo a su servidor de Hosting y asignar permisos 777 al mismo para que el Script pueda escribir en este archivo. Descargar Ejemplo Completo de Respuesta en PHP: 7 Toda la información presentada en este documento es

8 Transacciones de Prueba Realice las pruebas de Conexión iniciando una transacción de pruebas con Cualquiera de las siguientes Tarjetas, estas Tarjetas de Pruebas solo funcionan en el Ambiente de Pruebas: Visa Visa Visa Electron Visa Electron American Express American Express MasterCard MasterCard Diners Club Diners Club Toda la información presentada en este documento es

9 Transacciones en estado PENDIENTE Para transacciones en estado Pendiente es posible que se requiera de su confirmación manual para procesar un pago, para este tipo de respuesta no se permite realizar ningún tipo de Procedimiento, usted debe esperar el correo de Aprobación de nuestro sistema Anti-Fraude o el procesamiento de esta transacción por parte de su Empresa desde su Administrador de Transacciones y posteriormente realizar sus procedimientos internos manualmente. Fin del Manual de Instalación en Modo Pasarela 9 Toda la información presentada en este documento es