Manual de Integración Tradicional en JAVA
←
→
Transcripción del contenido de la página
Si su navegador no muestra la página correctamente, lea el contenido de la página a continuación
Manual de Integración Tradicional en JAVA
Guía de integración tradicional en JAVA de Pagosonline, para clientes con plan Gateway
(Empresarial)
Revisión R 1
w w w . P a g o s O n l i n e . c o m
PagosOnLine S.A. Bogotá D.C. PBX. (1) 576 3126 FAX. (1) 6161540
www.pagosonline.com – e-mail: info@pagosonline.com
1
Control de Cambios
Fecha Responsable Versión Descripción
29/Abril/2011 Jorge López R1 Revisión Nueva versión
w w w . P a g o s O n l i n e . c o m
PagosOnLine S.A. Bogotá D.C. PBX. (1) 576 3126 FAX. (1) 6161540
www.pagosonline.com – e-mail: info@pagosonline.com
2
Tabla de contenido
Tabla de contenido................................................................................................................................ 3
Introducción .......................................................................................................................................... 4
Prerrequisitos de una integración tradicional con Pagosonline ........................................................... 6
Como conectarse con PagosOnLine ...................................................................................................... 9
Como realizar pruebas de pagos ......................................................................................................... 13
Como configurar la página de respuesta y la de Confirmación. ......................................................... 16
Página de respuesta ........................................................................................................................ 17
Página de Confirmación .................................................................................................................. 17
Como revisar las transacciones en nuestro sistema ........................................................................... 21
Como pasar a producción ................................................................................................................... 23
Anexos ................................................................................................................................................. 24
Todas las variables de la página de envió ....................................................................................... 24
Datos que se envían a la página de respuesta ................................................................................ 25
Datos que se envían a la página de Confirmación .......................................................................... 26
Código de divisas admitidas (moneda) ........................................................................................... 28
Idiomas admitidos (lng) ................................................................................................................... 28
Estados de la transacción (estado_pol) .......................................................................................... 28
Código de respuesta (codigo_respuesta_pol)................................................................................. 29
Tipos de medios de pago (tipo_medio_pago) ................................................................................ 30
Medios de pago (medio_pago) ....................................................................................................... 31
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 3
Introducción
En este capítulo se revisará el funcionamiento general que debe existir entre su Comercio (Sitio
Web) y nuestra plataforma de pagos.
En la siguiente gráfica puede ver claramente un diagrama de flujo de una transacción que empieza
en el sistema de su comercio, continua en nuestra plataforma y una vez finalizada la transacción,
el pagador podrá volver nuevamente a su sistema.
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 4
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 totalizar el valor de la compra y
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
de ahorro y corriente.(2) La entidad bancaria procesa la transacción y retorna una respuesta al
sistema de Pagosonline.(3) Nuestro sistema devuelve al comprador a una “Página de respuesta”
dentro de Pagosonline donde visualizará el resultado de la transacción, en caso de que la
transacción sea rechazada o fallida el sistema permitirá reintentar el pago lo cual devolverá al
pagador a seleccionar el medio de pago deseado.(4a) En el momento que finaliza una transacción, es
decir en el momento que se aprueba o rechaza, se envía la información de la transacción por
método POST a la “Página de Confirmación” en la cual el comercio podrá actualizar las bases de
datos de su sistema.(4b)
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 y el envío de los datos a la “Página de confirmación” no será inmediato, hasta se
resuelva como aprobada o rechazada.
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 5Prerrequisitos de una integración tradicional con Pagosonline
Se recomienda tener algún tipo de base de datos para que el Comercio tenga registro de las
transacciones que se realicen en su sistema, pero esto no es necesario, ni obligatorio; ya que en el
modulo administrativo del Comercio podrá encontrar el detalle de todas las transacciones.
Para cualquier tipo de integración que desee realizar, lo primero que debe hacer es obtener una
cuenta con PagosOnLine, de esta forma obtendrá un usuario único que lo identificará en el
sistema, y una llave de encripción que le permitirá realizar transacciones.
Tan pronto se crea una cuenta en PagosOnLine, se envía un correo electrónico con el número del
usuario y datos para ingresar al modulo administrativo, https://secure.pagosonline.net/ .
Si la clave fue extraviada, podrá volver a adquirir una nueva, oprimiendo en “Olvidó su clave?” allí
deberá digitar el usuario que se le asigno, generalmente este usuario es el correo que registró en el
sistema de PagosOnLine. Finalmente pulse en el botón “Enviar”
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 6Tan pronto realice este paso, recibirá un correo, a veces puede ir al correo no deseado, por lo tanto
debe revisarse esta carpeta también. En este correo encontrará un link para activar la clave que fue
enviada en este correo (Ver siguiente imagen).
Al oprimir aquí podrá introducir los datos de ingreso que se encuentran en el correo. El sistema
pedirá actualizar la contraseña. Para que esta nueva contraseña sea permitida debe cumplir unos
requisitos mínimos, usted sabrá que los cumplió cuando en la parte inferior del campo de texto
haya una barra verde con el título “Fuerte. 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
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 7Una vez haya ingresado a este módulo debe entrar a la pestaña “Opciones”, donde podrá visualizar
la llave de encripción.
Para ingresar al modulo administrativo en el ambiente pruebas https://secure2.pagosonline.net/ ,
debe solicitar de nuevo una contraseña, la cual es diferente a la anterior. Esto le permitirá revisar
las transacciones realizadas en el ambiente de pruebas.
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 8Como conectarse con PagosOnLine
En este capítulo verá cómo realizar conexiones con la plataforma de PagosOnLine. Luego de tener
los datos del usuario, siguiendo los pasos del capítulo anterior, puede empezar a realizar
conexiones con la plataforma de pagos, para ello deberá generar un formulario que apunte a la
siguiente URL:
https://gateway2.pagosonline.net/apps/gateway/index.html
Cada vez que se realiza una conexión se deben enviar algunos datos por método POST al sistema de
PagosOnLine. Los datos mínimos de envío son:
Campo Tipo Tamaño Descripción
usuarioId N 12 Es el número identificador del comercio en el sistema de
PagosOnLine, este número lo encontrará en el correo de
creación de la cuenta.
refVenta A 50 Es la referencia de la venta o pedido. Deber ser único por cada
transacción que se envía al sistema.
descripción A 255 Es la descripción de la venta
valor N 14,2 Es el monto total de la transacción. Puede contener dos dígitos
decimales. Ej. 10000.00 ó 10000
iva N 14,2 Es el valor del IVA de la transacción, si se envía el IVA nulo el
sistema aplicará el 16% automáticamente. Puede contener dos
dígitos decimales. Ej: 16000.00. En caso de no tener IVA debe
enviarse en 0.
baseDevolucionIva N 14,2 Es el valor de la base de devolución del IVA para productos
gravados con el 10% o el 16% de la tarifa del IVA. En caso de que
no tenga IVA o el IVA corresponda a otra tarifa se debe enviarse
en 0.
firma N 32 Es la firma digital creada para cada uno de las transacciones.
prueba N 2 Variable para poder utilizar tarjetas de crédito de pruebas.
emailComprador A 255 Campo que contiene el correo electrónico del comprador para
notificarle el resultado de la transacción por correo electrónico.
Se recomienda hacer una validación si se toma este dato en un
formulario.
moneda A 3 La moneda respectiva en la que se realiza el pago. El proceso de
conciliación se hace en pesos a la tasa representativa del día. Ver
las divisas admitidas en el Anexo IV.
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 9Para conocer otras variables por favor diríjase al Anexo I.
La variable refVenta debe ser única por cada transacción. Como el uso de un consecutivo de los
intentos de pago entre su sitio web y nuestra pasarela de pagos, Como ejemplo práctico se podría
generar un valor de una función de tiempo, por ejemplo:
Con respecto a la variable iva y baseDevolucionIva es posible que los valores de la transacción
totalicen productos que incluyan IVA y otros que no lo tengan, para ello tendrá que realizar el
siguiente cálculo para saber cómo enviar los valores a la plataforma de pagos.
Producto Base del Iva Iva Valor Total
A 100,000 16,000 (16%) 116,000
B 200,000 20,000 (10%) 220,000
C 0 0 (0%) 150,000
Total 300,000 36,000 486,000
Otro de los datos que debe enviar es la firma. Para ello deberá realizar un proceso algorítmico de
cifrado, MD5 a la siguiente cadena:
"llaveEncripcion~usuarioId~refVenta~valor~moneda"
Lo más aconsejable para comenzar el proceso de conexión con PagosOnLine, es que utilice su
usuarioId y su llave de encripción, ya que esto le asegurará que su cuenta está correctamente
configurada. Teniendo en cuenta, que en caso de no tener la llave ni el código del usuario, podemos
usar los datos de prueba que son, usuario 2 y llave 1111111111111111. A continuación podrá
observar un ejemplo de cómo crear la llave de encripción para JAVA.long usuarioId = 2;
String moneda ="COP";
String firma_cadena = llave_encripcion+"~"+usuarioId+"~"+refVenta+"~"+valor+"~"+moneda;
//Algoritmo MD5 para JAVA
MessageDigest alg = MessageDigest.getInstance("MD5");
alg.reset();
alg.update(firma_cadena.getBytes());
byte[] digest = alg.digest();
StringBuffer hashedpasswd = new StringBuffer();
String hx;
for (int i=0;i
En conjunto e incluyendo el envío de los datos el código sería de la siguiente manera, sin olvidar
que debe modificar las variables en rojo por sus datos.String moneda ="COP";
String firma_cadena = llave_encripcion+"~"+usuarioId+"~"+refVenta+"~"+valor+"~"+moneda;
//Algoritmo MD5 para JAVA
MessageDigest alg = MessageDigest.getInstance("MD5");
alg.reset();
alg.update(firma_cadena.getBytes());
byte[] digest = alg.digest();
StringBuffer hashedpasswd = new StringBuffer();
String hx;
for (int i=0;i
/*********************************************************/
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 12El resultado final de este código será una página Web con un botón que se conectará con la
plataforma de pagos cada vez que se oprima sobre el mismo.
Como realizar pruebas de pagos
En este capítulo se explicará 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 puede ingresar al logo de VISA y para realizar
pruebas de pagos con tarjetas de cuentas corriente puede ingresar al logo de PSE.
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 13En el caso de escoger VISA el sistema lo enviará al siguiente formulario.
Se deben ingresar todos los datos, teniendo en cuenta que la fecha de expiración de la tarjeta de
crédito debe ser mayor a la fecha actual. Puede usar las siguientes tarjetas de crédito para obtener
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 se obtiene la siguiente pantalla.
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 14En caso de querer realizar pagos con PSE tendrá la opción de escoger diferentes bancos de prueba.
Dependiendo del banco y los datos que ingrese obtendrá diferentes resultados de la transacción,
en la siguiente tabla se muestran todas las opciones que podemos realizar para obtener diferentes
resultados finales.
Banco Proceso Resultado de la transacción
ABDUL Helm Finantial Bank Colocar: Transacción Aprobada
AA: 1234
AN: 4321
Banco Web Service ACH Colocar: Transacción Aprobada
AA: 1234
AN: 1234
P: 123456
Banco Web Service ACH - Oprimir el botón Cancel. Transacción Rechazada
ABDUL Helm Finantial Bank Luego en el campo Error Code
colocar: 00001
Banco Unión Colombiano Colocar: Transacción Fallida
AA: 1234
AN: 1234
P: 123456
Banco Tequendama Colocar: Transacción Pendiente
AA: 1234
AN: 794613
Por ejemplo para aprobar una transacción se escoge el Banco ABDUL Helm Finantial Bank que es el
primero en la lista. Oprimiendo en el botón pagar el sistema lo llevará a la siguiente página.
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 15Dándole clic en el botón “Pay” se arrojará 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 configurar la página de respuesta y la de Confirmación.
En este capítulo se tratara de como se puede configurar la página de confirmación para actualizar la
base de datos.
Lo primero que debe hacer es configurar nuestras páginas. Una forma para hacer esto es en la
pestaña Opciones del módulo administrativo. Estas variables deben ser la URL completa de la
página de confirmación (incluyendo http://)
O si lo prefiere se puede configurar, enviando una variable de más en el codigo por el cual se
conectan a nuestra plataforma (remítase al capítulo anterior). La variable se llama url_confirmacion
y su valor debe incluir la URL completa (incluyendo http://)
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 16Este sería el código que se puede colocar en el formulario de envío, (recuerde personalizar sus
datos en las letras rojas).
Página de respuesta
Al finalizar una transacción nuestro sistema enviará al pagador a la página de respuesta. A esta
página nuestro sistema le envía información a través del método GET, de esta forma se le da
información al pagador sobre el estado de una transacción.
Para aquellos clientes con Plan Gateway que deseen realizar pagos con tarjeta corriente o débito,
esto no aplica para Planes Full Pack, deben realizar un proceso de certificación con ACH Colombia.
Para ello la página de respuesta cumple unos requisitos que se ven plasmados en la siguiente
imagen.
Esta página se encuentra dentro de nuestra pasarela de pagos, y es la última página a la que el
pagador se remite antes de volver al sitio web del comercio.
La redirección al sitio web se hará a través de un link que el comercio debe especificar a través de
un correo electrónico a su ingeniero de soporte e implementación.
Página de Confirmación
La página de confirmación le permite actualizar las bases de datos de su sistema; por esto, no debe
incluir código HTML para que no sea visible al comprador. A esta página nuestra plataforma envía
varias variables por medio del método POST cuando una transacción finaliza, es decir cuando se
aprueba, se rechaza o cuando es cancelada.
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 17Uno de los datos que envía el sistema es una variable “firma” que genero nuestro sistema teniendo
en cuenta la siguiente cadena de caracteres.
"llaveEncripcion~usuario_id~ref_venta~valor~moneda~estado_pol"
Observe que no es igual a la firma que usted genero en la página de envió.
Finalmente nuestro sistema le aplica MD5 para codificar esta cadena. La idea es que ustedes
realicen este mismo proceso para luego comparar las dos firmas, las cuales serán iguales
únicamente cuando estás firmas sean iguales. (Recuerde cambiar la variable en rojo), a
continuación se muestra un ejemplo en JAVA.if(hx.length() == 1){hx = "0" + hx;}
hashedpasswd.append(hx);
}
String firmacreada = hashedpasswd.toString();
%>
En la página de confirmación, dependiendo de los datos que se deseen guardar en la base de datos
se debe realizar la toma de los mismos.
Se recomienda utilizar estado_pol para saber el resultado final de la transacción. De esta forma
únicamente cuando llega el código de aprobado y abonado, código 4, la base de datos debe
modificarse como un pago efectivo, de lo contrario se puede tomar como un fallo en la transacción
como en la continuación del ejemplo.if( estado_pol.equals("6") ){
out.print("rechazada");
//código para actualizar base de datos en caso de
//fallo, cancelación, rechazo, etc de la transacción
}
}else{
out.print("Erro firma");
}
%>
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 20Como revisar las transacciones en nuestro sistema
Para este fin, deberá ingresar al módulo administrativo en pruebas
https://secure2.pagosonline.net/ ya que las pruebas se realizaron apuntando a
https://gateway2.pagosonline.net/apps/gateway/index.html,
Cuando se oprime buscar, en la parte inferior aparecerá una serie de datos de todas las
transacciones, si se desea mayor información de una en particular puede hacer click a la
transacción deseada.
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 21Si desea un reporte mucho mayor puede habilitar la opción Detalle ítem y oprimir en exportar a
Excel.
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 22Como pasar a producción
Luego de que se realizaron todas las pruebas del sistema y se verifica que todo está funcionando
correctamente, se puede realizar el cambio a producción. Para realizar esto, es necesario que este
seguro que todos los datos de su cuenta estén en el código, es decir, que su llave de encripción y su
usuario Id sean los correctos.
Realmente son pasos muy sencillos, primero debe eliminar o cambiar la variable prueba en la
página de envío de la siguiente manera.
ó
Y segundo debemos apuntar al servidor de producción.
https://gateway.pagosonline.net/apps/gateway/index.html
Así que el código debe cambiar de la siguiente forma:
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 producción no se envía la variable prueba en 1, entonces no seleccione
la casilla prueba del formulario de consulta de transacciones.
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 23Anexos
Todas las variables de la página de envió
Campo Tipo Tam. Descripción
lng A 3 Idioma en el que se desea mostrar la pasarela de pagos. Ver los
lenguajes admitidos en el anexo V.
nombreComprador A 50 El nombre del comprador. Este valor se tomará para llenar el
formulario de tarjetas crédito.
Documento A 25 El número de identificación del comprador. Este valor se tomará
para llenar el formulario de tarjetas crédito.
Identificacion
tipoDocumento N 2 El tipo de identificación del cliente. 1-Cédula de Ciudadanía 2-NIT
(sin dígito de chequeo) 3-Cédula de Extranjería 4-Tarjeta de
Identificacion Identidad 5-Pasaporte 6-Tarjeta Social Security 7-Sociedad
extranjera sin Nit. 8-Fideicomiso 9-Registro Civil 10-Carné
Diplomático 99-Otro
telefonoMovil A 50 El número celular del comprador. Este valor se tomará para llenar
el formulario de tarjetas crédito y será el teléfono de contacto.
extra1 A 255 Campo adicional para enviar información sobre la compra. Ej.
Descripción de la compra en caso de querer visualizarla en la
página de respuesta
extra2 A 255 Campo adicional para enviar información sobre la compra. Ej.
Códigos internos de los productos.
url_respuesta A 255 La url de la página de respuesta.
url_confirmacion A 255 La url de la página de confirmación.
tiposMediosDePago N 2 Especifica el o los códigos de los medios de pagos que quiere
activar para que su cliente pueda pagar, en su defecto todos están
activos. Ejemplo: tiposMediosDePago=2,8; si envía más de un
código sepárelos por comas. Ver los tipos medios de pagos en el
anexo VIII
plantilla A 255 Le permite al usuario especificar una plantilla html personalizada
que previamente debió haber sido registrada en el sistema
tomando el servicio de Look and Feel.
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 24codigo_pse A 50 Si posee más de un código de servicio creado en la plataforma de
PSE y desea especificar cual utilizar. Solo aplica para plan
empresarial o corporativo.
direccionCobro A 255 La dirección de correspondencia
ciudadCobro A 25 La ciudad de correspondencia
direccionEnvio A 255 La dirección de entrega de la mercancía.
ciudadEnvio A 25 La ciudad de entrega de la mercancía.
paisEnvio A 2 Código ISO 3166 del país en donde se va a entregar la mercancía.
telefono A 50 El teléfono de residencia del comprador.
telefonoOficina A 50 El teléfono diurno del comprador.
numeroCliente A 50 El número del cliente en el sistema de información del comercio.
Datos que se envían a la página de respuesta
Campo Tipo Tam. Descripción
usuario_id N 12 El número de usuario en el sistema de Pagosonline.
estado_pol N 2 Indica el estado de la transacción en el sistema, ver tabla en el
anexo VI con los estados.
riesgo N 12 El riesgo asociado a la transacción. Toma un valor entre 0 y 1. A
mayor riesgo mayor valor. Viene en formato ###.00
codigo_respuesta_pol N 2 El código de respuesta de Pagosonline.net. Ver la tabla con los
códigos de respuesta en el anexo VII.
ref_venta A 50 La referencia de la venta o pedido.
ref_pol N 12 La referencia o número de la transacción generado en
Pagosonline
firma A 32 La firma digital de respuesta. Utiliza el algoritmo Md5.
extra1 A 255 Campo enviado para los datos adicionales.
extra2 A 255 Campo enviado para los datos adicionales.
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 25mensaje A 255 Descripción del estado de la transacción.
medio_pago N 2 El identificador interno del medio de pago utilizado. Ver tabla en
el anexo IX
tipo_medio_pago A 2 El tipo de medio de pago utilizado para el pago. Ver tabla en el
anexo VIII
cuotas N 2 Número de cuotas en las cuales se difirió el pago con tarjeta
crédito.
valor N 14,2 El valor de la transacción en formato ###.00 en la moneda que fue
hecho el pago.
valorPesos N 14,2 El valor de la transacción en formato ###.00 en pesos
Colombianos (COP).
iva N 14,2 El valor del IVA de la transacción en formato ###.00
valorAdicional N 14,2 El valor adicional enviado no sujeto a comisión por parte de la
entidad financiera.
moneda A 3 La moneda utilizada para el pago.
cus N 15 El cus, código único de seguimiento, es la referencia del pago
dentro del Banco, aplica solo para pagos con PSE. En el caso de un
pago con tarjeta de crédito se envía la fecha de la transacción
YYYYMMDD. Requerido para la certificación de PSE con ACH
Colombia.
banco_pse A 25 El nombre del banco, aplica solo para pagos con PSE. Requerido
para la certificación de PSE con ACH Colombia.
idioma A 2 El idioma en el cual se mostró la pasarela de pagos.
fecha_procesamiento A 20 La fecha en que se realizó la transacción.
Datos que se envían a la página de Confirmación
Campo Tipo Tam. Descripción
usuario_id N 12 El número de usuario en el sistema de Pagosonline.
estado_pol N 2 Indica el estado de la transacción en el sistema, ver tabla en el
anexo VI con los estados.
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 26riesgo N 12 El riesgo asociado a la transacción. Toma un valor entre 0 y 1. A
mayor riesgo mayor valor. Viene en formato ###.00
codigo_respuesta_pol N 2 El código de respuesta de Pagosonline.net. Ver la tabla con los
códigos de respuesta en el anexo VII.
ref_venta A 50 La referencia de la venta o pedido.
ref_pol N 12 La referencia o número de la transacción generado en
Pagosonline
firma A 32 La firma digital de respuesta. Utiliza el algoritmo Md5.
extra1 A 255 Campo enviado para los datos adicionales.
extra2 A 255 Campo enviado para los datos adicionales.
medio_pago N 2 El identificador interno del medio de pago utilizado. Ver tabla en
el anexo IX
tipo_medio_pago A 2 El tipo de medio de pago utilizado para el pago. Ver tabla en el
anexo VIII
cuotas N 2 Número de cuotas en las cuales se difirió el pago con tarjeta
crédito.
valor N 14,2 El valor de la transacción en formato ###.00 en la moneda que fue
hecho el pago.
iva N 14,2 El valor del IVA de la transacción en formato ###.00
valorAdicional N 14,2 El valor adicional enviado no sujeto a comisión por parte de la
entidad financiera.
fecha_transaccion A 20 La fecha en que se realizó la transacción.
moneda A 3 La moneda utilizada para el pago.
email_comprador A 255 Es el correo electrónico del comprador.
cus N 15 El cus, código único de seguimiento, es la referencia del pago
dentro del Banco, aplica solo para pagos con PSE. En el caso de un
pago con tarjeta de crédito se envía la fecha de la transacción
YYYYMMDD.
banco_pse A 25 El nombre del banco, aplica solo para pagos con PSE.
prueba N 1 Envío del flag de la transacción.
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 27Código de divisas admitidas (moneda)
Código ISO 4217 Divisa
COP Pesos Colombianos
EUR Euros
GBP Libras Esterlinas
MXN Pesos Mexicanos
USD U.S. Dólar
VEB Bolívares Fuertes
Idiomas admitidos (lng)
Código ISO 639 Idioma
fr Francés
en Inglés
es Español
It Italiano
Estados de la transacción (estado_pol)
Código Descripción
1 Sin abrir
2 Abierta
3 Pagada
4 Pagada y abonada
5 Cancelada
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 286 Rechazada
7 En validación
8 Reversada
9 Reversada fraudulenta
10 Enviada ent. Financiera
11 Capturando datos tarjeta de crédito
12 Esperando confirmación sistema PSE
13 Activa Débitos ACH
14 Pendiente pago entidad
15 Pendiente pago banco
16 Capturando datos debito ACH
17 Esperando Confirmación VBV
18 Notificado a Entidad
Código de respuesta (codigo_respuesta_pol)
Código de respuesta Descripción
1 Transacción aprobada
2 Pago cancelado por el usuario
3 Pago cancelado por el usuario durante validación
4 Transacción rechazada por la entidad
5 Transacción declinada por la entidad
6 Fondos insuficientes
7 Tarjeta invalida
8 Acuda a su entidad
9 Tarjeta vencida
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 2910 Tarjeta restringida
11 Discrecional POL
12 Fecha de expiración o campo seg. Inválidos
13 Repita transacción
14 Transacción inválida
15 Transacción en proceso de validación
16 Combinación usuario-contraseña inválidos
17 Monto excede máximo permitido por entidad
18 Documento de identificación inválido
19 Transacción abandonada capturando datos TC
20 Transacción abandonada
21 Imposible reversar transacción
22 Tarjeta no autorizada para realizar compras por internet.
23 Transacción rechazada
24 Transacción parcial aprobada
25 Rechazada por no confirmación
26 Comprobante generado, esperando pago en banco
9994 Transacción pendiente por confirmar
9995 Certificado digital no encontrado
9996 Entidad no responde
9997 Error de mensajería con la entidad financiera
9998 Error en la entidad financiera
9999 Error no especificado
Tipos de medios de pago (tipo_medio_pago)
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 30Tipo de medio de pago Descripción
2 Tarjetas de Crédito
3 Verified by VISA
4 PSE (Cuentas corriente/ahor.)
5 Debito ACH
7 Pago en efectivo
8 Pago referenciado
9 Tarjetas Especiales
Medios de pago (medio_pago)
Medio de pago Descripción
10 VISA
11 MASTERCARD
12 AMEX
22 DINERS
24 Verified by VISA
25 PSE
27 VISA Debito
30 Efecty
34 CAFAM
35 Baloto
36 Servibanca
37 Pago referenciado
w w w . P a g o s O n l i n e . c o m
Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540
Web: www.pagosonline.com – e-Mail: info@pagosonline.com 31También puede leer
