manual de integración tradicional en java - … · (empresarial) revisión r 1 manual de...

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

1 1

w w w . P a g o s O n l i n e . c o m

Guía de integración tradicional en JAVA de Pagosonline, para clientes con plan Gateway

(Empresarial)

Revisión R 1

Manual de Integración Tradicional en JAVA

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

2 2


Control de Cambios

Fecha Responsable Versión Descripción

29/Abril/2011 Jorge López R1 Revisión Nueva versión

Pagos0nline.net S.A. Bogotá D.C. PBX. (1) 756 3126 Fax. (1) 6161540 Web: www.pagosonline.com – e-Mail: [email protected]


3

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



4

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.



5

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.



6

Prerrequisitos 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”

https://secure.pagosonline.net/



7

Tan 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



8

Una 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.




9

Como 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.




10

Para 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:

<%

String refVenta= Long.toString(java.util.Calendar.getInstance().getTimeInMillis());

%>

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

<%

double iva =36000;

double baseDevolucionIva=300000;

double valor=486000;

%>

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.

<%

String llave_encripcion = "1111111111111111";



11

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<digest.length;i++){

hx = Integer.toHexString(0xFF & digest[i]);

if(hx.length() == 1){hx = "0" + hx;}

hashedpasswd.append(hx);

}

//firma cifrada con MD5

String firma = hashedpasswd.toString();

%>

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 refVenta= Long.toString(java.util.Calendar.getInstance().getTimeInMillis());

double iva =36000;

double baseDevolucionIva=300000;

double valor=486000;

String llave_encripcion = "1111111111111111";

int usuarioId = 2;



12

String moneda ="COP";

String firma_cadena = llave_encripcion+"~"+usuarioId+"~"+refVenta+"~"+valor+"~"+moneda;



alg.reset();




String hx;



if(hx.length() == 1){hx = "0" + hx;}


}

//firma cifrada con MD5

String firma = hashedpasswd.toString();

%>

/*********************************************************/

<form method="post"

action="https://gateway2.pagosonline.net/apps/gateway/index.html" target="_self">

<input name="usuarioId" type="hidden" value="<%=usuarioId %>">

<input name="descripcion" type="hidden" value="<%=descripcion%>" >

<input name="refVenta" type="hidden" value="<%=refVenta%>">

<input name="valor" type="hidden" value="<%=valor %>">

<input name="iva" type="hidden" value="<%=iva %>">



13

<input name="baseDevolucionIva" type="hidden"

value="<%=baseDevolucionIva %>" >

<input name="firma" type="hidden" value="<%=firma%>">

<input name="emailComprador" type="hidden" value="<%=emailComprador%>">

<input name="prueba" type="hidden" value="1">

<input name="Submit" type="submit" value="Pagar">

</form>

</body>

El 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.



14

En 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.



15

En 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: AA: 1234 AN: 4321

Transacción Aprobada

Banco Web Service ACH Colocar: AA: 1234 AN: 1234 P: 123456

Transacción Aprobada

Banco Web Service ACH -

ABDUL Helm Finantial Bank

Oprimir el botón Cancel. Luego en el campo Error Code colocar: 00001

Transacción Rechazada

Banco Unión Colombiano Colocar: AA: 1234 AN: 1234 P: 123456

Transacción Fallida

Banco Tequendama Colocar: AA: 1234 AN: 794613

Transacción Pendiente

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.



16

Dá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://)



17

Este sería el código que se puede colocar en el formulario de envío, (recuerde personalizar sus

datos en las letras rojas).

<input name="url_confirmacion" type="hidden" value="http://www.comercio.com/confirmacion.jsp">

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.



18

Uno 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.

<%

String llave="1111111111111111"; //<- generalmente este dato debe estar almacenado en una base

de tatos

String usuario_id=request.getParameter("usuario_id");

String ref_venta=request.getParameter("ref_venta");

String valor=request.getParameter("valor");

String moneda=request.getParameter("moneda");

String estado_pol=request.getParameter("estado_pol");

String firma_cadena= llave+"~"+usuario_id+"~"+ref_venta+"~"+valor+"~"+moneda+"~"+estado_pol;



alg.reset();




String hx;





19

if(hx.length() == 1){hx = "0" + 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.

<%

String firma =request.getParameter("firma");//firma que envía nuestro sistema

if( firma.toUpperCase().equals( firmacreada.toUpperCase() ) ){

//comparación de las firmas

//código que funciona en caso de que los datos vengan de Pagosonline

if( estado_pol.equals("4") ){

out.print("Aprobada");

//código para actualizar base de datos en caso de aprobación

}


out.print("cancelada");

//código para actualizar base de datos en caso de

//fallo, cancelación, rechazo, etc de la transacción

}



20


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");

}

%>



21

Como 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.

https://secure2.pagosonline.net/




22

Si desea un reporte mucho mayor puede habilitar la opción Detalle ítem y oprimir en exportar a

Excel.



23

Como 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:

<form method="post"

action="https://gateway2.pagosonline.net/apps/gateway/index.html">

<form method="post"

action="https://gateway.pagosonline.net/apps/gateway/index.html">

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.

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




24

Anexos

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

Identificacion

A 25 El número de identificación del comprador. Este valor se tomará

para llenar el formulario de tarjetas crédito.

tipoDocumento

Identificacion

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

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.



25

codigo_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


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.




26

mensaje 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


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.



27

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.



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.



28

Có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



29

6 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



30

10 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)



31

Tipo 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

manual de integración tradicional en java - … · (empresarial) revisión r 1 manual de...

Documents