PSE-WS v1.02 ES PDF

ASH-PSE
Servicio WEB
Gua de configuracin
Versin No 1.02
Contenido
Acerca de la Gua........................................................................... 3
Flujo del Proceso PSE....................................................................... 5

Servicio Web PSE............................................................................ 6
Mtodo obtenerBancos.................................................................... 7
Mtodo crearTransaccionPSE.............................................................. 11
Mtodo consultarTransaccionPSE......................................................... 15
Checklist de Integracin................................................................... 21
Acerca de la Gua
A quien va dirigido
Esta gua va dirigida a las pequeas, medianas y grandes empresas que deseen
aumentar la venta de sus productos con herramientas innovadoras de e-commerce.
Ofreciendo a los clientes una opcin ms de pago al realizar una compra.
Propsito
El fin de esta gua es dar a conocer a la empresa solicitante los mtodos para
realizar pagos en lnea mediante PSE (Pagos seguros en lnea).
PSE es el procesador de pagos para cuentas bancarias, en este documento

explicaremos los mtodos que pueden utilizar para integrarse con esta
funcionalidad y la descripcin detallada de los mismos. Adicionalmente
encontraras ejemplos sencillos del proceso.
Tipos de Datos
Antes que nada, es importante establecer las siguientes convenciones a tener en
cuenta.
Tipo de datos Formatos y Caracteres Permitidos

Alpha Cualquier letra de cualquier idioma.
AlphaNumeric Cadena de caracteres que incluyen
letras y nmeros.
AlphaNumericPunctuation Cadena de caracteres que incluyen
letras, nmeros y signos de puntuacin
(! "#$%&'()*+,-./:;=?@^_~)
Amount Nmeros del 0 al 9 incluyendo un punto

decimal (.)
ASCIIAlphaNumericPunctuation Incluye cualquier carcter alfanumrico
de ASCII, adicionalmente: "#$%&'()*+,-
.\\/:;=?@^_~
Date (a) MM-AAAA (Mes y ao)
Date (b) AAAAMMDD (Ao, mes y da)
Date (c) aaaa-MM-dd HH:mm:ss (Ao, mes, da,
horas, minutos y segundos)
Email Direccin del correo electrnico vlida

Enumerated String Cadena alfanumrica separada por
comas
IP Direccin IP vlida
ISO 8601 Date 2013-09-17T08:17:07Z
Locale [a-z] incluyendo un guion (-)
Numeric [0-9] 0123456789
Phone ( )-1234567890
URL URL Valido (http o https)
Flujo del Proceso de PSE
Servicio Web PSE
Los diferentes Servicios Web de IATAI, son aplicables para cualquier tipo de
lenguaje de programacin, eso permite sistemas independientes de la
infraestructura a utilizar y con altos niveles de reutilizacin. Los mtodos
establecidos para realizar una compra por medio de PSE son:
obtenerBancos
crearTransaccionPSE
consultarTransaccionPSE
Para realizar las pruebas respectiva de los siguientes mtodos, es necesario tener
en cuenta las siguientes credenciales que estn disponibles para ello:
SOAP Versin: SOAP 1.2

http://pruebas.allegraplatform.com/GatewayIatai/PSE?wsdl
Una vez se finalice la integracin en un ambiente de pruebas, debe considerarse

el WSDL de produccin y el username y password suministrado por IATAI.
SOAP Versin: SOAP 1.2

https://secure.allegraplatform.com/GatewayIatai/PSE?WSDL
Mtodo obtenerBancos
Para que la empresa tenga ms posibilidades de ventas, generamos el mtodo

obtenerBancos. Este retorna los diferentes bancos que permiten el pago en lnea
para cada uno de sus clientes.
Este mtodo no requiere de datos de solicitud.
A continuacin se presenta la estructura de los datos en los campos de respuesta

con su respectiva descripcin:
respuestaObtenerBancos
Nombre Parmetro Tipo de Dato Longitud Mxima Descripcin
idBanco Numeric (4) Nmero de

identificacin
del Banco.
nombreBanco Alpha (40) Nombre del

Banco con el
que se
realizar la
Transaccin.
Ejemplo del Mtodo obtenerBancos:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://ws.iatai.com/">
<soapenv:Header>
<wsse:Security xmlns="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd">
<wsse:UsernameToken>
<wsse:Username>iatai</wsse:Username>
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-
wss-username-token-profile-1.0#PasswordText">iatai</wsse:Password>
</wsse:UsernameToken>
</wsse:Security>
</soapenv:Header>
<soapenv:Body>
<ws:obtenerBancos/>
</soapenv:Body>
</soapenv:Envelope>
Ejemplo de respuesta del mtodo obtenerBancos:
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:obtenerBancosResponse xmlns:ns2="http://ws.iatai.com/">
<respuestaObtenerBancos>
<idBanco>1040</idBanco>
<nombreBanco>BANCO AGRARIO</nombreBanco>
</respuestaObtenerBancos>
<nombreBanco>BANCO CAJA SOCIAL</nombreBanco>
<nombreBanco>BANCO CAJA SOCIAL DESARROLLO</nombreBanco>
<nombreBanco>BANCO COLPATRIA DESARROLLO</nombreBanco>
<nombreBanco>BANCO COLPATRIA UAT</nombreBanco>
<nombreBanco>BANCO COMERCIAL AVVILLAS S.A.</nombreBanco>
<nombreBanco>Banco Coomeva S.A., Bancoomeva</nombreBanco>
<nombreBanco>BANCO COOPERATIVO COOPCENTRAL</nombreBanco>
<nombreBanco>Banco Corpbanca</nombreBanco>
<nombreBanco>Banco Corpbanca (Migracion)</nombreBanco>
<nombreBanco>BANCO DAVIVIENDA</nombreBanco>
<nombreBanco>BANCO DAVIVIENDA Desarrollo</nombreBanco>
<nombreBanco>BANCO DE BOGOTA 3.0</nombreBanco>
<nombreBanco>BANCO DE BOGOTA DESARROLLO 2013</nombreBanco>
</ns2:obtenerBancosResponse>
</S:Body>
</S:Envelope>
Mtodo crearTransaccionPSE
El mtodo de crearTransaccionPSE permite realizar pagos por medio de un banco

disponible en PSE. Estos son los datos solicitados para la creacin de la transaccin.
Es banco seleccionado es tomado de la lista de bancos entregados por PSE.
La siguiente es la lista de parmetros que deben enviarse en el Web Service:
CompraPSE
Nombre Parmetro Tipo de Dato Longitud Descripcin

Mxima
Referencia * AlphaNumeric (19) Es el nombre

que identifica
la transaccin
Descripcin AlphaNumeric (80) Descripcin de
la transaccin
que se va a
crear
Valor * Numeric (7) Define el valor
de la
transaccin
IsoMoneda * Alpha (3) Cdigo ISO de
la moneda
Iva Numeric (7) Valor del IVA de
la transaccin
idBanco * Numeric (4) Nmero que
identifica el
banco, es el
campo idBanco
de
ObtenerBancos
urlRespuesta AlphaNumericPunctuation (80) Direccin URL
de la pgina de
respuesta
TitularCuentaPSE
Mxima
nombre * Alpha (40) Nombre del
titular de la
cuenta
apellido * Alpha (40) Apellido del

titular de la
cuenta
email * Email (50) Correo

electrnico del
titular de la
cuenta
Telfono * Phone (10) Nmero
telefnico del
solicitante de la
transaccin.
Documento * Numeric (10) Nmero de
documento del
solicitante de la
transaccin
Pais * Alpha (35) Pas de
residencia del
solicitante de la
transaccin
estadoProvincia Alpha (30) Estado o
Provincia donde
reside el
solicitante de la
transaccin.
ciudad * Alpha (25) Ciudad de
residencia del
solicitante de la
transaccin
direccin * AlphaNumericPunctuation (30) Direccin de
residencia del
solicitante de la
transaccin
codigoPostal * Numeric (15) Cdigo postal
del solicitante
de la
transaccin.
tipoDocumento * Alpha (2) Tipo de
documento que
identifica al
solicitante de la
transaccin.
usuarioNatural Boolean (5) Indica si es un
usuario natural
o jurdico.
InformacionFraude
Nombre Parmetro Nombre Parmetro Nombre Nombre
Parmetro Parmetro
ipComprador * IP (15) Identifica el

nmero de IP,
del comprador.
Cookie* Numeric (15) Indica el valor
del cookie
userAgent * Numeric (25) Nombre de
aplicacin
cliente en un
protocolo de
red.
Productos (puede tener 1 o varios)
Parmetro Parmetro
codigoItem* Numeric (15) Se refiere al

cdigo que
identifica el
producto.
nombreItem* Alpha (15) Nombre del
producto.
valorItem* Numeric (10) Valor del
producto.
cantidadItem* Numeric (3) Cantidad de
productos a
comprar.
codigoCategoria* Numeric (15) Cdigo de la
categora del
producto.
nombreCategoria* Alpha (15) Nombre de la
categora del
producto.
* Campos Obligatorios
Al realizar una transaccin, se recibe una respuesta con los siguientes campos:
respuestaTransaccionPSE
idTransaccion Numeric (5) Nmero que

identifica la
transaccin
realizada.
Referencia AlphaNumeric (19) Es el nombre que

identifica la
transaccin
idEstado Numeric (1) Nmero que
identifica el
estado de la
Transaccin
nombreEstado Alpha (10) Nombre del

estado en el que
se encuentra la
transaccin
codigoRespuesta AlphaNumeric (10) Cdigo de la

respuesta
generada
Valor Numeric (7) Valor de la

transaccin
isoMoneda Alpha (3) Cdigo ISO de la

Moneda
fechaProcesamiento Date (c) (29) Fecha en la que

se solicita la
transaccin
bancoPSERespuesta
Nombre Parmetro Nombre Nombre Nombre

Parmetro Parmetro Parmetro
Cdigo Numeric (4) Cdigo del Banco
Nombre Alpha (40) Nombre del

Banco
url URL Direccion URL de
respuesta.
Ejemplo del Mtodo crearTransaccionPSE:

<soapenv:Header>
<wsse:Security xmlns="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd">
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-
wss-username-token-profile-1.0#PasswordText">iatai</wsse:Password>
</wsse:Security>
</soapenv:Header>
<soapenv:Body>
<ws:crearTransaccionPSE>
<transaccionPSE>
<CompraPSE>
<referencia>test</referencia>

<descripcion>prueba final 3</descripcion>
<valor>1000</valor>
<isoMoneda>COP</isoMoneda>
<iva>0</iva>
<urlRespuesta>www.google.com</urlRespuesta>
</CompraPSE>
<TitularCuentaPSE>
<nombre>test</nombre>
<apellido>test</apellido>
<email>test@gmail.com</email>
<telefono>3111111111</telefono>
<documento>1010101010</documento>
<pais>CO</pais>
<estadoProvincia/>
<ciudad>bogota</ciudad>
<direccion>Calle 70</direccion>
<codigoPostal/>
<tipoDocumento>CC</tipoDocumento>
<usuarioNatural>true</usuarioNatural>
</TitularCuentaPSE>
<InformacionFraude>
<ipComprador>1.1.1.1</ipComprador>

<cookie>123</cookie>
<userAgent>123</userAgent>
</InformacionFraude>
<productos>

<producto>
<codigoItem>1</codigoItem>
<nombreItem>book</nombreItem>
<valorItem>1</valorItem>
<cantidadItem>1</cantidadItem>
<codigoCategoria>1</codigoCategoria>
<nombreCategoria>book</nombreCategoria>
</producto>
</productos>
</transaccionPSE>
</ws:crearTransaccionPSE>
</soapenv:Body>
</soapenv:Envelope>
Ejemplo Respuesta del Mtodo crearTransaccionPSE:

<S:Body>
<ns2:crearTransaccionPSEResponse xmlns:ns2="http://ws.iatai.com/">
<respuestaTransaccionPSE>
<idTransaccion>90157</idTransaccion>
<idEstado>6</idEstado>
<nombreEstado>En Proceso</nombreEstado>
<codigoRespuesta>SUCCESS</codigoRespuesta>
<valor>1000.0</valor>
<iva>0.0</iva>
<fechaProcesamiento>10-04-2015 12:24:07 PM</fechaProcesamiento>
<bancoPSERespuesta>
<codigo>1022</codigo>
<nombre>Banco Union Colombiano</nombre>
<url>https://desarrollo.pse.com.co/Sample6/TransactionPage.aspx?transactionid=1004357
</url>
</bancoPSERespuesta>
</respuestaTransaccionPSE>
</ns2:crearTransaccionPSEResponse>
</S:Body>
</S:Envelope>
Mtodo consultarTransaccionPSE
Una vez ejecutado el mtodo crearTransaccin, es necesario consultar la
transaccin para conocer el estado de la misma.
Se establecen tres estados que definen y muestran el status de la transaccin

consultada.
Estos son:
Aprobado: Indica que la transaccin realizada fue aprobada.
En Proceso: Indica que la transaccin realizada an est en proceso. Esta

caracterstica est presente cuando el banco no ha generado una respuesta
definitiva sobre la transaccin o el usuario no ha terminado el proceso de
pago.
Declinado: Indica que la transaccin ha sido rechazada, o no aprobada.
Para consultar una transaccin se solicitan los siguientes parmetros:
consultarTransaccionPSE
idTransaccion * Numeric (15) Nmero que

identifica la
transaccin.
Referencia * AlphaNumeric (20) Cdigo de
referencia que
identifica la
compra de los
productos.
* Campos Obligatorios
Los campos de respuesta devueltos deben ser los siguientes:
respuestaTransaccionPSE

Mxima
idTransaccion Numeric (5) Nmero que
identifica la
transaccin
realizada.
referencia AlphaNumeric (19) Es el nombre

que identifica
la transaccin
idEstado Numeric (1) Nmero que
identifica el
estado de la
Transaccin
nombreEstado Alpha (10) Nombre del

estado en el
que se
encuentra la
transaccin
codigoRespuesta Alpha (10) Cdigo de la

respuesta
generada
codigoAutorizacion AlphaNumericPuntuaction (20) Numero de

cdigo de
autorizacin
de la
transaccin
solicitada.
valor Numeric (7) Valor de la

transaccin
Iva Numeric (7) Valor del IVA

de la
transaccin
isoMoneda Alpha (3) Cdigo ISO de
la Moneda
fechaProcesamiento Date (c) (29) Fecha en la

que se solicita
la transaccin
bancoPSERespuesta

Parmetro Parmetro
codigo Numeric (4) Cdigo del
Banco
Nombre Alpha (40) Nombre del

Banco
url URL Direccion URL

de respuesta.
Ejemplo del Mtodo consultarTransaccionPSE-Aprobada:

<soapenv:Header>
<wsse:Security xmlns="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-
1.0.xsd" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-
1.0.xsd">
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-
profile-1.0#PasswordText">iatai</wsse:Password>
</wsse:Security>
</soapenv:Header>
<soapenv:Body>
<ws:consultarTransaccionPSE>
<informacionConsulta>
</informacionConsulta>
</ws:consultarTransaccionPSE>
</soapenv:Body>
</soapenv:Envelope>
Ejemplo Respuesta del Mtodo consultarTransaccionPSE -

Aprobada:
<S:Body>
<ns2:consultarTransaccionPSEResponse xmlns:ns2="http://ws.iatai.com/">
<nombreEstado>Aprobada</nombreEstado>
<codigoRespuesta>OK</codigoRespuesta>
<codigoAutorizacion>c53f376b-f394-4df8-a</codigoAutorizacion>
<iva>0.0</iva>
<mensaje/>
<bancoPSERespuesta>
<url/>
</ns2:consultarTransaccionPSEResponse>
</S:Body>
</S:Envelope>
Ejemplo del Mtodo consultarTransaccionPSE- En Proceso:

<soapenv:Header>
1.0.xsd">
</wsse:Security>
</soapenv:Header>
<soapenv:Body>
</soapenv:Body>
</soapenv:Envelope>
Ejemplo Respuesta del Mtodo consultarTransaccionPSE -En

Proceso:
<S:Body>
<nombreEstado>Declinada</nombreEstado>
<codigoRespuesta>NOT_AUTHORIZED</codigoRespuesta>
<iva>0.0</iva>
<mensaje/>
<bancoPSERespuesta>
<url/>
</S:Body>
</S:Envelope>
Ejemplo del Mtodo consultarTransaccionPSE- Declinada:

<soapenv:Header>
1.0.xsd">
</wsse:Security>
</soapenv:Header>
<soapenv:Body>
</soapenv:Body>
</soapenv:Envelope>
Ejemplo Respuesta del Mtodo consultarTransaccionPSE -

Declinada:
<S:Body>
<nombreEstado>Declinada</nombreEstado>
<codigoRespuesta>NOT_AUTHORIZED</codigoRespuesta>
<iva>0.0</iva>
<mensaje/>
<bancoPSERespuesta>
<url/>
</S:Body>
</S:Envelope>
Checklist de Integracin
Los siguientes son los aspectos que deben tenerse en cuenta para el proceso de
certificacin de IATAI, ninguna integracin puede estar completa sino cuenta con
ellos:
Caracterstica Check
Incluir el botn de PSE o Logo de PSE haciendo claridad que el pago va a
ser realizado a travs de PSE, es decir que el usuario debe saber la forma
de pago que va a utilizar antes de llegar a la lista de bancos.
El Logo a visualizar como imagen del servicio PSE debe estar actualizado
a la fecha de realizacin del proceso de certificacin, tomando como base
el archivo de imagen enviado por el rea de soporte de IATAI
Cuando Existan inconvenientes en cualquier mtodo del WS se debe

capturar la descripcin del incidente. Esta descripcin se encuentra en el
campo mensaje y debe ser mostrado sin modificacin alguna
El obtenerBancos puede consumirse al iniciar una transaccin o

consumirse una o varias veces durante el da, revisar que la consuman por
lo menos una vez al da.
El Mensaje a manejar es: No se pudo obtener la lista de bancos, por favor

intente ms tarde.
Incluir dentro del formulario de la transaccin, el campo de tipo de

persona (Natural o Jurdica) que est relacionado con el atributo
usuarioNatural
Revisar la forma como se despliega la lista de Bancos, que slo la manejen

en texto (como la reciben de IATAI) y en orden alfabtico.
No se debe eliminar ninguna entrada de la lista y se debe garantizar que

el elemento utilizado para visualizar el listado de entidades financieras
no trunque los nombres recibidos ni agregue informacin adicional.
Revisar que la pgina correspondiente al portal del banco seleccionado se
abra en una ventana independiente o nueva, es decir no puede abrirse
dentro del sitio de la empresa.
Validar que al momento de hacer el direccionamiento (Redirect) a la URL

del portal de la entidad financiera reportada por IATAI en el campo url de
bancoPseRespuesta, este proceso se efecte sobre la misma instancia del
navegador que origina la peticin y cuyo Target no sea asociado a un
Frame, Panel, IFrame o cualquier otro tipo de contenedor implementado
dentro del portal de la empresa.
Si se opta por hacer el direccionamiento sobre una nueva ventana, se debe

garantizar el modo modal en la ventana que dio origen a la peticin,
validando que la pgina que se encuentra en segundo plano no permita
ejecutar o generar una nueva peticin de pago sobre la misma referencia
o factura.
Controlar que no se permita como respuesta a la doble intencin del

usuario de iniciar un mismo procedimiento de pago una doble ejecucin
de los eventos OnClick o Click del boton o link con el cual se inicia una
nueva transaccin IATAI.
Verificar el funcionamiento del crearTransaccionPSE, debe consumirse

una sola vez e inmediatamente despus de que el usuario haya
seleccionado el banco por el cual va a realizar su pago.
La informacin enviada dentro del mensaje XML debe ser idntica a la

visualizada por la pgina de respuesta desplegada por el sitio del
comercio.
Se pueden manejar dos (2) centavos como mximo, tanto en el valor de

la transaccin como en el IVA
Se deben validar todos los campos en los formularios, antes de enviarse al

Web Service.
Verificar el funcionamiento del obtenerTransaccionPSE, comprobar el

consumo del servicio tan pronto se re-direcciona el usuario desde el portal
de la entidad financiera a la pgina de respuesta del comercio. Con esta
operacin del Web Service se obtiene el estado actual de la transaccin.
Validar los tres estados del obtenerTransaccionPSE devueltos dentro del
tag nombreEstado y idEstado
Si es APROBADO (1), se debe informar que la transaccin fue APROBADA

(no se puede mostrar el estado en ingls o utilizar sinnimos como exitosa,
autorizada, abonada, pagada, afirmativa, etc.) y visualizar el
comprobante de pago con la informacin relacionada a la transaccin
(NIT, Razn Social de la empresa prestadora del servicio de pagos, valor,
fecha, estado, banco, CUS (trasabilityCode), nmero de factura
(transactionId) y descripcin del pago). Se debe dar la opcin de imprimir
el comprobante.
Si es EN PROCESO (6), se debe informar que la transaccin est

PENDIENTE (no se puede mostrar el estado en ingls o utilizar nicamente
sinnimos como en confirmacin, irresuelta, incompleta, etc.) y
visualizar el comprobante de pago con la informacin relacionada a la
transaccin (NIT, Razn Social de la empresa de la empresa prestadora
del servicio de pagos, valor, fecha, estado, banco, CUS (trasabilityCode),
nmero de factura (transactionId)y descripcin del pago). Adicionalmente
se le debe desplegar al usuario el texto devuelto en mensaje.
o Si es DECLINADA (3) , se debe informar que la transaccin fue

RECHAZADA (no se puede mostrar el estado en ingls o utilizar sinnimos
como declinada, abortada, cancelada, no aceptada, etc.) y
visualizar el comprobante de pago con la informacin relacionada a la
transaccin (NIT, Razn Social de la empresa prestadora del servicio de
pagos, valor, fecha, estado, banco, CUS (trasabilityCode), nmero de
factura (transactionId) y descripcin del pago) y dar la opcin de imprimir
el comprobante.
Se debe visualizar un mensaje que permita al usuario conocer la

informacin de contacto en la cual se pueda indagar, con la entidad
prestadora del servicio de pagos, acerca del estado actual de una
transaccin, es decir, un texto que incluya un nmero telefnico donde
los usuarios puedan llamar y/o verificar el resultado de la transaccin en
la empresa. Adicionalmente si el estado resultante de la transaccin es
pendiente, incluir dentro del texto un vnculo de acceso a un mdulo de
consulta en el cual se visualicen como mnimo los datos bsicos de la
transaccin (CUS (trasabilityCode), nmero de factura (transactionId),
valor, fecha, estado)
Todos los comprobantes de Pago generados para cualquiera de los estados
(Aprobada, En proceso o Declinada) deben visualizarle al usuario como
requerimiento obligatorio la siguiente informacin:
1. 1. Nit de la Empresa que se encuentra en proceso de certificacin

(incluyendo dgito de chequeo).
2. 2. Nombre o Razn Social de la Empresa que se encuentra en proceso de

certificacin en IATAI.
3. 3. Valor del Pago: visualizado en Formato de miles (si usa decimales,

con 2 dgitos nicamente).
4. 4. Fecha de creacin de la transaccin.
5. 5. Estado de la transaccin: con los valores posibles, teniendo en cuenta

las condiciones anteriores.
6. 6. Banco: Presentar el Nombre completo del Banco por el cual el usuario

efectu la transaccin.
7. 7. CUS: el label del CUS debe ser claro, debe ingresarse los datos
reportados en el trasabilityCode
8. 8. Nmero de Factura o referencia del Pago (ticketID): El label debe

indicar que ste campo es el id de la transaccin.
9. 9. Descripcin del Pago: debe indicar de manera real el concepto o la

descripcin del pago y no constituirse en un campo en donde viaja un
valor que no identifica realmente el motivo del pago.
10. IP: incluir en todos los comprobantes la direccin IP del equipo

desde donde el cliente se encuentra realizando la transaccin.
11. Opcin de Imprimir el comprobante de Pago: Para todos los casos,

los comprobantes generados para la transaccin deben permitir al
usuario imprimirlo en su totalidad.
12. Visualizar un mensaje que permita al usuario conocer la informacin

de contacto en la cual se pueda indagar, con la entidad prestadora del
servicio de pagos, acerca del estado actual de una transaccin, es decir,
un texto que incluya un nmero telefnico donde los usuarios puedan
llamar y/o verificar el resultado de la transaccin en la empresa.
13. Incluir un vnculo, botn o men de acceso a un mdulo de consulta

a travs del cual sea posible consultar en cualquier momento el
histrico de transacciones realizadas y por cada registro visualizar como
mnimo los datos bsicos de la transaccin (CUS (trasabilityCode),
nmero de factura (transactionId), valor, fecha, estado)
Todos los comprobantes, al igual que todas las pginas involucradas en

el proceso durante el flujo de pago deben contar con un link o botn
que le permita al usuario iniciar, continuar o intentar realizar un nuevo
proceso de pago.
Validar que al momento de intentar acceder a la URL de retorno enviada

por el comercio a IATAI, dentro del tag compraPse.urlRepuesta de
crearTransaccionPse no se permita predecir datos de otras transacciones
previamente realizadas. La validacin puede realizarse a travs de uno de
los siguientes puntos:
1. No permitir ver informacin relacionada a transacciones finalizadas en

cualquier estado.
2. No permitir ver informacin relacionada a la transaccin generada

mientras el usuario se encuentre autorizando el dbito dentro del portal
de la entidad financiera seleccionada.
3. Utilizar parmetros aleatorios o cifrados.
4. Utilizar mecanismos de control identificando la sesin que origina el

flujo de pago.
Verificar el correcto funcionamiento de la sonda, es decir el mecanismo

que resuelve las transacciones pendientes consumiendo el mtodo
obtenerTransaccionPSE para obtener su estado actual. La sonda debe
correr cada 3 minutos y preguntar por las transacciones que hayan sido
creadas como mnimo 7 minutos antes de su ejecucin.
En promedio el primer consumo o pregunta que se efecte por parte de la

sonda debe ser realizado aproximadamente en un intervalo entre 7
minutos como mnimo y 12 minutos como mximo originados despus de
la creacin de la transaccin por la cual se est preguntando, los
intervalos de tiempo implementados entre los consumos realizados por la
sonda deben ser realizados aproximadamente entre 3 minutos como
mnimo y 6 minutos como mximo hasta que el estado de la transaccin
sea diferente a pendiente
Durante todo el proceso de pago se debe permitir iniciar una nueva
transaccin en el sitio de la empresa es decir incluir un vnculo o un botn
con las etiquetas (Regresar, Cancelar, Salir o algo por el estilo) que le
permita al usuario decidir si inicia nuevamente o cancela todo el proceso
de pago, en el caso de los comprobantes generados si la transaccin es
Aprobada o Pendiente la redireccin se debe de realizar al punto de
partida del proceso caso contrario se debe remitir al usuario para que
seleccione nuevamente el mtodo de pago e incentivar la utilizacin del
servicio.
Las pginas del sitio deben visualizar en formato de miles todos los valores
que representen cantidades monetarias, valor de la transaccin y el IVA.
Si se desea utilizar decimales solo se pueden manejar un mximo de dos
(2) cifras.
Si la empresa decide incluir dentro de su portal los logos corporativos de

los bancos vinculados a la red ACH, estos deben ser recopilados por la
entidad presentada para hacer uso del servicio IATAI o su proveedor
tecnolgico, estar actualizados a la fecha de certificacin y ser
visualizados en un tamao y aspecto homogneo.
Todas las pginas desplegadas dentro del sitio presentado para

certificacin deben manejar sin excepcin la imagen corporativa o marca
comercial perteneciente a la empresa presentada por la entidad
financiera ante ACH Colombia para la utilizacin del servicio.

PSE-WS v1.02 ES PDF

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

PSE-WS v1.02 ES PDF

Enviado por

Direitos autorais:

Formatos disponíveis

ASH-PSE

Flujo del Proceso PSE....................................................................... 5

PSE es el procesador de pagos para cuentas bancarias, en este documento

Tipo de datos Formatos y Caracteres Permitidos

Amount Nmeros del 0 al 9 incluyendo un punto

Email Direccin del correo electrnico vlida

SOAP Versin: SOAP 1.2

Una vez se finalice la integracin en un ambiente de pruebas, debe considerarse

SOAP Versin: SOAP 1.2

Para que la empresa tenga ms posibilidades de ventas, generamos el mtodo

Este mtodo no requiere de datos de solicitud.

A continuacin se presenta la estructura de los datos en los campos de respuesta

Nombre Parmetro Tipo de Dato Longitud Mxima Descripcin

idBanco Numeric (4) Nmero de

nombreBanco Alpha (40) Nombre del

Ejemplo del Mtodo obtenerBancos:

El mtodo de crearTransaccionPSE permite realizar pagos por medio de un banco

La siguiente es la lista de parmetros que deben enviarse en el Web Service:

Nombre Parmetro Tipo de Dato Longitud Descripcin

Referencia * AlphaNumeric (19) Es el nombre

apellido * Alpha (40) Apellido del

email * Email (50) Correo

ipComprador * IP (15) Identifica el

codigoItem* Numeric (15) Se refiere al

Nombre Parmetro Tipo de Dato Longitud Mxima Descripcin

idTransaccion Numeric (5) Nmero que

Referencia AlphaNumeric (19) Es el nombre que

nombreEstado Alpha (10) Nombre del

codigoRespuesta AlphaNumeric (10) Cdigo de la

Valor Numeric (7) Valor de la

isoMoneda Alpha (3) Cdigo ISO de la

fechaProcesamiento Date (c) (29) Fecha en la que

Nombre Parmetro Nombre Nombre Nombre

Cdigo Numeric (4) Cdigo del Banco

Nombre Alpha (40) Nombre del

Ejemplo del Mtodo crearTransaccionPSE:

Ejemplo Respuesta del Mtodo crearTransaccionPSE:

Se establecen tres estados que definen y muestran el status de la transaccin

Aprobado: Indica que la transaccin realizada fue aprobada.

En Proceso: Indica que la transaccin realizada an est en proceso. Esta

Declinado: Indica que la transaccin ha sido rechazada, o no aprobada.

Para consultar una transaccin se solicitan los siguientes parmetros:

Nombre Parmetro Tipo de Dato Longitud Mxima Descripcin

idTransaccion * Numeric (15) Nmero que

Los campos de respuesta devueltos deben ser los siguientes:

Nombre Parmetro Tipo de Dato Longitud Descripcin

referencia AlphaNumeric (19) Es el nombre

nombreEstado Alpha (10) Nombre del

codigoRespuesta Alpha (10) Cdigo de la

codigoAutorizacion AlphaNumericPuntuaction (20) Numero de

valor Numeric (7) Valor de la

Iva Numeric (7) Valor del IVA

fechaProcesamiento Date (c) (29) Fecha en la

Nombre Parmetro Nombre Parmetro Nombre Nombre

Nombre Alpha (40) Nombre del

url URL Direccion URL

Ejemplo del Mtodo consultarTransaccionPSE-Aprobada:

Ejemplo Respuesta del Mtodo consultarTransaccionPSE -

Ejemplo del Mtodo consultarTransaccionPSE- En Proceso:

Ejemplo Respuesta del Mtodo consultarTransaccionPSE -En

Ejemplo del Mtodo consultarTransaccionPSE- Declinada:

Ejemplo Respuesta del Mtodo consultarTransaccionPSE -

Cuando Existan inconvenientes en cualquier mtodo del WS se debe