Integracion WS R2

Manual de Integracin WebServices
Gua de integracin WebServices de Pagosonline, para clientes con plan Gateway (Empresarial)
Revisin R2
w w w . P a g o s O n l i n e . c o m
PagosOnLine S.A. Bogot D.C. PBX. (1) 576 3126 FAX. (1) 6161540 www.pagosonline.com e-mail: info@pagosonline.com 1
Control de Cambios
Fecha 08/Marzo/2011 10/Julio/2012 Responsable Jorge Lopez Arrieta Marcela Martnez Versin R1 R2 Descripcin Nueva versin Se adiciona el mtodo para DFP
Contenido
Control de Cambios ......................................................................................................................... 2 CAPITULO 1. Descripcin de la aplicacin ........................................................................................... 6 CAPITULO 2. Como obtener los datos de acceso al WebServices....................................................... 8 CAPITULO 3. Descripcin y Uso de Mtodos .................................................................................... 11 3.1 Descripcin de los mtodos y objetos disponibles para los diferentes medios de pago ....... 12 METODO: getVersion() .............................................................................................................. 12 3.1.1 Mtodos WebServices Y Objetos ......................................................................................... 12 METODO: leerMediosPagoActivos( usuarioId ) ........................................................................ 12 OBJETO: MedioPagoWS ............................................................................................................ 13 3.1.2 Mtodos para consulta de transacciones ............................................................................ 13 METODO: consultarEstadoTransaccion( cuentaId, transaccionId ) .......................................... 13 OBJETO: EstadoTransaccionWS................................................................................................. 14 3.1.3 Mtodos de consulta por referencia:................................................................................... 14 METODO: consultarSolicitudesPorReferencia( cuentaId, referencia ) ..................................... 15 METODO: obtenerEstadoTransacciones( usuarioId, xml ) ........................................................ 16 OBJETO: XML ............................................................................................................................. 16 3.1.4 Cuando usar los mtodos de consulta ................................................................................. 18 3.1.5 Paginas de Respuesta y Confirmacin: ................................................................................ 18 Pgina de Respuesta: ................................................................................................................ 18 Pgina de confirmacin: ............................................................................................................ 19 3.1.6 Proceso de Pagos con Tarjeta de Crdito............................................................................. 20 Figura 2: Diagrama de Flujo pagos con Tarjeta de Crdito ....................................................... 20 3.1.6.1 Descripcin de mtodos para el pago con tarjeta de crdito sin Device Fingerprint. ...... 22 METODO: solicitarAutorizacion( solicitudAutorizacionWS ) ..................................................... 22 OBJETO: SolicitudAutorizacionWS ............................................................................................ 22 OBJETO: AutorizacionWS .......................................................................................................... 24 3.1.6.2 Descripcin de mtodos para el pago con tarjeta de crdito usando Device Fingerprint. ....................................................................................................................................................... 25 METODO: solicitarAutorizacionConSessionId (SolicitudAutorizacionWS solicitudAutorizacion, String sessionId) ........................................................................................................................ 25 OBJETO: SolicitudAutorizacionWS ............................................................................................ 25
OBJETO: AutorizacionWS .......................................................................................................... 26 3.1.7 Proceso de Transacciones con PSE....................................................................................... 29 Figura 3: Diagrama de Flujo pagos con PSE............................................................................... 29 3.1.7.1 Descripcin de mtodos para el pago con PSE. ................................................................ 30 METODO: leerBancosPse( usuarioId ) ....................................................................................... 30 OBJETO: BancoPseWS ............................................................................................................... 30 METODO: iniciarTransaccionPseConInformacionAdicional (TransaccionPseConInformacionAdicionalWS) ......................................................................... 31 OBJETO: TransaccionPseConInformacionAdicionalWS ............................................................. 31 3.1.8 Proceso de pago con Pago Referenciado ............................................................................. 33 Figura 4: Diagrama de Flujo pagos con Pago Referenciado ...................................................... 33 3.1.8.1 Descripcin de mtodos para el pago Referenciado ........................................................ 34 METODO: solicitarAutorizacionPagoReferenciado(solicitudAutorizacionPagoReferenciado) . 34 OBJETO: SolicitudAutorizacionPagoReferenciadoWS ............................................................... 34 3.1.9 Proceso de Pagos Recurrentes ............................................................................................. 36 Figura 5. Diagrama de flujo Pagos Recurrentes ........................................................................ 36 3.1.9.1 Descripcin de mtodos para el pago Recurrente ............................................................ 37 METODO: solicitarAutorizacionRecurrente( SolicitudAutorizacionRecurrenteWS ) ................ 37 OBJETO: SolicitudAutorizacionRecurrenteWS .......................................................................... 38 OBJETO: AutorizacionRecurrenteWS ........................................................................................ 39 METODO: consultarEstadoSolicitudRecurrente( cuentaId, solicitudRecurrenteId) ................. 40 OBJETO: EstadoSolicitudRecurrenteWS .................................................................................... 40 METODO: reIntentarSolicitudPagoRecurrente( cuentaId, solicitudPagoRecurrenteId ) .......... 41 METODO:................................................................................................................................... 42 actualizarSolicitudPagoRecurrente( cuentaId, solicitudPagoRecurrenteId, cuotas, tarjeta ) ... 42 METODO: cancelarSolicitudPagoRecurrente( cuentaId, solicitudPagoRecurrenteId ) ............. 42 3.1.10 Proceso de Pago de las Agencias de Viajes ........................................................................ 43 Figura 6. Diagrama de Flujo Transacciones Agencia de Viajes .................................................. 43 METODO: leerAerolineas() ........................................................................................................ 45 OBJETO: AerolineaWS ............................................................................................................... 45 METODO: solicitarAutorizacionTA( SolicitudAutorizacionTAWS ) ............................................ 45 OBJETO: SolicitudAutorizacionTAWS ........................................................................................ 46
OBJETO: AutorizacionTAWS ...................................................................................................... 47 3.2 Otros Objetos Disponibles....................................................................................................... 48 OBJETO: TarjetaCreditoWS ....................................................................................................... 48 OBJETO: PagosonlineWSFault ................................................................................................... 49 CAPITULO 4 Pruebas ......................................................................................................................... 50 4.1 Pruebas con Tarjetas de Crdito: ............................................................................................ 50 4.2 Pruebas con PSE: ..................................................................................................................... 52 CAPITULO 6. Como revisar las transacciones en nuestro sistema .................................................... 55 CAPITULO 7. Como pasar a produccin ............................................... Error! Marcador no definido. ANEXOS ............................................................................................................................................. 57 A1. Cdigos de las franquicias para enviar a Pagosonline ............................................................ 57 A2. Estados de las transacciones en Pagosonline ......................................................................... 57 A3. Cdigos de respuesta de Pagosonline (codigoRespuesta) ...................................................... 58 A4. Estados de las solicitudes de pago recurrente........................................................................ 59 A5. Medios de Pago....................................................................................................................... 59 A6. Tipo Medio de Pago ................................................................................................................ 59 A7. Cdigos VISA de las aerolneas ............................................................................................... 60 A7 Divisas admitidas...................................................................................................................... 61 A8 Tipo de documento para PSE ................................................................................................... 61 GLOSARIO .......................................................................................................................................... 62
CAPITULO 1. Descripcin de la aplicacin
Pagosonline ofrece un WebService que permite procesar pagos con: Tarjetas de Crdito - Pagos recurrentes:
PSE (cuentas de ahorro y corrientes):
Pago Referenciado o formato de pago con Cdigo de barras:
El comercio puede desarrollar una aplicacin en cualquier lenguaje de programacin que soporte WebServices (Java, PHP, MS .NET), de igual forma el hosting del comercio, debe soportar esta tecnologa.
Se utilizan diferentes recursos para garantizar la seguridad de la comunicacin entre los usuarios y Pagosonline: Confidencialidad de la informacin: Utilizamos SSL; de esta forma la informacin viaja cifrada por el protocolo HTTPS. Integridad de la informacin: Utilizamos WS-Security; todos los mensajes contienen una firma digital, de tal forma que se puede detectar si el mensaje fue modificado luego de ser enviado por el cliente. En tal caso, se rechaza la peticin. Autenticidad de la informacin: Utilizamos dos mecanismos; 1) WS-Security: se verifica que la firma digital sea de confianza. 2) Pagosonline puede saber cules son las cuentas que estn autorizadas para cada firma digital. De esta forma, aunque un cliente tenga una firma digital autorizada, no podr solicitar peticiones relacionadas a cuentas que no le pertenecen. Todos los aspectos de seguridad aplican tanto para los mensajes que van del cliente a Pagosonline como para los mensajes de respuesta de Pagosonline al cliente. En la integracin con WebService, la captura de datos para realizar la transaccin se realiza en el sitio web del comercio, por lo tanto debe brindar la seguridad necesaria para la captura y envo de los datos hacia Pagosonline; Por lo cual deber tener un tipo de autentificacin e implementar el certificado SSL (HTTPS) para el formulario de tarjetas de crdito, provisto por una autoridad certificadora. Para la utilizacin del WebServices de Pagosonline pueden implementarse dos tipos de autenticacin y dependiendo de la tecnologa de desarrollo utilizada as:
Tipo de autenticacin Tecnologa JAVA Username Token Username Token con TimeStamp X X MS .NET PHP X SI SI Filtrado
Segn la tecnologa que se desee usar se deben tener las siguientes herramientas:
JAVA AXIS 1.2 WSS4J.JAR WSDL4J.JAR MS .NET Visual Studio 2005 / 2008 WSE 3.0 PHP NUSOAP
CAPITULO 2. Como obtener los datos de acceso al WebServices
Para cualquier tipo de integracin lo primero que debe hacer el Comercio, es obtener una cuenta con Pagosonline, de esta forma obtendr una identificacin nica para el Comercio ante Pagosonline (usuarioId), esta permitir la autenticacin con el WebService, al usar UsernameToken, tambin para el consumo de algunos mtodos obtendr una cuentaId, la cual se utiliza como parmetro adicional para algunos mtodos. Tan pronto se crea una cuenta en Pagosonline se enva un correo electrnico con el nmero del usuario y datos para ingresar al mdulo administrativo, sin embargo esta cuenta no tendr acceso al sistema de pruebas inmediatamente, debido a procedimientos internos que se deben ejecutar antes de realizar pruebas. Para ingresar al mdulo administrativo en produccin debe entrar a la siguiente URL: https://secure.pagosonline.net/
Una vez ingrese a este mdulo debe entrar a la pestaa Opciones, donde visualizar la Llave para realizar encripciones, la cual usar en las pginas de Confirmacin y Respuesta, las cuales se explican ms adelante.
Si ha perdido la contrasea, podr volver a adquirirla oprimiendo en Olvid su clave? all digitar el usuario de acceso (generalmente este usuario es el correo que se registr en el sistema de Pagosonline al adquirir su cuenta). Y pulsamos en el botn Enviar
Tan pronto haga este paso recibir un correo, a veces puede ir al correo no deseado por lo tanto debe revisarse esta carpeta tambin. En este correo encontrar un enlace para activar la clave que fue enviada en este correo, como se ve a continuacin:
Nota Importante: Una vez se inicie el contacto tcnico, podrn solicitar a su ingeniero asignado la configuracin del UsernameToken para iniciar las pruebas.
Al realizar la activacin, podremos usar la nueva contrasea que fue enviada al correo. El sistema nos pedir actualizar la contrasea. Para que esta nueva contrasea sea permitida debe cumplir unos requisitos mnimos, sabremos que los cumplimos cuando en la parte inferior del campo de texto haya una barra verde con la descripcin Fuerte. Por facilidad podemos agregarle a la contrasea que recibimos algunos caracteres. Ejemplos de claves validas teniendo en cuenta que la recibida en el correo fue:
X0GMILP@rnP$uo1
X0GMILP@rnP$uoabc
X0GMIL@rnP$uopruebas ABC!#abc123
Para ingresar al mdulo administrativo en el ambiente pruebas https://secure2.pagosonline.net/ , debe solicitar de nuevo una contrasea, la cual es diferente a la anterior. Esto le permitir revisar las transacciones realizadas en el ambiente de pruebas (gateway2).
CAPITULO 3. Descripcin y Uso de Mtodos

A continuacin, se describen los mtodos bsicos para desarrollar un cliente WebService. Muchos desarrolladores experimentados en WebService pueden realizar la aplicacin de cualquier forma, siempre y cuando cumpla algunos requisitos bsicos. En el captulo 4, explicaremos cmo realizar pruebas con todos los medios de pago disponibles en nuestra plataforma. En el captulo 5, como revisar las transacciones desde el panel administrativo, y verificar que las transacciones de prueba se estn realizando bien. En el captulo 6, se explica cmo pasar a produccin. Para iniciar con el proceso de integracin puede realizar los siguientes pasos principales: 1. Obtener la estructura WSDL que describe los mtodos y objetos publicados por el WebService. El archivo se encuentra alojado en las siguientes direcciones dependiendo de la tecnologa que se utilice:
Tecnologa MS .NET con UsernameToken JAVA o PHP con UsernameToken Url https://gateway2.pagosonline.net/ws/WebServicesClientesUTTS?wsdl https://gateway2.pagosonline.net/ws/WebServicesClientesUT?wsdl
2. Generar el esqueleto de la aplicacin a partir del archivo WSDL (Dependiendo del lenguaje
de programacin usado se implementa de formas diferentes).
3. Modificar el esqueleto generado para implementar la seguridad con WS-Security, para

UsernameToken (Este paso generalmente aplica solo en JAVA)
4. Utilizar el servicio. Crear los objetos con los datos de la peticin y recibir los objetos de
respuesta (Para MS .NET y JAVA se genera de forma automtica esta estructura).
3.1 Descripcin de los mtodos y objetos disponibles para los diferentes medios de pago
A partir de aqu, explicaremos cada uno de los mtodos disponibles, y los diferentes medios de pago donde se deben utilizar. Inicialmente, se utiliza un sencillo mtodo para verificar la comunicacin entre el cliente que se est desarrollando y el WebService de Pagosonline.
METODO: getVersion()
Es un mtodo sencillo, que retorna una cadena con la versin actual del WebService Pagosonline. Tambin sirve para probar que la conexin est funcionando de manera adecuada. Se recomienda hacer uso de este mtodo para validar conectividad con Pagosonline antes de hacer uso de mtodos transaccionales. Retorna: Una cadena con la versin actual del sistema. En caso de ocurrir un error retorna un mensaje informando sobre el error.
3.1.1 Mtodos WebServices Y Objetos METODO: leerMediosPagoActivos( usuarioId )

Este mtodo permite consultar los medios de pago activos que tiene un cliente. De esta forma se puede saber que opciones de pago mostrarle al comprador (Tarjetas de crdito, PSE, Etc.).
Retorna: Un arreglo de objetos de la clase MedioPagoWS con los datos de cado uno de los medios de pago disponibles para el usuario. Lanza: Una excepcin PagosonlineWSFault en caso de que no sea posible consultar los medios de pago activos asociados al identificador del usuario.
OBJETO: MedioPagoWS
Este objeto representa un medio de pago en el sistema. Se utiliza principalmente para determinar qu medios de pago activos tiene su comercio. Este objeto tiene el campo tipoMedioPagoId que indica a qu tipo de medio de pago pertenece (Tarjetas de crdito, PSE, Referenciado), el campo medioPagoId que indica a cual es el medio de pago (Visa, Mastercard, PSE, etc..) y por ltimo la descripcin. Los valores que pueden tomar los campos medioPagoId y tipoMedioPagoId se describen en los Anexos A5 y A6 respectivamente.
Estructura:
Campo medioPagoId tipoMedioPagoId descripcion Tipo N N A Descripcin El identificador del medio de pago. (Anexo A5) El identificador del tipo de medio de pago. (Anexo A6) La descripcin del medio de pago.
A travs de la integracin WebServices se pueden implementar diferentes medios de pago, tarjetas de crdito, PSE y Pago Referenciado Cdigo de barras.
3.1.2 Mtodos para consulta de transacciones

A continuacin se describen los diferentes mtodos para verificar el estado de las transacciones, los cuales podr utilizar segn la necesidad de su sistema, u opcionalmente podr complementar la confirmacin de los pagos con el uso de una pgina de confirmacin lo cual podr valorar su uso con el su ingeniero asignado de Pagosonline.
METODO: consultarEstadoTransaccion( cuentaId, transaccionId )

Este mtodo nos permite consultar los diferentes estados de una transaccin (ver Anexo A2), siempre y cuando se conozca la transaccionId, que es generada por Pagosonline en el objeto de retorno
EstadoTransaccionWS. Y solo permite solicitar una transaccin por llamado al WebService Pagosonline. Parmetros de entrada:
Campo cuentaId transaccionId Tipo N N Descipcin Cuenta secundaria para acceso a WebServices Identificador de cada Transaccin que entra a Pagosonline, la cual es generada Internamente por nuestro sistema.
Retorna : Objeto de tipo EstadoTransaccionWS, contiene todos los datos de la transaccin solicitada (referencia, valor, IVA , etc..)
OBJETO: EstadoTransaccionWS En este objeto se contiene toda la informacin de la transaccin solicitada (referencia,
valor, IVA, etc.).
Estructura
Campo transaccionId cuentaId estadoId referencia codigoRespuesta codigoAutorizacion riesgo* valor Iva baseDevolucionIva valorAdicional codigoAerolinea extra1 rxtra2 fechaProcesamiento codigoError* mensajeError** Tip N N N A N N N N N N N N A A F N A Descripcin El nmero (id) de la transaccin en Pagosonline. El nmero (id) de la cuenta del usuario en Pagosonline. El estado en el que se encuentra la transaccin (Anexo A4). La referencia de la solicitud de pago correspondiente. El cdigo de respuesta de Pagosonline (Anexo A3). El cdigo de autorizacin generado por el banco. El ndice de riesgo de la solicitud (0 bajo - 1 alto). El valor de la transaccin. El valor del IVA de la transaccin. El valor de la base de devolucin del IVA de la transaccin El valor adicional de la transaccin. El cdigo de la aerolnea segn el Anexo A6. El primer campo libre. El segundo campo libre. La fecha de procesamiento de la transaccin. El cdigo que identifica el error ocurrido (dado el caso). El mensaje del error ocurrido (dado el caso).
*Aplican cuando ocurre algn error procesando la solicitud de pago. ** Tiene sentido si se valid por el mdulo anti fraude, de otro modo siempre es 0.
3.1.3 Mtodos de consulta por referencia:

Cuando se emplean mtodos de consulta de transacciones por referencia, es importante tener en cuenta que cada referencia puede estar relacionada a una o ms transacciones con estados diferentes; este caso puede suceder cuando el comercio permite reintentos de pago, con la misma referencia, por ejemplo:
PagosOnLine S.A. Bogot D.C. PBX. (1) 576 3126 FAX. (1) 6161540 www.pagosonline.com e-mail: info@pagosonline.com
14
referencia
Transacciones transaccionId 100101 100102 102001 transaccionId 1085621 107802 1023362 5226522 1085655 estado 2 5 7 estado 2 5 6 6 4 Desc. Abierta Cancelada Validacin Desc. Abierta Cancelada Rechazada Rechazada Pagada y Abonada Desc. Abierta Pagada y Abonada Pagada y Abonada
Ref_001
Descripcin En este caso, cuando obtenemos el estado de la transaccin en validacin, tambin obtenemos la transaccionId, por lo tanto es necesario consultar recurrentemente esta transaccin usando este mtodo, hasta obtener un estado final.
Ref_002
En esta observamos que de las transacciones hay una en estado 4, por lo tanto, esta referencia no tendr ms transacciones asociadas, y podremos actualizar la base de datos de nuestro comercio.
Ref_003
transaccionId 1099652 1522302 33622001
estado 2 4 4
Este caso nunca se va a presentar, debido a que solo puede existir una transaccin aprobada relacionada a una misma referencia.
Por lo tanto, siempre que usemos estos mtodos, se debe verificar todas las transacciones relacionadas. (Ver Anexo A2).
METODO: consultarSolicitudesPorReferencia( cuentaId, referencia ) Con este mtodo podemos consultar una transaccin por la referencia, la cual es generada del lado del comercio. Es muy til en casos que se pierda comunicacin con el WebService Pagosonline, por cualquier motivo, por lo tanto no se tiene la transaccionId. Hay que tener en cuenta que solo permite consultar una solicitud por llamado al WebService Pagosonline. Parmetros de entrada:
Campo cuentaId Referencia Tipo N A Descripcin Cuenta secundaria para acceso a WebService Referencia de venta, la cual es generada por el Comercio, y debe ser nica para cada transaccin enviada a Pagosonline.
Retorna: Arreglo de objetos de la clase EstadoTransaccionWS[]. En este arreglo se retornan varios objetos, que corresponden a todas las transferencias asociadas a la referencia enviada, con toda la informacin de cada transaccin (valor, IVA, etc.).
METODO: obtenerEstadoTransacciones( usuarioId, xml )

Con este mtodo se puede consultar el estado de mximo 10 transacciones usando la referencia de cada una y en un solo llamado al WebService. A diferencia de los mtodos anteriores, este nos trae como resultado una estructura XML, con datos bsico para identificar el estado actual de cada transaccin. Estructura:
Campo usuarioId xml Tipo N N Descripcin Cuenta principal para acceso a WebService Variable de tipo String con una estructura XML
Retorna: Un objeto de tipo String con una estructura XML, la cual puede ser leda del lado del comercio para identificar el estado de todas las transacciones solicitadas. Estructura XML a enviar en el mtodo: <consultar-estado-por-referencias> <referencia>referencia_1</referencia> <referencia>referencia_2</referencia> ... <referencia>referencia_n</referencia> </consultar-estado-por-referencias>
OBJETO: XML
Un objeto de tipo String con una estructura XML, la cual est descrita debajo y con la que se puede identificar el estado de todas las transacciones solicitadas. Solo si la referencia solicitada existe, la obtendremos en la estructura <solicitud>
Estructura:
<respuesta> <fecha></fecha> <codigo-respuesta></codigo-respuesta> <codigo-error></codigo-error> <mensaje-error></mensaje-error>  <solicitudes> <solicitud> <id></id> <referencia></referencia> <codigo-respuesta-solicitud></codigo-respuesta-solicitud> <estado></estado> </solicitud> </solicitudes> </respuesta>
Descripcin de etiquetas
Etiqueta fecha codigo-respuesta codigo-error mensaje-error id referencia codigo-respuesta-solicitud estado
Descripcin Una fecha en formato: yyyy-MM-dd o HH:mm:ss cdigo exitoso:1 / cdigo fallido:2 cdigo indeterminado: 5000, contacte a Pagosonline El mensaje de error asociado. El Id de la transaccin en Pagosonline. Esta es la misma variable ref_pol enviada en las pginas de confirmacin y respuesta (en integracin tradicional). Esta es la misma variable refVenta enviada a Pagosonline o la misma ref_venta enviada a la pgina de confirmacin y respuesta (en integracin tradicional). Esta variable est codificada de la misma forma que la variable codigo_respuesta_pol. Referirse a la tabl, ver Anexo A3. El id para el estado de la transaccin en Pagosonline. Esta variable est codificada de igual forma que la variable estado_pol, ver Anexo A2.
3.1.4 Cuando usar los mtodos de consulta

Estos son los casos ms relevantes en los cuales se deben usar el llamado de los mtodos de consulta:
Caso
Mtodo
Una transaccin queda en validacin.
consultarEstadoTransaccion
Se pierde comunicacin con el WebServices Pagosonline, mientras se enva una transaccin.
consultarSolicitudesPorReferencia
Propsito En este caso si sabemos que la transaccin queda en validacin, es porque tambin estamos obteniendo la transaccionId, por lo tanto es necesario consultar recurrentemente esta transaccin usando este mtodo, hasta obtener un estado final. En caso de ocurrir esta situacin por cualquier circunstancia, existe la posibilidad que el WebServices s haya procesado nuestra solicitud de pago, por lo tanto, el nico dato que tenemos para verificar esto es la referencia, por lo que podemos usarla con este mtodo, y conocer el estado que tenga en el momento de consultarla, o en caso contrario, verificar que la transaccin no lleg al WebServices. Teniendo en cuenta, que en el Objeto de respuesta podemos conocer la transaccionId y usar el mtodo consultarEstadoTransaccion, para hacerle un seguimiento a la transaccin rpidamente.
3.1.5 Paginas de Respuesta y Confirmacin:
En esta seccin explicaremos que son las pginas de Respuesta Y Confirmacin, las cuales son de uso Opcional y dependiendo del tipo de pago que se va a realizar pueden ser Obligatorias. Para un mayor entendimiento de estas dos pginas recomendamos revisar el manual de Integracin Tradicional en nuestro Portal de ayuda http://ayuda.pagosonline.com/index.php, donde encontrar como usar la llave de inscripcin, para mejorar la seguridad de estas pginas.
Pgina de Respuesta:
Esta es una pgina de carcter informativo, la cual se muestra al usuario al terminar un pago. Es obligatoria en pagos PSE, la cual debe cumplir con los requisitos para la certificacin de ACH. Debido que estos pagos se hacen dentro de los portales de las entidades bancarias, y nuestro WebService no controla el proceso que realiza el usuario en estos sitios, tan solo al terminar un pago, la entidad bancaria retorna al usuario a la URL que el comercio configure como pgina de respuesta, recibiendo una trama de datos por mtodo GET que enva el banco.
PGINA DE RESPUESTA DE EJEMPLO
Pgina de confirmacin:
Esta es una pgina totalmente funcional, que se debe usar para confirmar el resultado de las transacciones, por lo tanto es til para actualizar la Base de datos, y obviamente no es visible para los usuarios, es decir es de uso exclusivo entre Pagosonline y el Comercio, como por ejemplo, cuando una transaccin queda en validacin o en espera por la entidad bancaria, al momento que Pagosonline obtiene una respuesta definitiva (Rechazada / Pagada y Abonada), la pgina de confirmacin es consumida y se enva una trama de datos por mtodo POST. Debe tener en cuenta que esta pgina debe estar en acceso pblico.
3.1.6 Proceso de Pagos con Tarjeta de Crdito Figura 2: Diagrama de Flujo pagos con Tarjeta de Crdito
COMERCIO
leerMediosPagoActivos( )* MedioPagoWS [ ]
2
Captura datos de tarjeta
WebServices PagosOnLine
solicitarAutorizacion( )
3
AutorizacionWS [ ]
Pg. Respuesta
5
CONNECT TO INSERT INTO UPDATE FROM
HTTP POST
Pgina de confirmacin
Correo confirmacin Comercio Correo confirmacin Comprador
(Mtodo de consulta estado Transaccin)*
CRON JOB
(Estado de la transaccin)** [ ]
*Dependiendo del caso, se usa un mtodo de consulta diferente. ** Dependiendo del mtodo usado para consultar la transaccin, traer un objeto diferente.
Para implementar el pago con tarjeta de crdito, inicialmente (1) se deben leer los medios de pago disponibles, (2) de esta peticin recibir todos los medios de pago activos para el comercio. Luego se deben enviar los datos de la transaccin (referencia, valor, IVA, etc.) de la transaccin al WebService de Pagosonline (3). La transaccin es procesada y se devuelve una respuesta inmediata (4), permitiendo al comercio realizar las actualizaciones de bases de datos que necesite, y mostrndole al comprador una pgina de respuesta que puede ser personalizada de acuerdo a las necesidades del comercio; pero no en todos los casos, esta respuesta es definitiva, en algunas ocasiones la transaccin queda en proceso de validacin y requiere de un tiempo mayor para procesarse y tener una respuesta definitiva. Luego que se resuelve la transaccin, existen dos mtodos para informar al comercio sobre el estado final:
1. Pagosonline enva al comercio el estado final de la transaccin por medio de una pgina
de confirmacin (5), lo cual es opcional. En este caso, el comercio debe tener una pgina de confirmacin con una URL pblica, la cual recibe la trama de datos, de la transaccin procesada, que enva Pagosonline por mtodo POST, y en esta, se debe hacer todo el proceso de actualizacin de bases de datos que requiera el comercio (Para mayor informacin del uso de la pgina de confirmacin, remtase al manual de Integracin Tradicional).
2. El comercio puede consultar las veces necesarias en nuestro sistema el estado de la

transaccin (8), e inmediatamente recibe el estado en el momento de la consulta (9), el cual puede mantenerse en validacin por un periodo prolongado, hasta llegar al estado definitivo, de aprobada o rechazada. Luego del proceso de pago, se enva un correo automticamente, al comercio para todas las transacciones (6) y al cliente, siempre y cuando se enva el email del comprador (7), con la informacin del estado final de la transaccin. Esta funcionalidad es opcional, segn las necesidades del comercio.
3.1.6.1 Descripcin de mtodos para el pago con tarjeta de crdito sin Device Fingerprint.
METODO: solicitarAutorizacion( solicitudAutorizacionWS )

Es el mtodo principal para tarjetas de crdito, que permite enviar la solicitud de pago y recibir la respuesta de Pagosonline. Recibe como parmetro un objeto SolicitudAutorizacionWS y retorna un objeto AutorizacionWS. Este objeto de retorno, contiene el atributo codigoRespuesta, el cual identifica el estado de la transaccin, (ver Anexo A3). En algunos casos, al realizar una solicitud de pago, es posible que el proceso se demore mientras se realiza la validacin de los datos de la tarjeta de crdito, ya sea en la misma franquicia o en el mdulo anti fraude de Pagosonline. Para tales casos, se retorna una autorizacin con el cdigo de respuesta '15', como transaccin en proceso de validacin. Posteriormente, se puede examinar el estado de la transaccin (con el mtodo consultarEstadoTransaccion()) para verificar si ya se termin de validar la solicitud de pago. (Ver Anexo A1) Parmetros de entrada
Parmetro solicitudAutorizacion Descripcin El objeto que contiene los datos necesarios para solicitar la autorizacin de la transaccin.
Retorna: objeto AutorizacionWS que contiene los datos de la autorizacin.
OBJETO: SolicitudAutorizacionWS
Este objeto contiene todos los datos de la solicitud de pago, entre los cuales estn el nmero (usuarioId) de la cuenta del usuario en Pagosonline, los datos de descripcin del pago (referencia, valor, IVA, etc), los datos del cliente (nombre, documento, telfono, etc), los datos de la tarjeta de crdito (franquicia, nmero, etc) y algunas opcionales (validar anti fraude, reportar confirmacin). A continuacin se muestra una tabla que describe todos los campos, en la tabla se indica cules campos son requeridos y cules no, sin embargo, se debe enviar la mayor cantidad de datos que sea posible.
Estructura:
Campo cuentaId Referencia descripcion valor iva baseDevolucionIva valorAdicional isoMoneda4217 numeroCuotas nombreComprador documentoIdentificacion emailComprador telefono telefonoOficina paisEnvio ciudadEnvio direccionEnvio franquicia codigoAerolinea** extra1 extra2 numero codigoSeguridad nombreTarjetaHabiente fechaExpiracion validarModuloAntiFraude reportarPaginaConfirmacion Tam. 12 50 255 14,2 14,2 14,2 14,2 3 2 50 25 255 50 50 2 25 255 2 255 255 Req. SI SI SI SI SI SI NO SI SI NO SI SI NO NO NO NO NO SI NO NO NO SI SI SI SI SI NO Descripcin El nmero (ID) de la cuenta del usuario en Pagosonline. La referencia de la venta, debe ser nica por cada solicitud de pago. La descripcin de la venta. El valor total de la venta. El valor del IVA de la venta. El valor de la base de devolucin del IVA de la venta. El valor adicional de la venta. El cdigo ISO de la moneda. El nmero de cuotas. El nombre del comprador. El documento de identificacin del comprador. El correo electrnico del comprador. El telfono nocturno del comprador. El telfono diurno del comprador. El cdigo ISO del pas de la direccin de envo. La ciudad de la direccin de envo. La direccin de envo de la mercanca. El nombre de la franquicia ver Anexo A5, descripcin Ejemplo : VISA El cdigo de la aerolnea segn el Anexo A6. El primer campo libre. El segundo campo libre. El nmero de la tarjeta de crdito. El cdigo de seguridad para tarjetas de crdito. El nombre del dueo de la tarjeta de crdito, tal y como aparece en la misma. La fecha de expiracin de la tarjeta de crdito (AAAA/MM ejemplo 2010/01). (enviar siempre en TRUE )Si se quiere utilizar el mdulo antifraude para validar la solicitud de pago. Si se quiere reportar el resultado de la transaccin a la pgina de confirmacin del usuario. El cdigo ISO del pas de la direccin de correspondencia. La ciudad de la direccin de correspondencia. La direccin de correspondencia de la tarjeta de crdito. La direccin IP del comprador. La cookie del navegador del comprador. El agente del navegador del comprador.
50 20
255
Las siguientes variables son obligatorias para nuestro Modulo Anti Fraude (MAF)
paisCorrespondencia ciudadCorrespondencia direccionCorrespondencia ipComprador cookie userAgent 2 25 255 SI SI SI SI SI SI
** Este campo es obligatorio para Agencia de Viajes y Aerolneas, si no se enva la franquicia no har el cargo al tarjetahabiente por el valor adicional.
OBJETO: AutorizacionWS
Este objeto contiene la respuesta de Pagosonline generada luego de enviar una solicitud de pago. Contiene la referencia de la solicitud de pago, el nmero (ID) de la transaccin en Pagosonline, los cdigos de respuesta (de POL y del banco) y otros datos. A continuacin se muestra una tabla que describe todos los campos.
Campo Referencia transaccionId codigoRespuesta codigoAutorizacion riesgo Valor Iva baseDevolucionIva valorAdicional codigoAerolinea extra1 extra2 fechaProcesamiento codigoError** mensajeError** 2 6 12 12 12 14,2 14,2 2 255 255 20 Tam. 50 Descripcin La referencia de la solicitud de pago correspondiente. El nmero (ID) de la transaccin en Pagosonline El cdigo de respuesta de Pagosonline (Ver Anexo A3). El cdigo de autorizacin generado por el banco. El ndice de riesgo de la solicitud (0 bajo - 1 alto). (S se valida por el modulo anti fraude) El valor de la transaccin. El valor del IVA de la transaccin. El valor de la base de devolucin del IVA de la transaccin. El valor adicional de la transaccin. El cdigo de la aerolnea segn el Anexo A6. El primer campo libre. El segundo campo libre. La fecha de procesamiento de la transaccin. El cdigo que identifica el error ocurrido (dado el caso). El mensaje del error ocurrido (dado el caso).
** Aplican cuando ocurre algn error procesando la solicitud de pago.
3.1.6.2 Descripcin de mtodos para el pago con tarjeta de crdito usando Device Fingerprint.
Para el proceso de implementacin del DFP es necesario que el comercio implemente el mtodo solicitarAutorizacionConSessionId para los pagos con tarjeta de crdito, este mtodo es un mtodo basado en el mtodo tradicional para pagos con tarjeta de crdito solicitarAutorizacion con la diferencia que se debe manejar la sesin web del usuario que est realizando el pago por medio del string sessionId.
METODO: solicitarAutorizacionConSessionId solicitudAutorizacion, String sessionId)
(SolicitudAutorizacionWS
Este mtodo permite enviar la solicitud de pago para tarjetas de crdito junto con la sesin web del usuario pagador para manejar la validacin por Device Fingerprinting y recibir la respuesta de Pagosonline. Recibe como parmetro un objeto SolicitudAutorizacionWS y un string sessionId que contiene la sesin web del usuario, adicionalmente retorna un objeto AutorizacionWS. Este objeto de retorno es el mismo objeto que se obtiene por el mtodo tradicional. Parmetros de entrada
Parmetro solicitudAutorizacion sessionId Tipo SolicitudAutorizacionWS String Descripcin El objeto que contiene los datos necesarios para solicitar la autorizacin de la transaccin. Sesin web del usuario pagador.
Retorna: objeto AutorizacionWS que contiene los datos de la autorizacin.
OBJETO: SolicitudAutorizacionWS
Este objeto contiene todos los datos de la solicitud de pago, entre los cuales estn el nmero (usuarioId) de la cuenta del usuario en Pagosonline, los datos de descripcin del pago (referencia, valor, IVA, etc), los datos del cliente (nombre, documento, telfono, etc), los datos de la tarjeta de crdito (franquicia, nmero, etc) y algunas opcionales (validar anti fraude, reportar confirmacin). A continuacin se muestra una tabla que describe todos los campos, en la tabla se
indica cules campos son requeridos y cules no, sin embargo, se debe enviar la mayor cantidad de datos que sea posible. Estructura:
Campo cuentaId Referencia descripcion valor iva baseDevolucionIva valorAdicional isoMoneda4217 numeroCuotas nombreComprador documentoIdentificacion emailComprador telefonoOficina paisEnvio ciudadEnvio direccionEnvio franquicia codigoAerolinea** extra1 extra2 numero codigoSeguridad nombreTarjetaHabiente fechaExpiracion validarModuloAntiFraude reportarPaginaConfirmacion Tam. 12 50 255 14,2 14,2 14,2 14,2 3 2 50 25 255 50 2 25 255 2 255 255 Req. SI SI SI SI SI SI NO SI SI NO SI SI NO NO NO NO SI NO NO NO SI SI SI SI SI NO Descripcin El nmero (ID) de la cuenta del usuario en Pagosonline. La referencia de la venta, debe ser nica por cada solicitud de pago. La descripcin de la venta. El valor total de la venta. El valor del IVA de la venta. El valor de la base de devolucin del IVA de la venta. El valor adicional de la venta. El cdigo ISO de la moneda. El nmero de cuotas. El nombre del comprador. El documento de identificacin del comprador. El correo electrnico del comprador. El telfono diurno del comprador. El cdigo ISO del pas de la direccin de envo. La ciudad de la direccin de envo. La direccin de envo de la mercanca. El nombre de la franquicia ver Anexo A5, descripcin Ejemplo : VISA El cdigo de la aerolnea segn el Anexo A6. El primer campo libre. El segundo campo libre. El nmero de la tarjeta de crdito. El cdigo de seguridad para tarjetas de crdito. El nombre del dueo de la tarjeta de crdito, tal y como aparece en la misma. La fecha de expiracin de la tarjeta de crdito (AAAA/MM ejemplo 2010/01). (enviar siempre en TRUE )Si se quiere utilizar el mdulo antifraude para validar la solicitud de pago. Si se quiere reportar el resultado de la transaccin a la pgina de confirmacin del usuario. El cdigo ISO del pas de la direccin de correspondencia. La ciudad de la direccin de correspondencia. La direccin de correspondencia de la tarjeta de crdito. La direccin IP del comprador. La cookie del navegador del comprador. El agente del navegador del comprador. El telfono nocturno del comprador.
50 20
255
Las siguientes variables son obligatorias para nuestro Modulo Anti Fraude (MAF)
paisCorrespondencia ciudadCorrespondencia direccionCorrespondencia ipComprador cookie userAgent telefono 2 25 255 SI SI SI SI SI SI SI
50
** Este campo es obligatorio para Agencia de Viajes y Aerolneas, si no se enva la franquicia no har el cargo al tarjetahabiente por el valor adicional.
OBJETO: AutorizacionWS
Este objeto contiene la respuesta de Pagosonline generada luego de enviar una solicitud de pago. Contiene la referencia de la solicitud de pago, el nmero (ID) de la transaccin en Pagosonline, los
cdigos de respuesta (de POL y del banco) y otros datos. A continuacin se muestra una tabla que describe todos los campos.
Campo Referencia transaccionId codigoRespuesta codigoAutorizacion riesgo Valor Iva baseDevolucionIva valorAdicional codigoAerolinea extra1 extra2 fechaProcesamiento codigoError** mensajeError**
Tam. 50
Descripcin La referencia de la solicitud de pago correspondiente. El nmero (ID) de la transaccin en Pagosonline
2 6 12 12 12 14,2 14,2 2 255 255 20
El cdigo de respuesta de Pagosonline (Ver Anexo A3). El cdigo de autorizacin generado por el banco. El ndice de riesgo de la solicitud (0 bajo - 1 alto). (S se valida por el modulo anti fraude) El valor de la transaccin. El valor del IVA de la transaccin. El valor de la base de devolucin del IVA de la transaccin. El valor adicional de la transaccin. El cdigo de la aerolnea segn el Anexo A6. El primer campo libre. El segundo campo libre. La fecha de procesamiento de la transaccin. El cdigo que identifica el error ocurrido (dado el caso). El mensaje del error ocurrido (dado el caso).
** Aplican cuando ocurre algn error procesando la solicitud de pago. Adicionalmente es necesario que el comercio incluya el siguiente cdigo en la pgina donde el comprador ingresa sus datos de pago (es decir donde se encuentra localizado el formulario de datos del tarjetahabiente),
<p style="background:url(https://maf.pagosonline.net/ws/fp?id=${sessionId}usuarioId)"></p> <img src="https://maf.pagosonline.net/ws/fp/clear.png?id=${sessionId}usuarioId"> <script src="https://maf.pagosonline.net/ws/fp/check.js?id=${sessionId}usuarioId"></script> <object type="application/x-shockwave-flash" data="https://maf.pagosonline.net/ws/fp/fp.swf?id=${sessionId}usuarioId" width="1" height="1" id="thm_fp"> <param name="movie" value="https://maf.pagosonline.net/ws/fp/fp.swf?id=${sessionId}usuarioId" /> </object>
el cdigo debe ir en cualquier lugar en medio de <body></body>. Dentro de este cdigo es necesario que se modifique manualmente el parmetro usuario_id por el nmero de la cuenta asociada al comercio dentro de PagosOnline, de pendiendo de si el comercio tiene id en MAF o no. Si el comercio tiene id en MAF el usuario Id que se debe enviar es el usuario id en PagosOnline, pero si el comercio no tiene id en MAF se debe enviar como usuario Id el valor 1 que corresponde a PagosOnline. Por ejemplo en el caso que el comercio tenga Id en MAF y su usuarioId en PagosOnline sea 38695 y la sessionId sea kajshfjkashfkash3287e98fhfsiuw9d, el cdigo generado debe ser:
<p style="background:url(https://maf.pagosonline.net/ws/fp?id=kajshfjkashfkash3287e98fhfsiuw9d38695)"> </p> <img src="https://maf.pagosonline.net/ws/fp/clear.png?id=kajshfjkashfkash3287e98fhfsiuw9d38695"> <script src="https://maf.pagosonline.net/ws/fp/check.js?id=kajshfjkashfkash3287e98fhfsiuw9d38695"></script> <object type="application/x-shockwave-flash" data="https://maf.pagosonline.net/ws/fp/fp.swf?id=kajshfjkashfkash3287e98fhfsiuw9d38695" width="1" height="1" id="thm_fp"> <param name="movie" value="https://maf.pagosonline.net/ws/fp/fp.swf?id=kajshfjkashfkash3287e98fhfsiuw9d38695" /> </object>
Para realizar pruebas en ambiente de Staging de PagosOnline es necesario reemplazar en las url del cdigo anterior maf.pagosonline.net por pruebas.maf.pagosonline.net quedando de la siguiente manera:
<p style="background:url(https://maf.pagosonline.net/ws/fp?id=${sessionId}usuarioId)"></p> <img src="https://maf.pagosonline.net/ws/fp/clear.png?id=${sessionId}usuarioId"> <script src="https://maf.pagosonline.net/ws/fp/check.js?id=${sessionId}usuarioId"></script> <object type="application/x-shockwave-flash" data="https://maf.pagosonline.net/ws/fp/fp.swf?id=${sessionId}usuarioId" width="1" height="1" id="thm_fp"> <param name="movie" value="https://maf.pagosonline.net/ws/fp/fp.swf?id=${sessionId}usuarioId" /> </object>
3.1.7 Proceso de Transacciones con PSE Figura 3: Diagrama de Flujo pagos con PSE
leerMediosPagoActivos( )*
2 1
MedioPagoWS [ ] leerBancosPse( ) BancoPseWS [ ]

3
Lista de bancos
iniciarTransaccionPseConInformacionAdicional ( )
5
TransaccionPseConInformacionAdicionalWS
TransaccionPseWS usuarioId pseReferencia1 . . urlPaginaPagosBanco
Redirect HTTP POST 7 urlPaginaPagosBanco
Pgina de respuesta
Redirect HTTP GET Pg. Respuesta
(Comprobante de pago)
HTTP POST
9
Correo confirmacin Comercio

10
Correo confirmacin Comprador

11
(Mtodo de consulta estado Transaccin)
12
CRON JOB
13
(Estado de la transaccin) [ ]
* El mtodo leerMediosPagoActivos() debe ser llamado una vez al da, con el fin de minimizar el uso de los recursos del servidor, en el arreglo de objetos devueltos por este mtodo se especifican todos los mtodos de pago activos y estos sern los que se despliegan en la pagina del cliente.
Para realizar transacciones con cuentas de ahorro o corrientes, se debe invocar inicialmente el mtodo (1) leerMediosPagoActivos(), y verificar que efectivamente se tiene activo el medio de pago PSE (Ver Anexo A5). Luego se debe leer la lista de bancos del sistema PSE (3) y se prosigue con el desarrollo normal del proceso como se describi para tarjetas de crdito. Para utilizar este medio de pago es importante tener en cuenta que se debe hacer una certificacin del sitio web ante ACH. (Remitirse al manual de certificacin PSE)
3.1.7.1 Descripcin de mtodos para el pago con PSE. METODO: leerBancosPse( usuarioId )
Se utiliza para obtener la lista de todos los bancos que permiten pagos con cuentas corrientes y de ahorro a travs del sistema PSE. La lista contiene objetos de tipo BancoPseWS.
Parmetros de entrada:
Parmetro usuarioId Tipo N Descripcin El identificador de la cuenta del usuario en el sistema.
Retorna: Un arreglo de objetos BancoPseWS[] con los datos de cada uno de los bancos disponibles para realizar el pago. Lanza: Una excepcin PagosonlineWSFault en caso de que no sea posible consultar la lista de bancos.
OBJETO: BancoPseWS
Este objeto contiene los datos bsicos de los bancos habilitados, para pagos con PSE. A continuacin se muestra una tabla que describe todos los campos del objeto.
Estructura:
Campo codigoPse descripcin Tipo N A Descripcin El cdigo del banco en PSE. El nombre del banco.
METODO: iniciarTransaccionPseConInformacionAdicional (TransaccionPseConInformacionAdicionalWS)

Es el mtodo principal para realizar pagos con cuentas corrientes o ahorro y permite iniciar una transaccin por medio de PSE. Recibe como parmetro de entrada un objeto de la clase TransaccionPseConInformacionAdicionalWS y retorna un objeto del mismo tipo con los datos actualizados. Si se pudo iniciar la transaccin satisfactoriamente, el objeto retornado contiene la URL del banco a la cual se debe direccionar el comprador para que contine el proceso de pago. Posteriormente, se puede examinar el estado de la transaccin (con el mtodo consultarEstadoTransaccion() ) para ver si ya se termin de procesar la solicitud de pago.
Parmetro TransaccionPseWs
Descripcin El objeto que contiene los datos necesarios para iniciar una transaccin con PSE dentro de los cuales se encuentra el cdigo del banco y el tipo de cliente.
Retorna: El objeto TransaccionPseConInformacionAdicionalWS con los datos actualizados para poder realizar la transaccin directamente en el banco. Lanza: Una excepcin PagosonlineWSFault en caso de que no sea posible iniciar la transaccin PSE.
OBJETO: TransaccionPseConInformacionAdicionalWS
Este objeto contiene todos los datos de la solicitud de pago con cuentas de ahorro o corriente, que se va a enviar a Pagosonline, entre los cuales estn el nmero (ID) de la cuenta del usuario en Pagosonline, los datos de descripcin del pago (referencia, valor, IVA, etc), los datos del comprador (nombre, documento, telfono, etc), el cdigo del banco en PSE y otros datos. A continuacin se muestra una tabla que describe todos los campos.
Estructura:
Campo usuarioId cuentaId referencia descripcin Valor iva emailComprador direccionIpComprador nombreComprador telefonoComprador cookie agenteNavegador urlRespuesta urlConfirmacion extra1 extra2 codigoBancoPse tipoCliente Id codigoPse urlPaginaPagosBanco pseReferencia1 pseReferencia2 pseReferencia3 Tam. 12 12 50 255 12 12 255 255 255 255 Req. SI NO SI SI SI SI SI SI SI SI SI SI SI NO NO SI SI NO* NO* NO* SI SI SI Descripcin El nmero (id) del usuario en Pagosonline. El nmero (id) de la cuenta del usuario en Pagosonline. La referencia de la venta, debe ser nica por cada solicitud de pago. La descripcin de la venta. El valor total de la venta. El valor del IVA de la venta. El email del comprador. La direccin IP del comprador. El nombre del comprador El telfono del comprador La cookie del comprador. El agente del navegador del comprador. La pgina adonde se debe enviar al comprador despus de finalizada la transaccin. La pgina de confirmacin adonde se debe enviar la informacin del pago. El primer campo extra. El segundo campo extra. El cdigo del banco PSE. El tipo de cliente. N si es natural y J si es jurdico. El nmero (id) de la transaccin en Pagosonline. El cdigo PSE de la transaccin. La URL a donde debe ser direccionado el usuario IP pblica del comprador ejemplo : 190.186.5.56 Tipo de documento ( Cedula, Tarjeta de identidad, ect ver Anexo A8) Documento de identidad ( sin guiones o punto, solo numrico )
255 255 255 255
255
* Estos campos son enviados por Pagosonline, en la respuesta al mtodo iniciarTransaccionPseConInformacionAdicional()
Finalmente si se desea, se puede consultar el estado de la transaccin, utilizando el mtodo consultarEstadoTransaccion(), descrito anteriormente.
3.1.8 Proceso de pago con Pago Referenciado
Figura 4: Diagrama de Flujo pagos con Pago Referenciado
COMERCIO
leerMediosPagoActivos( ) MedioPagoWS [ ]
Cdigo de Barras
solicitarAutorizacionPagoReferenciado( ) AutorizacionPagoReferenciado[ ]
El pago referenciado es el pago que se realiza a travs de un formato con cdigo de barras. Para implementar este medio de pago, se requiere iniciar leyendo los medios de pago y validar que se tenga activo este medio de pago, luego se debe generar la transaccin y Pagosonline devuelve la URL del comprobante de pago que el usuario deber imprimir y acercarse a pagar en la entidad bancaria correspondiente. Es importante aclarar que para los pagos realizados con Pago Referenciado, el sistema de Pagosonline no realiza ningn tipo de confirmacin, ya que las entidades bancarias no nos informan cuando se hacen efectivos los pagos. Para que los datos de las transacciones realizadas por este medio de pago estn actualizados en el modulo administrativo de Pagosonline (https://secure.pagosonline.net), se debe subir el reporte Aso-bancaria que genera su banco. Es posible que luego de subir este reporte, se deba consultar el estado de las transacciones, para actualizar el estado final.
3.1.8.1 Descripcin de mtodos para el pago Referenciado METODO: solicitarAutorizacionPagoReferenciado(solicitudAutorizacionPagoReferenciado)

Es el mtodo principal para pagos referenciados, que permite enviar la solicitud de pago y recibir la respuesta de Pagosonline. Recibe y como parmetro un un objeto objeto
SolicitudAutorizacionPagoReferenciadoWS
retorna
AutorizacionPagoReferenciadoWS. Con este medio de pago, es responsabilidad del comercio descargar los pagos del banco y subirlos al modulo administrativo de Pagosonline para que se actualice el estado pendiente de pago banco. Posteriormente, se puede examinar el estado de la transaccin (con el mtodo consultarEstadoTransaccion()) para verificar si ya se termin de validar la solicitud de pago. Parmetros de entrada:
Parmetro solicitudAutorizacionPagoReferenciadoWS Descripcin El objeto que contiene los datos necesarios para solicitar la autorizacin de la transaccin.
Retorna: Un objeto AutorizacionPagoReferenciadoWS que contiene los datos de la autorizacin y la URL donde se genera el comprobante de pago HTML y PDF. En caso de ocurrir un error el mtodo retorna el objeto AutorizacionPagoReferenciadoWS con el cdigo de respuesta 9999, error inesperado y en el campo cdigo de error, el cdigo de error interno generado por el sistema.
OBJETO: SolicitudAutorizacionPagoReferenciadoWS
Este objeto contiene todos los datos de la solicitud de pago con cdigo de barras que se va a enviar a Pagosonline, entre los cuales estn el nmero (usuarioId) de la cuenta del usuario en Pagosonline, los datos de descripcin del pago (referencia, valor, IVA, etc), los datos del cliente (nombre, documento, telfono, etc) y algunas opciones (validar anti fraude, reportar confirmacin). A continuacin se muestra una tabla que describe todos los campos, en la tabla se indica cules campos son requeridos y cules no, sin embargo, se debe intentar enviar la mayor cantidad de datos que sea posible.
Estructura:
Campo referencia transaccionId codigoRespuesta riesgo* Valor Iva baseDevolucionIva valorAdicional codigoAerolinea extra1 extra2 fechaProcesamiento urlComprobantePdf urlComprobanteHtml codigoError** mensajeError** Tam. 50 2 12 12 12 14,2 14,2 2 255 255 20 Descripcin La referencia de la solicitud de pago correspondiente. El nmero (ID) de la transaccin en Pagosonline El cdigo de respuesta de Pagosonline (Ver Anexo A3). El ndice de riesgo de la solicitud (0 bajo - 1 alto). El valor de la transaccin. El valor del IVA de la transaccin. El valor de la base de devolucin del IVA de la transaccin. El valor adicional de la transaccin. El cdigo de la aerolnea segn el Anexo A6. El primer campo libre. El segundo campo libre. La fecha de procesamiento de la transaccin. URL para mostrar el comprobante de pago y permitir la descarga del archivo en formato PDF URL para mostrar el comprobante de pago El cdigo que identifica el error ocurrido (dado el caso). El mensaje del error ocurrido (dado el caso).
*Tiene sentido si se valid por el mdulo anti fraude, de otro modo siempre es 0. ** Aplican cuando ocurre algn error procesando la solicitud de pago.
3.1.9 Proceso de Pagos Recurrentes
Figura 5. Diagrama de flujo Pagos Recurrentes
COMERCIO
leerMediosPagoActivos( )* MedioPagoWS [ ]
Captura datos TC
WebServices PagosOnLine solicitarAutorizacionRecurrente ( ) AutorizacionRecurrenteWS [ ]
Solicitud Pago Recurrent e
HTTP POST
(Mtodo de consulta estado Transaccin)*
CRON JOB
(Estado de la transaccin)** [ ]
Un pago recurrente es pago que se programa para ser realizado peridicamente, pero que solo est habilitado para transacciones con tarjetas de crdito. Para implementar este tipo de pagos, se debe disear un formulario con algunos datos adicionales a los normales - fecha primer pago, numero de pagos y periodicidad (cada cuanto se debe generar el pago automticamente).
Cuando se genera una solicitud de pago recurrente, los datos de la transaccin son almacenados en una base de datos en PagosOnLine y cada vez que se cumple una periodicidad se genera una nueva transaccin. Este proceso se repite tantas veces como numero de pagos se hayan definido en la solicitud de pago recurrente.
3.1.9.1 Descripcin de mtodos para el pago Recurrente METODO: solicitarAutorizacionRecurrente( SolicitudAutorizacionRecurrenteWS )

Es el mtodo principal para los pagos recurrentes con tarjetas de crdito. Permite enviar la solicitud de pago recurrente y recibir la respuesta de Pagosonline. Recibe como parmetro de entrada un objeto de tipo SolicitudAutorizacionRecurrenteWS y retorna un objeto AutorizacionRecurrenteWS. En algunos casos, al realizar una solicitud de pago recurrente, es posible que el proceso se demore mientras se realiza la validacin de los datos de la tarjeta de crdito, ya sea en los mismos bancos o en el mdulo anti fraude de Pagosonline. En tales casos, se retorna una autorizacin con el cdigo de respuesta transaccin en proceso de validacin. Posteriormente, se puede examinar el estado de la transaccin (con el mtodo consultarEstadoSolicitudRecurrente()) para ver si ya se termin de validar la solicitud de pago recurrente. Parmetros de entrada:
Parmetro SolicitudAutorizacionRecurrenteWS Descripcin El objeto que contiene los datos necesarios para solicitar la autorizacin de una solicitud de pago recurrente.
Retorna: El objeto AutorizacionRecurrenteWS con el resultado de la transaccin. En caso de solicitar la autorizacin de manera inmediata, el objeto AutorizacionRecurrenteWS contiene un objeto autorizacionPrimerPago de la clase AutorizacionWS, que corresponde a la autorizacin del primer pago, que se puede encontrar aprobado, rechazado o en proceso de validacin.
OBJETO: SolicitudAutorizacionRecurrenteWS
Este objeto contiene todos los datos de la solicitud de pago recurrente por tarjeta de crdito que se va a enviar a Pagosonline, entre los cuales estn el usuarioId , los datos de descripcin del pago recurrente (referencia, nmero de pagos, intervalo entre pagos, etc), los datos de cada pago (valor, IVA, etc), los datos del cliente (nombre, documento, telfono, etc), los datos de la tarjeta de crdito (franquicia, nmero, etc) y algunas opciones (validar anti fraude, reportar confirmacin). En el Anexo A6 se muestra una tabla que describe todos los campos:
Estructura:
Campo cuentaId Referencia Descripcin conPagoInmediato fechaPrimerPago numeroPagos tipoIntervaloEntrePagos numeroIntervalosEntrePagos isoMoneda4217 conPagosDiferentes valorPrimerPago ivaPrimerPago baseDevolucionIvaPrimerPago valorAdicionalPrimerPago Valor Iva baseDevolucionIva valorAdicional numeroCuotas nombreComprador documentoIdentificacion emailComprador Telfono telefonoOficina paisCorrespondencia ciudadCorrespondencia direccionCorrespondencia paisEnvio ciudadEnvio direccionEnvio ipComprador Cookie userAgent Franquicia codigoAerolinea extra1 extra2 Numero nombreTarjetaHabiente fechaExpiracion validarManualmente Tam. 12 50 255 10 2 1 3 Req. S S S NO NO* S S S S NO NO** NO** NO** NO S S S NO S NO NO SI NO NO NO NO NO NO NO NO S NO NO S NO NO NO S S S NO Descripcin El nmero (ID) de la cuenta del usuario en Pagosonline. La referencia de la venta, debe ser nica por cada solicitud de pago. La descripcin de la venta. Indica si el primer pago se debe realizar inmediatamente. La fecha del primer pago, se toma en cuenta si el valor del campo conPagoInmediato es false. El nmero de pagos a realizar. El tipo de intervalo que hay entre los pagos (1-da, 2-semana, 3-mes, 4-ao). El nmero de intervalos que hay entre los pagos. El cdigo ISO de la moneda. Indica si el primer pago tiene un valor diferente. El valor total del primer pago. El valor del IVA del primer pago. El valor de la base de devolucin del IVA del primer pago. El valor adicional del primer pago. El valor total de cada pago. El valor del IVA de cada pago. El valor de la base de devolucin del IVA de cada pago. El valor adicional de cada pago. El nmero de cuotas. El nombre del comprador El documento de identificacin del comprador. El email del comprador. El telfono nocturno del comprador. El telfono diurno del comprador. El cdigo ISO del pas de la direccin de correspondencia. La ciudad de la direccin de correspondencia. La direccin de correspondencia de la tarjeta de crdito. El cdigo ISO del pas de la direccin de envo. La ciudad de la direccin de envo. La direccin de envo de la mercanca. La direccin IP del comprador. La cookie del navegador del comprador. El agente del navegador del comprador. El cdigo de la franquicia de la tarjeta de crdito, segn el Anexo A1. El cdigo de la aerolnea segn el Anexo A7. El primer campo libre. El segundo campo libre. El nmero de la tarjeta de crdito. El nombre del dueo de la tarjeta de crdito, tal y como aparece en la misma. La fecha de expiracin de la tarjeta de crdito. Indica si todas las transacciones se deben validar manualmente.
14,5 14,5 12 12 14,2 14,2 2 50 25 255 50 50 2 25 255 2 25 255
2 255 255 50 20
validarModuloAntiFraude validarCentralRiesgo reportarPaginaConfirmacion
255
NO NO NO
Indica si se debe utilizar el mdulo antifraude para validar las transacciones. Indica si todas las transacciones se deben validar con los datos de una central de riesgo. Indica si se quiere reportar el resultado de cada transaccin generada por la solicitud de pago recurrente, a la pgina de confirmacin del usuario.
** Requeridos cuando el campo conPagosDiferentes es true, si es false no se toman en cuenta.
OBJETO: AutorizacionRecurrenteWS
Este objeto contiene la respuesta de Pagosonline generada luego de enviar una solicitud de pago recurrente. Contiene la referencia de la solicitud de pago recurrente, el nmero (ID) de la solicitud en Pagosonline, el cdigo de respuesta de POL y otros datos. A continuacin se muestra una tabla que describe todos los campos. Estructura:
Campo cuentaId Referencia solicitudRecurrenteId conPagoInmediato fechaPrimerPago numeroPagos tipoIntervaloEntrePagos numeroIntervalosEntrePagos isoMoneda4217 conPagosDiferentes valorPrimerPago ivaPrimerPago baseDevolucionIvaPrimerPago valorAdicionalPrimerPago Valor Iva baseDevolucionIva valorAdicional codigoAerolinea extra1 extra2 estadoId codigoRespuesta codigoError* mensajeError* autorizacionPrimerPago** Tam. 50 Descripcin El nmero (ID) de la cuenta del usuario en Pagosonline. La referencia de la solicitud de pago correspondiente. El nmero (ID) de la transaccin en Pagosonline. Indica si el primer pago se debe realizar inmediatamente. La fecha del primer pago, se toma en cuenta si el valor del campo conPagoInmediato es false. El nmero de pagos a realizar. El tipo de intervalo que hay entre los pagos (1-da, 2-semana, 3-mes, 4-ao). El nmero de intervalos que hay entre los pagos. El cdigo ISO de la moneda. Indica si el primer pago tiene un valor diferente. El valor total del primer pago. El valor del IVA del primer pago. El valor de la base de devolucin del IVA del primer pago. El valor adicional del primer pago. El valor total de cada pago. El valor del IVA de cada pago. El valor de la base de devolucin del IVA de cada pago. El valor adicional de cada pago. El cdigo de la aerolnea segn el Anexo A7. El primer campo libre. El segundo campo libre. El estado en el que se encuentra la solicitud (Anexo A2). El cdigo de respuesta de Pagosonline (Anexo A3). El cdigo que identifica el error ocurrido (dado el caso). El mensaje del error ocurrido (dado el caso). Un objeto de la clase AutorizacionWS con la autorizacin del primer pago (Anexo A4).
3 14,5 14,5 14,2 14,2 12 12 14,5 14,5 2 255 255
*Aplican cuando ocurre algn error con la solicitud de pago recurrente. ** Aplica cuando se envi el campo conPagoInmediato de la solicitud en true.
METODO: consultarEstadoSolicitudRecurrente( cuentaId, solicitudRecurrenteId)

Permite consultar el estado de una solicitud de pago recurrente en cualquier momento. Recibe como parmetros el usuarioId y el solicitudRecurrenteId de la solicitud de pago y retorna un objeto EstadoSolicitudRecurrenteWS. Este mtodo se puede utilizar para revisar cualquier solicitud, generalmente las que se encuentran en estado de validacin. El resultado contiene varios objetos EstadoTransaccionWS que contienen los estados de todas las transacciones generadas a partir del pago recurrente. Parmetros de entrada:
Parmetro cuentaId solicitudRecurrenteId Tipo N N Descripcin El identificador de la cuenta del usuario El identificador de la solicitud de pago recurrente que se desea consultar.
Retorna: El objeto EstadoSolicitudRecurrenteWS con los datos actualizados de la transaccin. En caso de ocurrir un error, el objeto contiene el cdigo de respuesta 9999, error inesperado y el cdigo de error interno generado por el sistema en el campo codigoError.
OBJETO: EstadoSolicitudRecurrenteWS
Este objeto contiene la mayora de los datos de la autorizacin recibida luego de mandar una solicitud de pago recurrente, sin embargo, se puede solicitar en cualquier momento con el nmero (ID) de la cuenta del usuario en Pagosonline y el nmero (ID) de la solicitud de pago recurrente. Adems, contiene los estados de todas las transacciones asociadas al pago recurrente. A continuacin se muestra una tabla que describe todos los campos.
Estructura:
Campo cuentaId Referencia solicitudRecurrenteId conPagoInmediato fechaPrimerPago numeroPagos tipoIntervaloEntrePagos Tam. 12 25 Descripcin El nmero (ID) de la cuenta del usuario en Pagosonline. La referencia de la solicitud de pago correspondiente. El nmero (ID) de la transaccin en Pagosonline. Indica si el primer pago se debe realizar inmediatamente. La fecha del primer pago, se toma en cuenta si el valor del campo conPagoInmediato es false. El nmero de pagos a realizar. El tipo de intervalo que hay entre los pagos (1-da, 2-semana, 3-mes, 4-ao).
numeroIntervalosEntrePagos isoMoneda4217 conPagosDiferentes valorPrimerPago ivaPrimerPago baseDevolucionIvaPrimerPago valorAdicionalPrimerPago Valor Iva baseDevolucionIva valorAdicional codigoAerolinea extra1 extra2 codigoError* mensajeError* estadoId numeroSiguientePago fechaSiguientePago conProblemas estadosTransacciones
3 14,2 14,2 14,2 14,2 12 12 14,2 14,2 2 255 255
El nmero de intervalos que hay entre los pagos. El cdigo ISO de la moneda. Indica si el primer pago tiene un valor diferente. El valor total del primer pago. El valor del IVA del primer pago. El valor de la base de devolucin del IVA del primer pago. El valor adicional del primer pago. El valor total de cada pago. El valor del IVA de cada pago. El valor de la base de devolucin del IVA de cada pago. El valor adicional de cada pago. El cdigo de la aerolnea segn el Anexo A6. El primer campo libre. El segundo campo libre. El cdigo que identifica el error ocurrido (dado el caso). El mensaje del error ocurrido (dado el caso). El estado en el que se encuentra la solicitud (Anexo A5). El nmero del siguiente pago a realizar. La fecha del siguiente pago a realizar. Determina si la solicitud de pago recurrente tiene problemas o no Todos los estados de las transacciones generadas, almacenados en objetos EstadoTransaccionWS (Anexo A5).
* Aplican cuando ocurre algn error con la solicitud de pago recurrente.
METODO: reIntentarSolicitudPagoRecurrente( cuentaId, solicitudPagoRecurrenteId )

Este mtodo permite intentar procesar de nuevo una solicitud de pago recurrente que por alguna razn no fue exitosa. ste mtodo se debe invocar despus de actualizar la informacin de la solicitud de pago recurrente. Parmetros de entrada:
Parmetro cuentaId solicitudPagoRecurrenteId Tipo N N Descripcin El identificador de la cuenta del usuario en el sistema. El identificador de la solicitud de pago recurrente.
Retorna: Un objeto AutorizacionWS que contiene el resultado de reintentar la transaccin. Lanza: Lanza una excepcin PagosonlineWSFault en caso de que no sea posible reintentar la solicitud de pago recurrente.
METODO: actualizarSolicitudPagoRecurrente( cuentaId, solicitudPagoRecurrenteId, cuotas, tarjeta )

Este mtodo permite actualizar la informacin de la tarjeta de crdito asociada a una solicitud de pago recurrente.
Parmetro cuentaId solicitudPagoRecurrenteId cuotas tarjeta Tipo N N N TarjetaCreditoWS Descripcin El identificador de la cuenta del usuario en el sistema. El identificador de la solicitud de pago recurrente. Nmero de cuotas de pago para la tarjeta. Los datos de la tarjeta de crdito que se desean actualizar.
Retorna: Este mtodo no retorna ningn resultado.
METODO: cancelarSolicitudPagoRecurrente( cuentaId, solicitudPagoRecurrenteId )

Este mtodo permite cancelar una solicitud de pago recurrente que por algn motivo no se desea continuar procesando.
Parmetro cuentaId solicitudPagoRecurrenteId Tipo N N Descripcin El identificador de la cuenta del usuario en el sistema. El identificador de la solicitud de pago recurrente.
Retorna: Este mtodo no retorna ningn resultado. Lanza: Una excepcin PagosonlineWSFault en caso de que no sea posible cancelar la solicitud de pago recurrente.
3.1.10 Proceso de Pago de las Agencias de Viajes Figura 6. Diagrama de Flujo Transacciones Agencia de Viajes
COMERCIO
leerMediosPagoActivos( )* MedioPagoWS [ ] leerAerolineas( )
Pgina de respuesta
AerolineaWS[ ] solicitarAutorizacionTA( ) AutorizacionTAWS [ ]
HTTP POST
(Mtodo de consulta estado Transaccin)
CRON JOB
(Estado de la transaccin)[ ]
El sistema cuenta con un mdulo especial para las agencias de viajes que permite cobrar la tarifa administrativa y el tiquete areo en un nico proceso, realizando una transaccin Administrativa (Agencia de Viajes) y una del Tiquete areo (Aerolnea). Para utilizar este mdulo nicamente se
43
puede utilizar con las franquicias VISA, DINERS y AMEX. Para un correcto funcionamiento de la dispersin, se debe enviar el cdigo correspondiente a la aerolnea. En caso tal que los campos correspondientes a la tarifa administrativa no se enven, el sistema procesar la transaccin de manera ordinaria, abonando el dinero directamente a la cuenta de la agencia de viajes.
Nota Importante:
Por motivos tcnicos es posible que la transaccin para el pago del tiquete areo se apruebe y la transaccin de la tarifa administrativa se rechace. Cuando esto ocurre, el sistema retorna el cdigo de respuesta 24, transaccin parcial aprobada. Es responsabilidad del comercio procesar de nuevo el pago para la tarifa administrativa.
El valor de la tasa aeroportuaria se debe enviar en el campo valorAdicional y no se debe agregar al valor total de la transaccin para que la entidad financiera no cobre comisin sobre este valor. Este es un ejemplo de cmo se envan los campos:
Campo valor baseDevolucionIva iva valorAdicional tarifaAdministrativa ivaTarifaAdministrativa baseDevolucionTarifaAdministrativa TOTAL PAGO TARJETAHABIENTE
Valor 109 620.00 94 500.00 15 120.00 11 300.00 21 231.00 29 28.00 18 303.00 163 382.00
Para este ejemplo, el Tarjetahabiente va a realizar un pago por 163 382.00, los cuales se dispersan de la siguiente manera: valor (109 620.00) y valorAdicional (11 300.00 corresponde al impuesto Aeroportuario) son pagos a la aerolnea, para un total de 120 920.00, y para la Agencia de Viajes la tarifaAdministrativa por 21 231.00
METODO: leerAerolineas()
Este mtodo permite leer el listado de las Aerolneas con su respectivo cdigo IATA, el cual ser utilizado para indicar la dispersin de fondos entre la Agencia y la Aerolnea en el mtodo solicitarAutorizacionTA. Este mtodo retorna un arreglo de objetos de tipo AerolineaWS. Se recomienda consumir este mtodo una vez por da y mantener el listado en la base de datos, para disminuir el tiempo de respuesta en su sitio web.
OBJETO: AerolineaWS
Este objeto contiene el cdigo IATA y el nombre de la Aerolnea.
Estructura:
Parmetro descripcion codigo Tipo A N Descripcin Nombre de la Aerolnea Cdigo IATA de la Aerolnea
METODO: solicitarAutorizacionTA( SolicitudAutorizacionTAWS )

Este mtodo permite procesar el pago de un tiquete areo con su correspondiente tarifa administrativa, en otras palabras, esta forma de pago genera dos transacciones simultneas. El valor del tiquete es abonado a la cuenta de la aerolnea y el valor de la tarifa administrativa a la agencia de viajes que origin la transaccin. El mtodo recibe un objeto
SolicitudAutorizacionTAWS que contiene entre otros, el cdigo de la aerolnea, el valor del tiquete y el valor de la tarifa administrativa. El mtodo retorna un objeto de tipo AutorizacionTAWS que contiene el cdigo de autorizacin de la transaccin que se genera para el pago del tiquete y el cdigo de autorizacin de la transaccin que se genera para el pago de la tarifa administrativa. Recuerde que debe utilizar los mtodos de consulta descritos al inicio de este documento ver 2.1.2 Mtodos para verificar estados de transacciones Parmetros de entrada:
Parmetro solicitudAutorizacionTAWS Descripcin El objeto que contiene los datos necesarios para solicitar la autorizacin de la transaccin.
Retorna: Un objeto AutorizacionTAWS que contiene los datos de la autorizacin. En caso de ocurrir un error el mtodo retorna el objeto AutorizacionTAWS con el cdigo de respuesta 9999, error inesperado y en el campo cdigo de error, el cdigo de error interno generado por el sistema.
OBJETO: SolicitudAutorizacionTAWS
Este objeto contiene los datos necesarios para procesar el pago de un tiquete areo con su correspondiente tarifa administrativa. El objeto incluye los datos de la tarjeta de crdito, el cdigo de la aerolnea, as como los campos necesarios para enviar el valor del tiquete, la base de devolucin del IVA, el IVA y la tasa aeroportuaria (a travs del campo valor adicional). Tambin incluye los campos para enviar la tarifa administrativa, el IVA de la tarifa administrativa y la base de devolucin del IVA de la tarifa administrativa. A continuacin se muestra una tabla que describe todos los campos que contiene el objeto. Se recomienda enviar la mayor cantidad de informacin disponible, ya que sta es utilizada por el mdulo anti fraude para generar una valoracin del riesgo de la transaccin.
Estructura:
Campo cuentaId Referencia Descripcin Valor Iva baseDevolucionIva valorAdicional tarifaAdministrativa ivaTarifaAdministrativa baseDevolucionIvaTarifaAdministrativa isoMoneda4217 numeroCuotas Tam. 12 50 255 14,2 14,2 14,2 14,2 12 14,2 14,2 3 2 Req. S S S S S S NO S S S S S Descripcin El nmero (ID) de la cuenta del usuario en Pagosonline. La referencia de la venta, debe ser nica por cada solicitud de pago. La descripcin de la venta. El valor total de la venta. El valor del IVA de la venta El valor de la base de devolucin del IVA de la venta. El valor adicional de la venta. El valor de la tarifa administrativa. El valor del IVA de la tarifa administrativa. El valor de la base de devolucin del IVA de la tarifa administrativa El cdigo ISO de la moneda ejemplo: COP (Pesos Colombianos). El nmero de cuotas.
nombreComprador documentoIdentificacion emailComprador Telfono telefonoOficina paisCorrespondencia ciudadCorrespondencia direccionCorrespondencia paisEnvio ciudadEnvio direccionEnvio ipComprador Cookie userAgent Franquicia codigoAerolinea extra1 extra2 Numero nombreTarjetaHabiente fechaExpiracion validarModuloAntiFraude reportarPaginaConfirmacion
50 25 255 50 50 2 25 255 2 25 255
NO NO NO NO NO NO NO NO NO NO NO S NO NO S
El nombre del comprador. El documento de identificacin del comprador. El correo electrnico del comprador. El telfono nocturno del comprador. El telfono diurno del comprador. El cdigo ISO del pas de la direccin de correspondencia. La ciudad de la direccin de correspondencia. La direccin de correspondencia de la tarjeta de crdito. El cdigo ISO del pas de la direccin de envo. La ciudad de la direccin de envo. La direccin de envo de la mercanca. La direccin IP del comprador. La cookie del navegador del comprador. El agente del navegador del comprador. El cdigo de la franquicia de la tarjeta de crdito, segn el Anexo A1. El cdigo IATA de la aerolnea (leerAerolineas) El primer campo libre. El segundo campo libre. El nmero de la tarjeta de crdito. El nombre del dueo de la tarjeta de crdito, tal y como aparece en la misma. La fecha de expiracin de la tarjeta de crdito. Si se quiere utilizar el mdulo antifraude para validar la solicitud de pago. Si se quiere reportar el resultado de la transaccin a la pgina de confirmacin del usuario.
2 255 255
S NO NO S
50 20
S S NO
255
NO
OBJETO: AutorizacionTAWS
Este objeto contiene la respuesta de Pagosonline a la solicitud de pago de un tiquete areo con tarifa administrativa. Incluye los campos correspondientes a la autorizacin del tiquete areo y los campos de la autorizacin de la tarifa administrativa. Por motivos tcnicos es posible que la transaccin del tiquete areo sea aprobada y la transaccin de la tarifa administrativa no lo sea. En caso de ser as, el objeto contiene el cdigo de respuesta autorizacin parcial exitosa; es responsabilidad de la agencia de viajes re-intentar la transaccin de la tarifa administrativa (sin incluir el valor del tiquete) o reversar la transaccin que fue aprobada.
Estructura:
Campo referencia transaccionId codigoRespuesta 2 Tam. 50 Descripcin La referencia de la solicitud de pago correspondiente. El nmero (ID) de la transaccin en Pagosonline. El cdigo de respuesta de Pagosonline. El cdigo de respuesta 1 corresponde a transaccin aprobada y el cdigo de transaccin 24 a una aprobacin parcial tal y como se mencion en la descripcin del mtodo solicitarAutorizacionTA (Ver Anexo A3). El cdigo de autorizacin generado por el banco. El cdigo de autorizacin generado por el banco para la tarifa administrativa. El ndice de riesgo de la solicitud (0 bajo - 1 alto). El valor de la transaccin. El valor del IVA de la transaccin. El valor de la base de devolucin del IVA de la transaccin. El valor adicional de la transaccin. El cdigo de la aerolnea segn el Anexo A7. El primer campo libre. El segundo campo libre. La fecha de procesamiento de la transaccin. El valor de la tarifa administrativa El valor del IVA de la tarifa administrativa El valor de la base de devolucin del IVA de la transaccin El cdigo que identifica el error ocurrido (dado el caso). El mensaje del error ocurrido (dado el caso).
codigoAutorizacion codigoAutorizacionTA riesgo * Valor Iva baseDevolucionIva valorAdicional codigoAerolinea extra1 extra2 fechaProcesamiento tarifaAdministrativa ivaTarifaAdministrativa baseDevolucionIvaTarifaAdministrativa codigoError ** mensajeError **
6 6 12 12 12 14,2 14,2 2 255 255 20
* Tiene sentido si se valid por el mdulo anti fraude, de otro modo siempre es 0. ** Aplican cuando ocurre algn error procesando la solicitud de pago.
2 Otros Objetos Disponibles OBJETO: TarjetaCreditoWS

Este objeto representa una tarjeta de crdito en el sistema. Contiene el nombre del tarjetahabiente, el nmero de la tarjeta, la fecha de expiracin, el documento de identificacin del tarjeta-habiente, el cdigo de seguridad (nicamente para tarjetas de la franquicia Mastercard) y la franquicia. A continuacin se muestra una tabla que describe los campos del objeto.
Campo Cuotas Documento Franquicia Numero Nombre fechaExpiracion codigoSeguridad
Tam. 2 2
Req. S No S S
Descripcin El nmero de cuotas. El documento de identificacin del comprador. El cdigo de la franquicia de la tarjeta de crdito, segn el Anexo A2. El nmero de la tarjeta de crdito. El nombre del dueo de la tarjeta de crdito, tal y como aparece en la misma. La fecha de expiracin de la tarjeta de crdito. El cdigo de seguridad de la tarjeta de crdito. nicamente es requerido para las tarjetas de crdito Mastercard.
50 20
S S NO
OBJETO: PagosonlineWSFault
Este objeto representa una excepcin generada por el sistema al procesar una solicitud. El objeto contiene un mensaje y un cdigo de error asociados para facilitar la depuracin y correccin de errores.
Campo mensaje codigoError Req. S SI Descripcin El mensaje asociado al cdigo de error El cdigo de error.
CAPITULO 4 Pruebas
Para probar la comunicacin entre su aplicacin web y la plataforma de pagos de Pagosonline, se puede utilizar el mtodo getVersion(). Cuando se compruebe que la comunicacin entre el usuario y Pagosonline funciona de forma correcta, se pueden realizar solicitudes de pago de prueba, las cuales no tienen ningn efecto en la(s) cuenta(s) del usuario. A continuacin explicamos dos ejemplos para pagos con Tarjetas de Crdito y PSE
4.1 Pruebas con Tarjetas de Crdito:

Para realizar pagos con tarjeta de crdito utilizaremos el proceso explicado en el diagrama en la figura 2, siguiendo los pasos a continuacin:
1. Inicialmente debemos leer los medios de pago con el mtodo leerMediosPagoActivos(), con el objeto retornado de MedioPagoWS, podemos filtrar los medios correspondientes a Tarjetas de crdito para su comercio
(ver Anexos A5 y A6)
, para este paso recomendamos
mantener estos datos en la Base de datos, para no tener que consultarlos en cada transaccin, sino peridicamente actualizarlos. 2. Con los medios de pago cargados, podemos crear un objeto de la clase SolicitudAutorizacionWS, llenando los datos requeridos para realizar el pago, como si fuera una solicitud real.
3. Para el dato del nmero de la tarjeta de crdito debe usar las tarjetas de prueba que
hemos dispuesto en la siguiente tabla:
Numero Tarjeta de Credito 9955555555555501 9955555555555504 9955555555555515
Estado Transaccin Aprobada Rechazada En proceso de Validacin
Por favor validar estas tarjetas para que luego de realizar todas las pruebas no sean utilizables, debido a que pueden generar resultados validos para su sistema en produccin.
Nota Importante: El cdigo de autorizacin para transacciones de prueba con MASTERCAD es 123
4. Teniendo listo el Objeto para enviar los datos al WebServices, empleamos el mtodo solicitarAutorizacion(), e inmediatamente obtendremos la respuesta del WebServices Pagosonline en un objeto AutorizacionWS[], con el que podremos verificar segn la respuesta los diferentes estados de la transaccin (ver Anexos A2 y
A3)
5. Ya teniendo determinado el estado de la transaccin, podemos realizar las siguientes acciones recomendadas: 1. Si el estado es Pagada y Abonada o Rechazada, se actualiza la base de datos. 2. Si la transaccin queda en Validacin, se encola la transaccioId para volver a consultar su estado usando un cron job. 6. Simultneamente al momento de recibir la respuesta del WebServices, se puede recibir una pgina de confirmacin, siempre y cuando se obtenga un estado definitivo, es decir Rechazada o Pagada Y Abonada, con la cual podemos realizar varias operaciones recomendadas: 1. Si el estado es Pagada y Abonada o Rechazada, se actualiza la base de datos. 2. Verificar si la transaccin est dentro de las que estn por revisar con el Cron Job, y darle el estado definitivo.
4.2 Pruebas con PSE:

Para realizar pagos con PSE (cuentas de ahorro y corrientes) utilizaremos el proceso explicado en el diagrama en la figura 3. En estos procesos, la entidad ACH habilit una pasarela de pagos que simula pginas de bancos, con las cuales se pueden realizar pruebas reales de una transaccin en una entidad bancaria, obviamente con datos de prueba, realizando los siguientes pasos:
1.
Inicialmente debemos leer los medios de pago con el mtodo leerMediosPagoActivos(), con el objeto MedioPagoWS filtrar el medio correspondiente a PSE para su comercio
Anexos A5 y A6) (ver
, para este paso recomendamos mantener estos datos en la Base de datos,
para no tener que consultarlos en cada transaccin, sino peridicamente actualizarlos.

2.
Con los medios de pago cargados, ahora debemos listar alfabticamente los bancos PSE usando el mtodo leerBancosPse(), el cual retorna un arreglo de objetos de la clase BancoPseWS[].
3.
De acuerdo a la siguiente tabla, escoja la entidad bancaria y requeridos para simular el pago.
complete los datos
Entidad Bancaria ABDUL Helm Finantial Bank
Datos para generar la Transaccin Account Agency: 1234
Estado Transaccin Aprobada
Account Number: 4321 Account Agency: 1234 Banco Web Service ACH Account Number: 1234 Password: 123456 Banco Web Service ACH O ABDUL Helm Finantial Bank Se da clic en Cancel y se digita en la siguiente pantalla: Error Code: 00001 Account Agency: 1234 Banco Union Colombiano Account Number: 1234 Password: 123456 Account Agency: 1234 Banco Tequendama Account Number: 794613 Password: - * Pendiente Fallida Rechazada Aprobada
4.
Podemos crear un objeto de la clase transaccionPseWS, llenando los datos requeridos para realizar el pago, incluyendo uno de los bancos listados con BancoPseWS[].
52
Opcionalmente podemos usar las propiedades urlConfirmacion y/o urlRespuesta, las cuales son la URL de cada pgina en su funcin especfica explicada anteriormente, las cuales deben ser de acceso pblico, para poder ser usadas.
5.
Como resultado obtendremos un objeto del mismo tipo que el parmetro de entrada, con los datos actualizados. Dentro de los datos del nuevo Objeto recibido, Pagosonline genera un codigoPse, representa el cdigo de la transaccin que va ser enviada al Banco.
6.
Con este objeto recibimos el parmetro urlPaginaPagosBanco, como su nombre lo indica, contiene la URL de la pgina web del banco donde ser redireccionado, para realizar el pago. Dentro de esta URL, va toda la trama de variable que debe recibir el banco seleccionado anteriormente, e incluyendo el codigoPse.
7.
Una vez terminado el proceso de pago en el banco, el usuario se regresa a la pgina de respuesta de su comercio, la que debe estar configurada para mostrar toda la informacin de la transaccin, y que cumpla con los parmetros requeridos para la certificacin PSE. Para efectos de seguridad en la pgina de respuesta recomendamos verificar que el codigoPse, es el mismo que llega por mtodo GET como cus, a la pgina de respuesta y de confirmacin, para identificar que es la misma transaccin que enviamos al banco.
8.
Al recibir la pgina de respuesta el proceso por lado del usuario queda terminado, y dependiendo del estado de la transaccin aplicaremos lo descrito en el paso 5 de pagos con Tarjetas de crdito, teniendo en cuenta, que para pagos por PSE, la actualizacin de la base de datos solo se realiza en la pgina de confirmacin, debido a que dependemos de la entidad bancaria y por lo tanto la respuesta no es inmediata. Y en caso de no recibir los datos durante un tiempo prolongado, podemos utilizar el cron job descrito en el medio de pago de tarjetas de crdito.
Nota Importante:
El sistema de PSE est disponible solamente en el horario 8:00 a.m. - 8:00 p.m. (en ambiente de pruebas).
Adems puede utilizar el mtodo consultarEstadoTransaccion(), para examinar cualquier transaccin de prueba. Recuerde que si se utiliza un nmero de prueba, la transaccin generada no produce ningn movimiento real y por lo tanto no afecta el saldo de su(s) cuenta(s).
Nota Importante: Si requiere informacin adicional, por favor remtase contctese con el rea de soporte Tcnico en PagosOnline.
CAPITULO 6. Como revisar las transacciones en nuestro sistema

Para este fin entraremos al mdulo administrativo en pruebas https://secure2.pagosonline.net/ ya que las pruebas se realizaron apuntando a https://gateway2.pagosonline.net/..., en la pestaa transacciones, y en el link Reporte de transacciones, podremos diligenciar un formulario con los datos que estamos buscando. Las fechas son importantes ya que no deben superar 90 das, es importante que seleccionemos la variable prueba en la bsqueda, para encontrar las transacciones realizadas con las tarjetas de crdito de prueba, y deshabilitarla para encontrar las pruebas realizadas con PSE.
Cuando oprimimos buscar, en la parte inferior aparecer una serie de datos de todas las transacciones, si se desea mayor informacin de una en particular debemos darle click a la transaccin deseada.
Si deseamos un reporte mucho mayor debemos habilitar la opcin Detalle tem y oprimir en exportar a Excel.
ANEXOS
A1. Cdigos de las franquicias para enviar a Pagosonline
Franquicia American Express Diners Mastercard Visa
Cdigo AMEX DINERS MASTERCARD VISA
A2. Estados de las transacciones en Pagosonline
Estado 1 2 4 5 6 7 8 9 10 11 12
Descripcin Sin abrir Abierta Pagada y abonada Cancelada Rechazada En validacin Reversada Reversada fraudulenta Enviada entidad financiera Capturando datos tarjeta de crdito Esperando confirmacin sistema PSE
A3. Cdigos de respuesta de Pagosonline (codigoRespuesta)
Cdigo de Respuesta 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 1001 1002 1003 1004 1005 9994 9995 9996 9997 9998 9999
Descripcin Transaccin aprobada Pago cancelado por el usuario Pago cancelado por el usuario durante validacin Transaccin rechazada por la entidad Transaccin declinada por la entidad Fondos insuficientes Tarjeta invlida Acuda a su entidad Tarjeta vencida Tarjeta restringida Discrecional POL Fecha de expiracin o campo seg. invlidos Repita transaccin Transaccin invlida Transaccin en proceso de validacin Combinacin usuario-contrasea invlidos Monto excede mximo permitido por entidad Documento de identificacin invlido Transaccin abandonada capturando datos de TC Transaccin abandonada Imposible reversar transaccin Tarjeta no autorizada compras por Internet Transaccin rechazada Transaccin parcial exitosa Solicitud de pago recurrente registrada exitosamente Solicitud de pago recurrente no registrada Solicitud de pago recurrente con primer pago exitoso Solicitud de pago recurrente con primer pago en validacin Solicitud de pago recurrente con primer pago no exitoso Transaccin pendiente por confirmar Certificado digital no encontrado Entidad no responde Error de mensajera con la entidad financiera Error en la entidad financiera Error no especificado
A4. Estados de las solicitudes de pago recurrente
Estado 1 2 3 4 5
Descripcin Activa Completada Cancelada Rechazada Rechazada fraudulenta
A5. Medios de Pago
ID 10 11 12 22 24 25 30 31 32
Medio de Pago VISA MASTERCARD AMEX DINERS Verified by VISA PSE EFECTY PAGO BANCO DE OCCIDENTE PAGO REFERENCIADO BANCOLOMBIA
A6. Tipo Medio de Pago

ID 2 4 7 8 Tipo Medio de Pago TARJETA DE CREDITO PSE PAGO EFECTIVO PAGO REFERENCIADO
A7. Cdigos VISA de las aerolneas
Estado 1 2 3 . . 19 20 21 22 23 24 25 26 29 30 33 34 . . 96 97 98 99
Descripcin AIR CANADA Nacional AIR CANADA Internacional AEROFLOT Nacional . . BTI TRAVEL Nacional BTI TRAVEL Nacional AIRES Nacional AIRES Internacional ALITALIA Nacional ALITALIA Internacional AMERICAN AIR Nacional AMERICAN AIR Internacional AVIANCA Nacional AVIANCA Internacional COPA Nacional COPA Internacional . . LAN PERU Internacional AIR EUROPA Nacional AIR EUROPA Internacional AGENCIAS DE VIAJES - T.A. Internacional
Nota Importante: Estos cdigos estn sujetos a cambios, por lo tanto solo los mostramos a manera de ejemplos, y se recomienda el uso del mtodo leeAerolineas(), recomendamos verificarlos por lo menos una vez por da.
A7 Divisas admitidas
Cdigo ISO-4217 COP EUR GBP MXN USD VEB
Divisa Pesos Colombianos Euros Libras Esterlinas Pesos Mexicanos U.S. Dlar Bolvares Fuertes
A8 Tipo de documento para PSE
pseReferencia2 CC CE NIT TI PP IDC CEL RC DE
Descripcin Cdula de ciudadana. Cdula de extranjera. NIT, en caso de ser una empresa. Tarjeta de Identidad. Pasaporte. Identificador nico de cliente, para el caso de IDs nicos de clientes/usuarios de servicios pblicos caso de identificar a travs de la lnea del mvil Registro civil de nacimiento Documento de identificacin extranjero
GLOSARIO
A: ACH: ACH COLOMBIA S.A. es miembro de la Asociacin Nacional de Cmaras de Compensacin Automatizadas de Estados Unidos conocida como entidad que rige los procedimientos, normas y formatos de los ACH en ese pas, donde el sistema ACH existe hace ms de 25 aos. ACH COLOMBIA acogi las normas, los procedimientos y formatos definidos por dicha asociacin y los ajust al medio colombiano. C: CuentaId: Es un identificador alternativo y nico, de autenticacin, que solo es usado para algunos mtodos WebServices.
LL: Llave de encripcin: esta es una llave nica para cada comercio, utilizada en Integracin Tradicional, la cual se utiliza en conjunto de usurioId, y otras variables para generar una firma, esta permite la validacin de la transaccin en nuestra plataforma de pagos. De igual forma, Pagosonline, enva una firma tanto a la pgina de respuesta y de confirmacin, la cual le permite al comercio determinar si la los datos que est recibiendo son confiables. Para entender mejor el funcionamiento del uso de la llave de encripcin, debe leer el Manual de Integracin Tradicional en nuestro portal de ayuda http://ayuda.pagosonline.com/index.php P: PSE: Es un sistema centralizado y estandarizado que permite a las empresas ofrecer al Usuario la posibilidad de realizar pagos en lnea, accesando sus recursos desde la Entidad Financiera donde los tiene. Para mayor informacin https://www.pse.com.co T: TransaccionId: Es un cdigo nico por transaccin generado en el sistema transaccional de Pagosonline, la cual tambin llega como variable ref_pol, la cual se usa tanto en la pgina de respuesta, como en la de confirmacin. U: UsuarioId: Es el identificacin principal y nico para cada comercio registrado en Pagosonline, se utiliza para autenticarse con nuestra plataforma de pagos, ya sea por Integracin Tradicional o WebServices. Nota Importante: Para mejoras que a este documento, puede w cualquier w w .observacin P a go o s O nquiera l i aportar n e . c o m escribirnos a soporte@pagosonline.com. PagosOnLine S.A. Bogot D.C. PBX. (1) 576 3126 FAX. (1) 6161540 www.pagosonline.com e-mail: info@pagosonline.com Gracias!
62

Integracion WS R2

Hochgeladen von

Dokumentinformationen

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Integracion WS R2

Hochgeladen von

Copyright:

Verfügbare Formate

Manual de Integracin WebServices

CAPITULO 1. Descripcin de la aplicacin

PSE (cuentas de ahorro y corrientes):

Pago Referenciado o formato de pago con Cdigo de barras:

CAPITULO 2. Como obtener los datos de acceso al WebServices

CAPITULO 3. Descripcin y Uso de Mtodos

3. Modificar el esqueleto generado para implementar la seguridad con WS-Security, para

3.1.1 Mtodos WebServices Y Objetos METODO: leerMediosPagoActivos( usuarioId )

3.1.2 Mtodos para consulta de transacciones

METODO: consultarEstadoTransaccion( cuentaId, transaccionId )

3.1.3 Mtodos de consulta por referencia:

transaccionId 1099652 1522302 33622001

METODO: obtenerEstadoTransacciones( usuarioId, xml )

Etiqueta fecha codigo-respuesta codigo-error mensaje-error id referencia codigo-respuesta-solicitud estado

3.1.4 Cuando usar los mtodos de consulta

Una transaccin queda en validacin.

Se pierde comunicacin con el WebServices Pagosonline, mientras se enva una transaccin.

3.1.5 Paginas de Respuesta y Confirmacin:

PGINA DE RESPUESTA DE EJEMPLO

Correo confirmacin Comercio Correo confirmacin Comprador

(Mtodo de consulta estado Transaccin)*

2. El comercio puede consultar las veces necesarias en nuestro sistema el estado de la

METODO: solicitarAutorizacion( solicitudAutorizacionWS )

Retorna: objeto AutorizacionWS que contiene los datos de la autorizacin.

** Aplican cuando ocurre algn error procesando la solicitud de pago.

METODO: solicitarAutorizacionConSessionId solicitudAutorizacion, String sessionId)

Retorna: objeto AutorizacionWS que contiene los datos de la autorizacin.

Descripcin La referencia de la solicitud de pago correspondiente. El nmero (ID) de la transaccin en Pagosonline

2 6 12 12 12 14,2 14,2 2 255 255 20

MedioPagoWS [ ] leerBancosPse( ) BancoPseWS [ ]

Redirect HTTP POST 7 urlPaginaPagosBanco

Redirect HTTP GET Pg. Respuesta

Correo confirmacin Comercio

Correo confirmacin Comprador

(Mtodo de consulta estado Transaccin)

METODO: iniciarTransaccionPseConInformacionAdicional (TransaccionPseConInformacionAdicionalWS)

255 255 255 255

* Estos campos son enviados por Pagosonline, en la respuesta al mtodo iniciarTransaccionPseConInformacionAdicional()

3.1.8 Proceso de pago con Pago Referenciado

Figura 4: Diagrama de Flujo pagos con Pago Referenciado

3.1.8.1 Descripcin de mtodos para el pago Referenciado METODO: solicitarAutorizacionPagoReferenciado(solicitudAutorizacionPagoReferenciado)

3.1.9 Proceso de Pagos Recurrentes

Figura 5. Diagrama de flujo Pagos Recurrentes

WebServices PagosOnLine solicitarAutorizacionRecurrente ( ) AutorizacionRecurrenteWS [ ]

Solicitud Pago Recurrent e

Correo confirmacin Comercio Correo confirmacin Comprador

(Mtodo de consulta estado Transaccin)*

3.1.9.1 Descripcin de mtodos para el pago Recurrente METODO: solicitarAutorizacionRecurrente( SolicitudAutorizacionRecurrenteWS )

14,5 14,5 12 12 14,2 14,2 2 50 25 255 50 50 2 25 255 2 25 255

validarModuloAntiFraude validarCentralRiesgo reportarPaginaConfirmacion

** Requeridos cuando el campo conPagosDiferentes es true, si es false no se toman en cuenta.

3 14,5 14,5 14,2 14,2 12 12 14,5 14,5 2 255 255

METODO: consultarEstadoSolicitudRecurrente( cuentaId, solicitudRecurrenteId)

3 14,2 14,2 14,2 14,2 12 12 14,2 14,2 2 255 255

* Aplican cuando ocurre algn error con la solicitud de pago recurrente.

METODO: reIntentarSolicitudPagoRecurrente( cuentaId, solicitudPagoRecurrenteId )

METODO: actualizarSolicitudPagoRecurrente( cuentaId, solicitudPagoRecurrenteId, cuotas, tarjeta )

Retorna: Este mtodo no retorna ningn resultado.

METODO: cancelarSolicitudPagoRecurrente( cuentaId, solicitudPagoRecurrenteId )

AerolineaWS[ ] solicitarAutorizacionTA( ) AutorizacionTAWS [ ]

Correo confirmacin Comercio Correo confirmacin Comprador

(Mtodo de consulta estado Transaccin)

METODO: solicitarAutorizacionTA( SolicitudAutorizacionTAWS )

50 25 255 50 50 2 25 255 2 25 255