INTEGRACION FÁCIL CON PAGOSONLINE

INTEGRACION FÁCIL CON PAGOSONLINE

Introducción... 3 Prerrequisitos de una integración fácil con Pagosonline... 5 Como crear un botón de pago... 8 Como crear un carrito de compras... 12 Como realizar pruebas de pagos... 17 Como pasar a producción... 20 Como saber qué y quien nos ha comprado... 21 Como generar un Link de cobro que no necesite pagina WEB... 23

Introducción En este capítulo revisaremos el funcionamiento general que debe existir entre su comercio y nuestra plataforma de pagos. En la siguiente gráfica podemos ver claramente un diagrama de flujo de una transacción que empieza en el sistema de su comercio, continua en nuestra plataforma y cuando finaliza el pagador podrá volver nuevamente a su sistema. El proceso empieza cuando el comprador entra a la página WEB de su comercio y selecciona los productos y/o servicios que desea adquirir. Su sistema debe conectarse con nuestro sistema a través de la Página de envío enviando por método POST una trama de datos.(1) Nuestro sistema valida esta trama, luego le permite al cliente escoger el medio de pago con el que desea realizar la transacción, por ejemplo con tarjetas de crédito o de cuentas corriente.(2) La entidad bancaria procesa la transacción y retorna una respuesta al sistema de Pagosonline.(3) Nuestro sistema devuelve al comprador a la Página de respuesta de su sistema enviando datos por método GET sobre el resultado de la transacción.(4a) Pagosonline cuenta con un módulo Antifraude que utiliza las últimas técnicas de inteligencia artificial para evaluar las transacciones, dependiendo del factor de riesgo asociado a una transacción, puede enviar una transacción a un proceso de validación manual, retardando el envío de la información a la entidad bancaria

mientras se corrobora la autenticidad de la transacción. Cuando esto sucede el estado de la transacción enviado a la Página de respuesta será en validación.

Prerrequisitos de una integración fácil con Pagosonline Como este manual está dirigido a páginas WEB que funcionen para el público en general es necesario que el comercio tenga su propio hosting donde estará montada la página WEB. Para cualquier tipo de integración que deseemos realizar con Pagosonline lo primero que debemos hacer es obtener una cuenta con Pagosonline, de esta forma obtendremos un usuario único que nos identificará con Pagosonline y obtendremos los datos para ingresar al modulo administrativo donde encontraremos varias herramientas que podemos utilizar para desarrollar nuestra página. Para ingresar al modulo administrativo del cliente por favor ingresar al siguiente link https://secure.pagosonline.net/ Tan pronto se crea una cuenta en Pagosonline se envía un correo electrónico con el número de identificación de la cuenta, el usuario y la contraseña. Si la clave la hemos perdido podemos volver a adquirirla oprimiendo en Olvidó su clave? allí digitaremos el usuario que se nos asigno, generalmente el usuario es el correo del titular de la cuenta de Pagosonline. Y pulsamos en el botón Enviar

Tan pronto hacemos este paso recibiremos un correo, a veces puede ir al correo no deseado por lo tanto debe revisarse esta carpeta también. En este correo habrá un link para activar la clave que fue enviada en el correo. Al oprimir aquí podremos introducir los datos de ingreso que tenemos en el correo. El sistema nos pedirá actualizar la contraseña. Para que esta nueva contraseña sea permitida debe cumplir unos requisitos mínimos, sabremos que los cumplimos cuando en la parte inferior del campo de texto haya una barra verde con la descripción Fuerte. Por facilidad podemos agregarle a la contraseña que 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 Tenga en cuenta que la Pregunta secreta y la Respuesta no son obligatorias. Luego podremos oprimir Procesar.

Una vez hayamos ingresado a este módulo tendremos varias pestañas que pueden variar según el tipo de comercio que hayamos creado.

Como crear un botón de pago En este capítulo veremos cómo realizar un botón de pago para un artículo específico. Para ello debemos seleccionar la opción Herramientas del comprador del modulo administrativo. Y escogemos el tópico de menú principal. Llenaremos los datos según las propiedades de nuestro artículo, por ejemplo he creado un articulo con referencia REF1 cuya descripción es Articulo 1 el valor total es de 116000 con IVA de 16000 y base de la devolución del IVA de 100000 todos estos datos los he dado en pesos colombianos. En caso de que el producto no tenga IVA se debe colocar el IVA y la Base devolución IVA en 0. También debemos llenar algunos datos como son las páginas a las que queremos que se direccione el sistema luego de finalizar una compra. Debido a que hay tres posibles estados generales de una transacción entonces se deben configurar tres páginas diferentes. En caso de querer que en todos los casos se devuelva a la

misma página, podemos colocar nuestra página principal en los tres campos. En este caso escogí http://www.pagosonline.com Durante el proceso inicial habilitaremos la variable Prueba, para que podamos simular algunos pagos con tarjetas de crédito ficticias. Finalmente podemos escoger una imagen predeterminada o personalizada para este botón. Y oprimimos en enviar. Como podemos ver aparece un código que debemos pegar en nuestra página WEB. Para crear una página WEB básica podemos abrir un archivo con el block de notas y colocar el siguiente código. <html> <head> </head> <body> </body> </html> Guardaremos este archivo como ejemplo.html en el escritorio de nuestro PC.

Ahora seremos capaces de abrir este archivo con el navegador instalado en nuestro computador. Lamentablemente a estas alturas esta página será una pantalla blanca. Es tiempo de incluir el código que genero nuestro sistema en el espacio que hay entre <body> y </body> Ahora si abrimos el archivo con nuestro navegador veremos lo siguiente:

Al oprimir el botón tendremos el siguiente formulario, lo he llenado simulando que soy un cliente de la página que he creado:

Como crear un carrito de compras Ahora veremos cómo realizar un carrito de compras donde los clientes pueden escoger diferentes productos a la vez y sumar el monto total de la compra según la cantidad de productos.

Nuevamente llenaremos los datos según las propiedades de nuestro artículo, por ejemplo he creado el mismo artículo anterior con referencia REF1 cuya descripción es Articulo 1 el valor total es de 116000 con IVA de 16000 y base de la devolución del IVA de 100000 todos estos datos los he dado en pesos colombianos. En caso de que el producto no tenga IVA se debe colocar el IVA y la Base devolución IVA en 0. También debemos diligenciar los datos de las páginas a las que queremos que retorne el sistema luego de finalizar una compra. Así que se deben configurar tres páginas diferentes. En caso de querer que en todos los casos se devuelva a la misma página, podemos colocar nuestra página principal en los tres campos. En este caso escogí http://www.pagosonline.com Durante el proceso inicial habilitaremos la variable Prueba, para que podamos simular algunos pagos con tarjetas de crédito ficticias. Finalmente podemos escoger una imagen predeterminada o personalizada para este botón. Y oprimimos en enviar. Obtendremos dos códigos, uno para el carrito en general:

Y el segundo código para el artículo que hemos configurado. En caso de querer crear más productos basándonos en el que acabamos de crear podemos oprimir el botón editar. Ahora crearemos un archivo ejemplo2.html con el block de notas y nuevamente crearemos la base del archivo de la siguiente forma: Entre el código <body> y </body> pegaremos los dos códigos creados por el módulo, de esta forma:

Abriendo este archivo con nuestro navegador tendremos lo siguiente. De esta forma cuando damos click en la imagen del artículo agregaremos un artículo de este tipo al carrito de compras y si oprimimos en ver carrito podremos ver el estado general de nuestro carrito de compras. Es posible crear más de un botón para agregar diferentes artículos de la misma forma que generamos el primero, solo no olvidar colocarle diferente referencia y descripción.

Si vemos el carrito de compras tiene varias opciones. Un botón para actualizar las cantidades de los productos, uno para volver a la tienda y seleccionar más artículos, otro que me permite continuar con el proceso del pago y una X para eliminar los productos del carrito. Cuando decidimos continuar tendremos el formulario de los datos del cliente:

Como realizar pruebas de pagos En este capítulo veremos cómo realizar pruebas de pagos con las tarjetas de crédito y tarjetas de cuentas corrientes. Una vez entramos a la pasarela de pagos de la plataforma tendremos todos los medios de pago de Pagosonline. Para realizar pruebas de pago con tarjetas de crédito podemos ingresar al logo de VISA y para realizar pruebas de pagos con tarjetas de cuentas corriente podemos ingresar al logo de PSE. En el caso de escoger VISA tendremos el siguiente formulario.

Llenando todos los datos y teniendo en cuenta que la fecha de expiración debe ser mayor a la fecha actual. Podemos usar las siguientes tarjetas de crédito y obtendremos los siguientes resultados. Número de tarjeta Resultado de la transacción 9900000000000001 Transacción aprobada 9900000000000004 Transacción rechazada 9900000000000015 Transacción en validación. En caso de hacer una transacción aprobada tendremos la siguiente pantalla. En caso de querer realizar pagos con PSE tendremos la opción de escoger diferentes bancos de prueba.

Dependiendo del banco y los datos que diligenciemos obtendremos diferentes resultados de la transacción, en la siguiente tabla tendremos todas las opciones que podemos realizar para obtener diferentes resultados finales. Banco Proceso Resultado de la transacción ABDUL Helm Finantial Bank Colocar: AA: 1234 AN: 4321 Banco Web Service ACH Colocar: AA: 1234 AN: 1234 Banco Web Service ACH - ABDUL Helm Finantial Bank Banco Unión Colombiano Banco Tequendama P: 123456 Oprimir el botón Cancel. Luego en el campo Error Code colocar: 00001 Colocar: AA: 1234 AN: 1234 P: 123456 Colocar: AA: 1234 AN: 794613 Transacción Aprobada Transacción Aprobada Transacción Rechazada Transacción Fallida Transacción Pendiente Por ejemplo para aprobar una transacción escogemos el Banco ABDUL Helm Finantial Bank que es el primero en la lista. Oprimiendo en el botón pagar llegaremos a la siguiente página. Dándole click en el botón Pay obtendremos el resultado de la transacción. Es tiempo de hablar sobre la página de respuesta, ya que a esta página es a la que se devuelve luego de finalizar una transacción.

Como pasar a producción Luego de que se realizaron todas las pruebas del sistema y se verifica que todo está funcionando correctamente, podemos pasar a producción. Realmente es un paso muy sencillos debemos eliminar la variable prueba del formulario de los artículos y carritos de compras. <input name="prueba" type="hidden" value="1"> Y debemos colocar los archivos en el servidor de la página WEB. En caso de querer colocar una nueva imagen para los botones podemos cambiar la URL de la imagen que este en el formulario por ejemplo: <input type="image" src="https://gateway.pagosonline.net/images/clientes/b_simplificado_1.png" border="0" alt="">

Como saber qué y quien nos ha comprado Para este fin entraremos al módulo de administrativo en la pestaña 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. Ya que realizamos previamente pruebas es importante que seleccionemos la variable prueba. Cuando estemos en producción esta variable no se debe colocar en las consultas.

Cuando oprimimos buscar, en la parte inferior aparecerá una serie de datos de todas las transacciones, si se desea mayor información de una en particular debemos darle click a la transacción deseada. Si deseamos un reporte mucho mayor debemos habilitar la opción Detalle ítem y oprimir en exportar a Excel.

Como generar un Link de cobro que no necesita pagina WEB Si tenemos un cliente que nos desea pagar algo de inmediato y aun no hemos desarrollado la página WEB, podemos generar un link con la herramienta que se encuentra en la pestaña Transacciones opción Crear link de pago.

Recuerde que si su producto no tiene IVA debe enviar las variables IVA y Base devolución IVA en 0. Importante para que funcione bien el link que se genere debe ser siempre con una única referencia de la venta. Y solo puede haber una transacción exitosa por link que se cree por lo tanto no puede ser enviado un solo link masivamente. Al oprimir enviar tendremos el siguiente pantallazo. El link que se genero lo copiaremos y se lo enviaremos vía correo electrónico al cliente que nos desea realizar el pago instantáneamente.