Manual de Integración Tradicional en PHP

Manual de Integración Tradicional en PHP
Guía de integración tradicional en PHP 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: [email protected]
1
Control de Cambios
Fecha
Responsable
Versión
Descripción
08/Marzo/2011
Andres Clavijo
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: [email protected]
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 ......................................................................................................... 12
Como configurar la página de respuesta y la de Confirmación. ......................................................... 15
Página de respuesta ........................................................................................................................ 15
Página de Confirmación .................................................................................................................. 16
Como revisar las transacciones en nuestro sistema ........................................................................... 18
Como pasar a producción ................................................................................................................... 20
Anexos ................................................................................................................................................. 21
Todas las variables de la página de envió ....................................................................................... 21
Datos que se envían a la página de respuesta ................................................................................ 22
Datos que se envían a la página de Confirmación .......................................................................... 23
Código de divisas admitidas (moneda) ........................................................................................... 25
Idiomas admitidos (lng) ................................................................................................................... 25
Estados de la transacción (estado_pol) .......................................................................................... 25
Código de respuesta (codigo_respuesta_pol)................................................................................. 26
Tipos de medios de pago (tipo_medio_pago) ................................................................................ 27
Medios de pago (medio_pago) ....................................................................................................... 28
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: [email protected]
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: [email protected]
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: [email protected]
5
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”
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: [email protected]
6
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
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: [email protected]
7
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.
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: [email protected]
8
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
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: [email protected]
9
proceso de conciliación se hace en pesos a la tasa
representativa del día. Ver las divisas admitidas en el
Anexo IV.
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:
<?php
$refVenta=time();
?>
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
<?php
$iva=36000;
$baseDevolucionIva=300000;
$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 el lenguaje Php.
<?php
$llave_encripcion = "1111111111111111";
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: [email protected]
10
$usuarioId = "2";
$moneda ="COP";
$firma_cadena = $llave_encripcion.”~”.$usuarioId.“~”.$refVenta.”~”.$valor.”~”.$moneda;
$firma = md5($firma_cadena);
?>
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.
<?php
$llave_encripcion = "1111111111111111";
$usuarioId = "2";
$refVenta = time();
$iva=36000;
$baseDevolucionIva=300000;
$valor=486000;
$moneda ="COP";
$prueba = "1";
$descripcion = "Pruebas de Generacion de Firmas";
$emailComprador="[email protected]";
$firma_cadena = $llave_encripcion."~".$usuarioId."~".$refVenta."~".$valor."~".$moneda;
$firma = md5($firma_cadena);
?>
<form method="post"
action="https://gateway2.pagosonline.net/apps/gateway/index.html" target="_self">
<input name="usuarioId" type="hidden" value="<?php echo $usuarioId ?>">
<input name="descripcion" type="hidden" value="<?php echo $descripcion ?>" >
<input name="refVenta" type="hidden" value="<?php echo $refVenta ?>">
<input name="moneda" type="hidden" value="COP">
<input name="valor" type="hidden" value="<?php echo $valor ?>">
<input name="iva" type="hidden" value="<?php echo $iva ?>">
<input name="baseDevolucionIva" type="hidden" value="<?php echo $baseDevolucionIva?>">
<input name="firma" type="hidden" value="<?php echo $firma?>">
<input name="emailComprador" type="hidden" value="<?php echo $emailComprador?>">
<input name="prueba" type="hidden" value="1">
<input name="Submit" type="submit" value="Pagar">
</form>
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.
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: [email protected]
11
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.
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.
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: [email protected]
12
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.
En caso de querer realizar pagos con PSE tendrá la opción de escoger diferentes bancos de prueba.
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: [email protected]
13
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
Colocar:
AA: 1234
AN: 1234
P: 123456
Oprimir el botón Cancel.
Luego en el campo Error Code
colocar: 00001
Transacción Aprobada
Colocar:
AA: 1234
AN: 1234
P: 123456
Colocar:
AA: 1234
AN: 794613
Transacción Fallida
Banco Web Service ACH
Banco Web Service ACH ABDUL Helm Finantial Bank
Banco Unión Colombiano
Banco Tequendama
Transacción Aprobada
Transacción Rechazada
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.
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.
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: [email protected]
14
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://)
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.pagosonline.com/confirmacion.php">
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.
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: [email protected]
15
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.
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 hace un 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 Php.
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: [email protected]
16
<?php
$llave="1111111111111111";/////llave de usuario de pruebas 2
$usuario_id=$_REQUEST['usuario_id'];
$ref_venta=$_REQUEST['ref_venta'];
$valor=$_REQUEST['valor'];
$moneda=$_REQUEST['moneda'];
$estado_pol=$_REQUEST['estado_pol'];
$firma_cadena=$llave."~".$usuario_id."~".$ref_venta."~".$valor."~".$moneda."~".$estado_pol;
$firmacreada = md5($firma_cadena);//firma que generaron ustedes
$firma =$_REQUEST['firma'];//firma que envía nuestro sistema
if(strtoupper($firma)==strtoupper($firmacreada));//comparación de las firmas
?>
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.
(Recuerde cambiar las variables en Rojo)
<?php
$llave="1111111111111111";/////llave de usuario de pruebas 2
$usuario_id=$_REQUEST['usuario_id'];
$ref_venta=$_REQUEST['ref_venta'];
$valor=$_REQUEST['valor'];
$moneda=$_REQUEST['moneda'];
$estado_pol=$_REQUEST['estado_pol'];
$firma_cadena= $llave."~".$usuario_id."~".$ref_venta."~".$valor."~".$moneda."~".$estado_pol;
$firmacreada = md5($firma_cadena);//firma que generaron ustedes
$firma =$_REQUEST['firma'];//firma que envía nuestro sistema
if(strtoupper($firma)==strtoupper($firmacreada)){//comparación de las firmas
//código que funciona en caso de que los datos vengan de Pagosonline
if($_REQUEST['estado_pol'] == 4){
//código para actualizar base de datos en caso de aprobación
}
else{
//código para actualizar base de datos en caso de
//fallo, cancelación, rechazo, etc 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: [email protected]
17
Como revisar las transacciones en nuestro sistema
Para
este
fin,
deberá
https://secure2.pagosonline.net/
ingresar
ya
que
al
módulo
las
pruebas
administrativo
se
realizaron
en
pruebas
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: [email protected]
18
Si 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: [email protected]
19
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.
<input name="prueba" type="hidden" value="1">
ó
<input name="prueba" type="hidden" value="0">
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.
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: [email protected]
20
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
A
25
El número de identificación del comprador. Este valor se tomará
para llenar el formulario de tarjetas crédito.
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.
Identificacion
tipoDocumento
Identificacion
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: [email protected]
21
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
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: [email protected]
22
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
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: [email protected]
23
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.
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: [email protected]
24
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
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: [email protected]
25
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
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: [email protected]
26
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)
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: [email protected]
27
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
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: [email protected]
28