INTEGRACIÓN WEB SERVICE MÓDULO DE PAGO

Transcripción

1 INTEGRACIÓN WEB SERVICE MÓDULO DE PAGO

2 TABLA DE CONTENIDO SOLUCIÓN TECNOLÓGICA... 5 INFORMACIÓN TÉCNICA... 6 OPERACIÓN Transaccion... 7 Estructura de datos mensaje de entrada operación Transaccion... 8 Estructura de datos transacción... 8 Estructura de datos - Compra... 9 Estructura de datos - Cliente Estructura de datos TarjetaHabiente Estructura de datos TarjetaCredito Estructura de datos Envio Estructura de datos InformacionFraude Estructura de datos Productos Estructura de datos - SuscripcionTransaccion Estructura de datos - suscribir Estructura de datos - SuscripcionUsuario Estructura de datos mensaje de salida operación Transaccion Estructura de datos - respuestatransaccion Estructura de datos - antifrauderespuesta EJEMPLO ENTRADA Y SALIDA OPERACIÓN transaccion OPERACIÓN ConsultaPorReferencia Estructura de datos mensaje de entrada operación ConsultaPorReferencia Estructura de datos ConsultaPorReferencia Estructura de datos mensaje de salida operación ConsultaPorReferencia Estructura de datos respuestatransaccionreferencia EJEMPLO ENTRADA Y SALIDA OPERACIÓN ConsultaPorReferencia OPERACIÓN ConsultarTransaccion Estructura de datos mensaje de entrada operación ConsultaTransaccion Estructura de datos ConsultarTransaccion Estructura de datos mensaje de salida operación ConsultarTransaccion Estructura de datos respuestaconsultartransaccion Estructura de datos antifrauderespuesta EJEMPLO ENTRADA Y SALIDA OPERACIÓN ConsultarTransaccion OPERACIÓN ObtenerFranquicia Estructura de datos mensaje de entrada operación ObtenerFranquicia Estructura de datos mensaje de salida operación ObtenerFranquicia Estructura de datos obtenerfranquiciasresponse Estructura de datos respuestafranquicias EJEMPLO ENTRADA Y SALIDA OPERACIÓN ObtenerFranquicia

3 OPERACIÓN TransaccionAereo Estructura de datos mensaje de entrada operación TransaccionAereo Estructura de datos transacciónaereo Estructura de datos - Compra Estructura de datos - Cliente Estructura de datos TarjetaHabiente Estructura de datos TarjetaCredito Estructura de datos Envio Estructura de datos InformacionFraude Estructura de datos Aereo Estructura de datos - Pasajero Estructura de datos - Ruta Estructura de datos - Aeropuerto Estructura de datos mensaje de salida operación TransaccionAereo Estructura de datos - respuestatransaccionaereo Estructura de datos - dispersionesrespuesta EJEMPLO ENTRADA Y SALIDA OPERACIÓN transaccionaereo ESTADOS DE LAS TRANSACCIONES OPERACIÓN reverso Estructura de datos mensaje de entrada operación reverso Estructura de datos informacionreverso Estructura de datos mensaje de salida operación reverso Estructura de datos reversoresponse EJEMPLO ENTRADA Y SALIDA OPERACIÓN reverso MODELO DE INTEGRACIÓN DISPOSITIVOS DE HUELLAS DACTILARES (DiveceFingerprint). 56 SEGMENTO DE CÓDIGO PARA LA IMPLEMENTACIÓN DiveceFingerprint EN EL PAGO Y ENVÍO PÁGINA WEB TABLA DE ERRORES RECOMENDACIONES

4 Visión y creatividad! Son los pilares básicos para la creación de nuevas ideas y emprendimientos IATAI Andina S.A.S INTERNATIONAL ALLIANCE TRAVEL ASSISTANCE & INSURANCE Somos un grupo de empresas aliadas, líderes en los mercados de seguros, reaseguros, salud, turismo y tecnología que han formado un Consorcio de Colaboración sobre la base de un concepto de negocio de integración vertical, visionario e innovador que utiliza la tecnología como médula espinal para un nuevo canal de distribución interactivo y no tradicional. La plataforma ASPH de IATAI es un sistema integral que ofrece entre sus funcionalidades un módulo de pagos con tarjeta de crédito en un ambiente 100% ONLINE. Esta solución tecnológica incluye proceso de venta y medio de pago; de acuerdo con las necesidades puntuales del negocio, integra módulos especializados para el procesamiento confiable de transacciones. 4

5 SOLUCIÓN TECNOLÓGICA Le presentamos una solución tecnológica que de acuerdo con las necesidades puntuales del negocio, integra módulos especializados para el procesamiento seguro de transacciones. 5

6 INFORMACIÓN TÉCNICA A continuación se detallan los procedimientos técnicos que intervienen en el proceso de pagos y la información que contiene cada uno de los mismos. La plataforma ASPH de IATAI permite realizar la integración web service para el pago de las transacciones Online. A continuación se detallan la información técnica para poder tener acceso a las operaciones que corresponden al ambiente de prueba y al ambiente de producción. AMBIENTE DE PRUEBAS Lenguaje de desarrollo: Java Tecnología: JAX-WS Versión de SOAP: SOAP 1.2 Wsdl: username Token: -Username: Iatai -Password: Iatai Tarjeta de Crédito para pruebas: Visa: American Express: MasterCard: AMBIENTE DE PRODUCCIÓN Lenguaje de desarrollo: Java Tecnología: JAX-WS Versión de SOAP: SOAP 1.2 Wsdl: Para obtener la información del username Token es necesario realizar todo el proceso comercial para hacer entrega del username y password, igual que el resto de información del ambiente de producción se bebe tener un proceso de contratación de la plataforma con la compañía. 6

7 OPERACIÓN Transaccion La Operación Transaccion permite realizar el pago electrónico en cualquier tienda virtual por medio de tarjetas de crédito nacional e internacional. FLUJO DEL PROCESO A continuación se describe el flujo del proceso de acuerdo a la gráfica anterior. Envió de petición SOAP a la plataforma ASPH con toda la información requerida para realizar la compra. Recepción de la información en la plataforma ASPH. Una vea es recibida la información en la plataforma, esta es enviada al módulo antifraude, en donde se validan las reglas configuradas de tal forma que la transacción sea aceptada, rechazada o quede en validación. Si el resultado generado por el modulo antifraude de la transacción es Aceptada, se retorna notificación de la respuesta a la plataforma ASPH. Si el resultado generado por el modulo antifraude de la transacción es rechazada, se retorna notificación de la respuesta a la plataforma ASPH. 7

8 Si el resultado generado por el modulo antifraude de la transacción es En validación, se envía a un proceso de verificación manual. Una vez la Plataforma ASPH realiza todo el procesamiento de la transacción, se envía la respuesta de la petición a quien consume el servicio mediante un mensaje SOAP. Estructura de datos mensaje de entrada operación Transaccion A continuación se detalla la estructura que se debe tener en cuenta para realizar una petición a la operación Transaccion. Estructura de datos transacción Estructura que contiene toda la información necesaria para poder realizar una compra mediante la plataforma ASPH. A continuación se detalla la información que compone esta estructura. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido Compra Compra NA Si Cliente Cliente NA SI TarjetaHabiente TarjetaHabiente NA SI TarjetaCredito TarjetaCredito NA SI Envio Envio NA SI InformacionFraude InformacionFraude NA SI Descripción Estructura que contiene la información de la compra Estructura que contiene la información de la persona quien realiza a compra. Estructura que contiene la información del titular de la tarjeta de crédito Estructura que contiene la información de la tarjeta de crédito con la que se realizará la compra. Estructura que contiene la información del destino a donde se enviará el producto a comprar. Estructura que contiene la información que debe enviarse al módulo antifraude. 8

9 productos Lista<producto> NA SI SuscripcionTransaccion SuscripcionTransaccion NA NO Estructura que contiene la información del producto o los productos a comprar Estructura que contiene la respuesta del proceso de suscripción de la tarjeta de crédito A continuación se detalla cada uno de los elementos descritos en la estructura anterior. Estructura de datos - Compra Estructura que contiene la información de la compra. Dentro de los campos que contiene esta estructura tenemos la referencia, descripción, y todo lo relacionado con valores del producto o los productos a pagar. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido referencia Sting 100 SI descripcion 100 No Descripción Número que identifica la compra Descripción o comentarios de la transacción. valor Float 9 SI Valor de la compra. Iva Float 9 SI Valor del IVA basedebolucioniva Float 9 SI isomoneda 3 SI numerocuotas Int 2 SI Base de la devolución de la compra Nombre de la moneda que corresponde al país que fue ejecutada la compra. COP para pesos Colombianos y USD para dólares Numero de cuotas a diferir el valor de la compra. Puede estar entre 1 y 36 9

10 Estructura de datos - Cliente Estructura que contiene la información de la persona quien realiza a compra. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido Nombre 100 SI Apellido 100 SI documento 20 SI 100 SI telefono 15 SI telefonooficina 15 NO Descripción Nombre del propietario o de la persona que compró el producto Apellido del propietario o de la persona que compró el producto Número de identificación del propietario o de la persona que compró el producto del dueño o de la persona que compró el producto. Teléfono Residencia del propietario o de la persona que compró el producto. Teléfono de oficina del propietario o de la persona que compró el producto. Estructura de datos TarjetaHabiente Estructura que contiene la información del titular de la tarjeta de crédito. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido Nombre 100 SI Apellido 100 SI Documento 20 No cliente 100 SI Descripción Nombre del titular de la tarjeta de crédito Apellido del Titular de la tarjeta de crédito Documento de identificación del titular de la tarjeta de crédito de la persona titular de la tarjeta de crédito 10

11 Teléfono 15 SI País 2 SI estadoprovincia 2 SI Ciudad 250 SI Dirección 250 SI codigopostal 10 SI Teléfono de la persona titular de la tarjeta de crédito País de correspondencia del titular de la tarjeta de crédito. Formato ISO países 2 caracteres Si el país es US tiene que ser 2 letras mayúsculas, en caso contrario no se tendrá en cuenta. Ciudad de correspondencia del titular de la tarjeta de crédito. Dirección de correspondencia del titular de la tarjeta de crédito Código postal del titular de la tarjeta de crédito. Para Estados Unidos de 5 o 5-4 dígitos. Para Canadá LNL NLN (L letra y N número). Estructura de datos TarjetaCredito Estructura que contiene la información de la tarjeta de crédito con la que se realizará la compra. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido Idfranquicia Int 1 SI numerotarjeta 16 SI mesvencimiento 2 SI anovencimiento 4 SI codigoseguridad Int 4 SI tipocuenta 1 SI Descripción Identificador de la franquicia, ver operación obtenerfranquicias Número de la tarjeta de crédito Mes de vencimiento de la tarjeta de crédito Año de vencimiento de la tarjeta de crédito Son los 3 o 4 últimos números que tiene al respaldo la tarjeta de crédito Corresponde: Puede ser Crédito C, Ahorros (A) o Corriente (R). 11

12 Estructura de datos Envio Estructura que contiene la información del destino a donde se enviará el producto a comprar. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido pais 2 SI ciudad 250 SI direccion 250 SI nombre 100 SI apellido 100 SI estadoprovincia 2 SI codigopostal 10 SI metodo 50 SI Descripción País de correspondencia a donde se enviara el producto. Ciudad a donde se enviara el producto. Dirección de domicilio a donde se enviara el producto. Nombre de la persona que recibe el producto Apellido de la persona que recibe el producto Si el país es Estados Unidos o Canadá debe enviarse: Formato ISO de dos caracteres para estados. Código postal del titular de la tarjeta de crédito. Para Estados Unidos de 5 o 5-4 dígitos. Para Canadá LNL NLN (L letra y N número). Método de envío del producto. posible valores: - Sameday: servicio en el mismo día o Courier - 1 día: al día siguiente o el servicio durante la noche. - 2 días: el servicio de dos días - 3 días: el servicio de tres días - Lowcost: servicio de menor costo - Pickup: Tienda pick-up - Otra: Otro método de envío 12

13 Estructura de datos InformacionFraude Estructura que contiene la información que debe enviarse al módulo antifraude quien hace el procesamiento para mitigar la probabilidad de fraude dentro de la transacción. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido Descripción ipcomprador 20 SI IP de donde es enviada la transacción. hostcomprador 100 NO El nombre del dominio de donde es enviando la transacción. Cookie 100 SI Identificador de sesión useragent 100 SI Nombre del navegador devicefingerprint 100 SI Identificador del devicefingerprint usado en el script. Ver Modelo de Integración dispositivos huellas dactilares. Estructura de datos Productos Estructura que contiene la información del producto o los productos a comprar, esta estructura es una lista de objetos de tipo Producto la cual contiene la siguiente información. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido Descripción codigoitem Int 100 SI Código que identifica el producto nombreitem 100 SI Nombre del producto valoritem Float 9 SI Valor del producto cantidaditem Int - SI codigocategoria Int 100 SI nombrecategoria 100 SI Cantidad disponible del producto debe ser mayor a 0 Código que identifica la categoría que va asociada al producto Nombre de la categoría que va asociada al producto 13

14 Estructura de datos - SuscripcionTransaccion Estructura de datos que contiene la información necesaria para suscribir tarjetas que pueden ser utilizadas a futuro, esta suscripción solo se realiza si la transacción es aprobada. Esta información es opcional por lo que no es requerida en caso de no utilizar este servicio. La estructura contiene dos objetos los cuales se describen a continuación: Estructura de datos - suscribir Estructura de datos que contiene información acerca del proceso de suscripción. Estructura en donde Nombre Parámetro Tipo de Longitud Dato Máximo Requerido Descripción Bandera donde indica si se desea Suscribir Boolean - SI suscribir el usuario:(true, False). True es para suscribir False en caso contrario. Estructura de datos - SuscripcionUsuario Estructura de datos que contiene la información acerca del usuario que va a suscribir sus medios de pago dentro de la plataforma ASPH. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido Nombre 100 SI Apellido 100 SI cedula 20 SI 100 SI teléfono 15 SI celular 15 NO Descripción Nombre de la persona que va a suscribir Apellido de la persona que va a suscribir Cedula de la persona que va a suscribir Correo electrónico de la persona que va a suscribir Número de Teléfono de la persona que va a suscribir Número de celular de la persona que va a suscribir 14

15 Estructura de datos mensaje de salida operación Transaccion A continuación se detalla la estructura que se debe tener en cuenta para interpretar una respuesta después de haber hecho una petición a la operación Transaccion. Estructura de datos - respuestatransaccion Estructura de datos que contiene la información de la respuesta del proceso de pago. Dentro de esta estructura se detalla el estado de la transacción (Aceptada, Rechazada, en Validación, etc.). Nombre Parámetro Tipo de Dato Descripción idtransaccion Número que identifica la transacción idestado Int Código del Estado nombreestado Nombre del estado que fue generada la transacción referencia Código de Referencia que identifica la compra de uno o varios productos codigorespuesta Código de Respuesta que genera la transacción codigoautorizacion Código que identifica la autorización de la transacción, este código lo genera el banco. valor Float Valor de la transacción Iva Float IVA que genera al valor de la transacción basedevolucion Float Base devolución del IVA fechaprocesamiento Date Fecha que fue procesada la transacción mensaje Mensaje que muestra la aceptación o el rechazo de la transacción antifrauderespuesta antifrauderespuesta Estructura que contiene la respuesta del suscripciontarjetacreditor espuesta suscripciontarjetacredit orespuesta módulo antifraude para la transacción Estructura que contiene la respuesta del proceso de suscripción de la tarjeta de crédito 15

16 Estructura de datos - antifrauderespuesta Estructura que contiene la respuesta del módulo antifraude para la transacción. Nombre Parámetro Tipo de Dato Descripción riesgo Int Es la escala de 0 a 100 que devuelve el modulo antifraude que indica el riesgo de la tracción mensaje Mensaje que muestra la aceptación o el rechazo de la transacción Estructura de datos - suscripciontarjetacreditorespuesta Estructura que contiene la respuesta del proceso de suscripción de la tarjeta de crédito en caso que dentro de la petición se haya enviado la solicitud de suscribir el medio de pago. Nombre Parámetro Tipo de Dato Descripción suscrito Boolean Identificador que proporciona la información si la suscripción fue exitosa o no. (TRUE) si el proceso fue exitoso, (FALSE) si el proceso no se realizó. codigoerror Código de error en caso de que la suscripción no se haya realizado con éxito. suscripcionrespuesta suscripcionrespuesta Objeto que contiene la información de la suscripción. suscripciontarjetarespuesta suscripciontarjetarespuesta Objeto que contiene la información de la tarjeta Suscrita suscripciontitularrespuesta suscripciontitularrespuesta Objeto que contiene la información del Titular de la tarjeta que se suscribió. 16

17 Estructura de datos suscripcionrespuesta Objeto que contiene la información de la suscripción. Nombre Parámetro Tipo de Dato Descripción idusuariosubscripcion Int Código que identifica de la suscripción suscripcionid Código o llave que permite realizar el pago fechasuscripcion Date Fecha que fue realizada la suscripción horasuscripcion Date Hora que fue realizada la suscripción Estructura de datos suscripciontarjetarespuesta Objeto que contiene la información de la tarjeta Suscrita. Nombre Parámetro Tipo de Dato Descripción idfranquicia Int Identificador de la franquicia, ver operación obtenerfranquicias nombrefranquicia Número de la tarjeta de crédito numerobin Int Los 6 primeros números de la tarjeta de crédito donde se identifica el banco. numeroproducto Int Los últimos 4 números de la tarjeta de crédito donde se identifica el producto. Estructura de datos - suscripciontitularrespuesta Objeto que contiene la información del Titular de la tarjeta que se suscribió. Nombre Parámetro Tipo de Dato Descripción nombretarjetahabiente Nombre del titular de la tarjeta de crédito apellidotarjetahabiente Apellido del titular de la tarjeta de crédito 17

18 tarjetahabiente telefonotarjetahabiente documentotarjetahabiente paiscorrespondencia estadoprovincia ciudadcorrespondencia direccioncorrespondencia codigopostal int del titular de la tarjeta de crédito Teléfono del titular de la tarjeta de crédito Documento de identificación del titular de la tarjeta de crédito País residencia del titular de la tarjeta de crédito Si el país es US tiene que ser 2 letras mayúsculas, en caso contrario no se tendrá en cuenta. Código estándar de los estados. Nombre del titular de la tarjeta de crédito Dirección del titular de la tarjeta de crédito Código que identifica la dirección del país del titular de la tarjeta de crédito EJEMPLO ENTRADA Y SALIDA OPERACIÓN transaccion Entrada transacción <soapenv:envelope xmlns:soapenv=" xmlns:ws=" <soapenv:header> <wsse:security soapenv:mustunderstand="1" xmlns:wsse=" xmlns=" <wsse:usernametoken> <wsse:username>iatai</wsse:username> <wsse:password Type=" </wsse:usernametoken> </wsse:security> </soapenv:header> <soapenv:body> <ws:transaccion> <informaciontransaccion> 18

19 19 <Compra> <referencia>test transación 1</referencia>  <descripcion>prueba</descripcion> <valor>2</valor> <isomoneda>usd</isomoneda> <numerocuotas>3</numerocuotas> <iva>0</iva> <basedevolucioniva>0</basedevolucioniva> </Compra> <Cliente><nombre>Lady</nombre> <apellido>ocampo</apellido> <documento> </documento> <telefono> </telefono>  <telefonooficina> </telefonooficina></cliente> <TarjetaHabiente> <nombre>lady</nombre> <apellido>ocampo</apellido> <telefono> </telefono>  <documento> </documento> <pais>co</pais> <estadoprovincia>1</estadoprovincia> <ciudad>bog</ciudad> <direccion>calle 60</direccion> <codigopostal>5700</codigopostal> </TarjetaHabiente> <TarjetaCredito> <franquicia>1</franquicia> <numerotarjeta> </numerotarjeta> <mesvencimiento>3</mesvencimiento> <anovencimiento>2015</anovencimiento> <codigoseguridad>123</codigoseguridad> <tipocuenta>c</tipocuenta> </TarjetaCredito>  <Envio> <pais>co</pais> <ciudad>bog</ciudad> <direccion>calle 89</direccion> <nombre>sonia</nombre> <apellido>castro</apellido>

20 <estadoprovincia>1</estadoprovincia> <codigopostal>5700</codigopostal> <metodo>fasfadsfasdfas</metodo> </Envio> <InformacionFraude> <ipcomprador> </ipcomprador>  <hostcomprador>localhost</hostcomprador> <cookie>jm9l2lf11pv6qr63jpaampeln3</cookie> <useragent>mozilla/5.0 (Windows NT 6.1; WOW64; rv:22.0) Gecko/ Firefox/22.0</userAgent> <devicefingerprint>jm9l2lf11pv6qr63jpaampeln3</devicefingerprint> </InformacionFraude> <productos>  <producto> <codigoitem>8999</codigoitem> <nombreitem>zapatos</nombreitem> <valoritem>2000</valoritem> <cantidaditem>1</cantidaditem> <codigocategoria>3</codigocategoria> <nombrecategoria>azul</nombrecategoria> </producto> </productos>  <SuscripcionTransaccion> <suscribir>true</suscribir>  <SuscripcionUsuario> <nombre>lady</nombre> <apellido>ocampo</apellido> <cedula> </cedula> <telefono> </telefono>  </SuscripcionUsuario> </SuscripcionTransaccion> </informaciontransaccion> </ws:transaccion> </soapenv:body> </soapenv:envelope> Salida transacción 20

21 Aprobada <S:Envelope xmlns:s=" <S:Body> <ns2:transaccionresponse xmlns:ns2=" <respuestatransaccion> <idtransaccion>1023</idtransaccion> <referencia>test transación 1</referencia> <idestado>1</idestado> <nombreestado>aprobada</nombreestado> <codigorespuesta>100</codigorespuesta> <codigoautorizacion>777777</codigoautorizacion> <valor>2.0</valor> <iva>0.0</iva> <basedevolucion>0.0</basedevolucion> <fechaprocesamiento> :21:40 PM</fechaProcesamiento> <mensaje>accept</mensaje> <antifrauderespuesta> <riesgo>17</riesgo> <mensaje>accept</mensaje> </antifrauderespuesta> <suscripciontarjetacreditorespuesta> <suscrito>true</suscrito> <suscripcionrespuesta> <idusuariosubscripcion>1081</idusuariosubscripcion> <suscripcionid>f0acb6a2182d18c69cf1dab84b5c865a:36a16a e0c922b6ea7a23a56d2</sus cripcionid> <fechasuscripcion> </fechasuscripcion> <horasuscripcion>16:21:44</horasuscripcion> <suscripciontarjetarespuesta> <idfranquicia>1</idfranquicia> <nombrefranquicia>visa</nombrefranquicia> <numerobin>411111</numerobin> <numeroproducto>1111</numeroproducto> </suscripciontarjetarespuesta> <suscripciontitularrespuesta> <nombretarjetahabiente>lady</nombretarjetahabiente> <apellidotarjetahabiente>ocampo</apellidotarjetahabiente> <telefonotarjetahabiente> </telefonotarjetahabiente> <documentotarjetahabiente> </documentotarjetahabiente> <paiscorrespondencia>co</paiscorrespondencia> <estadoprovincia>n/a</estadoprovincia> <ciudadcorrespondencia>bog</ciudadcorrespondencia> <direccioncorrespondencia>calle 60</direccionCorrespondencia> 21

22 <codigopostal>n/a</codigopostal> </suscripciontitularrespuesta> </suscripcionrespuesta> </suscripciontarjetacreditorespuesta> </respuestatransaccion> </ns2:transaccionresponse> </S:Body> </S:Envelope> Rechazada <S:Envelope xmlns:s=" <S:Body> <ns2:transaccionresponse xmlns:ns2=" <respuestatransaccion> <idtransaccion>1024</idtransaccion> <referencia>test transación 2</referencia> <idestado>2</idestado> <nombreestado>rechazada</nombreestado> <codigorespuesta>231</codigorespuesta> <codigoautorizacion/> <valor>0.0</valor> <iva>0.0</iva> <basedevolucion>0.0</basedevolucion> <fechaprocesamiento> :39:42 PM</fechaProcesamiento> <mensaje>reject</mensaje> <antifrauderespuesta> <riesgo>0</riesgo> <mensaje>reject</mensaje> </antifrauderespuesta> </respuestatransaccion> </ns2:transaccionresponse> </S:Body> </S:Envelope> Declinada <S:Envelope xmlns:s=" <S:Body> <ns2:transaccionresponse xmlns:ns2=" <respuestatransaccion> <idtransaccion>1024</idtransaccion> <referencia>test transación 2</referencia> <idestado>2</idestado> 22

23 <nombreestado>declinada</nombreestado> <codigorespuesta>99</codigorespuesta> <codigoautorizacion/> <valor>0.0</valor> <iva>0.0</iva> <basedevolucion>0.0</basedevolucion> <fechaprocesamiento> :39:42 PM</fechaProcesamiento> <mensaje>reject</mensaje> <antifrauderespuesta> <riesgo>0</riesgo> <mensaje>reject</mensaje> </antifrauderespuesta> </respuestatransaccion> </ns2:transaccionresponse> </S:Body> </S:Envelope> Validación <S:Envelope xmlns:s=" <S:Body> <ns2:transaccionresponse xmlns:ns2=" <respuestatransaccion> <idtransaccion>1024</idtransaccion> <referencia>test transación 2</referencia> <idestado>2</idestado> <nombreestado>validación</nombreestado> <codigorespuesta>480</codigorespuesta> <codigoautorizacion/> <valor>0.0</valor> <iva>0.0</iva> <basedevolucion>0.0</basedevolucion> <fechaprocesamiento> :39:42 PM</fechaProcesamiento> <mensaje>reject</mensaje> <antifrauderespuesta><riesgo>0</riesgo> <mensaje>reject</mensaje></antifrauderespuesta></respuestatransaccion> </ns2:transaccionresponse></s:body> 23

24 </S:Envelope> OPERACIÓN ConsultaPorReferencia La Operación ConsultaPorReferencia permite realizar la consulta de una transacción con el número de la referencia de la compra que genera la transacción. FLUJO DEL PROCESO 24

25 A continuación se describe el flujo del proceso de acuerdo a la gráfica anterior. Envió de petición SOAP a la plataforma ASPH con la información requerida para el proceso de la consulta. Recepción de la información de la plataforma ASPH, una vez recibida la información en la plataforma se busca la información de la transacción solicitada. Si la plataforma encuentra la información requerida devuelve como respuesta los datos encontrados. Estructura de datos mensaje de entrada operación ConsultaPorReferencia A continuación se detalla la estructura que se debe tener en cuenta para realizar una petición a la operación ConsultaPorReferencia. Estructura de datos ConsultaPorReferencia La estructura ConsultaPorReferencia, permite generar el código de referencia que identifica la compra de uno o varios productos. 25

26 Nombre Parámetro Tipo de Dato Longitud Máximo Requerido Referencia 19 SI Descripción Código de Referencia que identifica la compra de uno o varios productos. Estructura de datos mensaje de salida operación ConsultaPorReferencia A continuación se detalla la estructura que se debe tener en cuenta para interpretar una respuesta después de haber hecho una petición a la operación ConsultaPorReferencia. Estructura de datos respuestatransaccionreferencia La estructura respuestatransaccionreferencia, contiene la información detallada de la referencia especifica buscada. Nombre Parámetro Tipo de Dato Descripción idtransaccion Número que identifica la transacción idestado INT Código del estado de la transacción nombreestado Nombre del estado en que se encuentra la transacción referencia Código de Referencia que identifica la compra de uno o varios productos. codigorespuesta Código de respuesta que genera la transacción codigoautorizacion Código de Autorización que genera la transacción Valor Float El valor que corresponde a la compra Iva Float Valor del impuesto de la compra basedevolucion Float Valor de la base de devolución del IVA fechaprocesamiento Date Fecha que fue generada la transacción mensaje Mensaje adicional 26

27 EJEMPLO ENTRADA Y SALIDA OPERACIÓN ConsultaPorReferencia Entrada <soapenv:envelope xmlns:soapenv=" xmlns:ws=" <soapenv:header> <wsse:security soapenv:mustunderstand="1" xmlns:wsse=" xmlns=" <wsse:usernametoken> <wsse:username>iatai</wsse:username> <wsse:password Type=" </wsse:usernametoken> </wsse:security> </soapenv:header> <soapenv:body> <ws:consultarporreferencia> <referencia>wt </referencia> </ws:consultarporreferencia> </soapenv:body> </soapenv:envelope> Salida ConsultaPorReferencia APROBADA <S:Envelope xmlns:s=" <S:Body> <ns2:consultarporreferenciaresponse xmlns:ns2=" <respuestatransaccionreferenciaxsi:type="ns2:tarjetacreditorespuesta" xmlns:xsi=" <idtransaccion>746</idtransaccion> <idestado>1</idestado> <nombreestado>aprobada</nombreestado> 27

28 <referencia>wt </referencia> <codigorespuesta>100</codigorespuesta> <codigoautorizacion>888888</codigoautorizacion> <riesgo/> <valor>230.0</valor> <iva>0.0</iva> <basedevolucion>0.0</basedevolucion> <fechaprocesamiento> :33:34 PM</fechaProcesamiento> <mensaje>accept</mensaje> </respuestatransaccionreferencia> </ns2:consultarporreferenciaresponse> </S:Body> </S:Envelope> RECHAZADA <S:Envelope xmlns:s=" <S:Body> <ns2:consultarporreferenciaresponse xmlns:ns2=" <respuestatransaccionreferencia xsi:type="ns2:tarjetacreditorespuesta" xmlns:xsi=" <idtransaccion>168</idtransaccion> <idestado>2</idestado> <nombreestado>rechazada</nombreestado> <referencia> </referencia> <codigorespuesta/> <codigoautorizacion/> <riesgo/> <valor>0.0</valor> <iva>0.0</iva> <basedevolucion>0.0</basedevolucion> <fechaprocesamiento> :56:56 AM</fechaProcesamiento> </respuestatransaccionreferencia> </ns2:consultarporreferenciaresponse> </S:Body></S:Envelope> DECLINADA <S:Envelope xmlns:s=" <S:Body> <ns2:consultarporreferenciaresponse xmlns:ns2=" <respuestatransaccionreferencia xsi:type="ns2:tarjetacreditorespuesta" xmlns:xsi=" <idtransaccion>95</idtransaccion> 28

29 <idestado>3</idestado> <nombreestado>declinada</nombreestado> <referencia>xasddssasxg5cdhdfdfdzdfjfd</referencia> <codigorespuesta>99</codigorespuesta> <codigoautorizacion/> <riesgo/> <valor>0.0</valor> <iva>0.0</iva> <basedevolucion>0.0</basedevolucion> <fechaprocesamiento> :16:52 AM</fechaProcesamiento> <mensaje>accept</mensaje> </respuestatransaccionreferencia> </ns2:consultarporreferenciaresponse> </S:Body> </S:Envelope> VALIDACIÓN <S:Envelope xmlns:s=" <S:Body> <ns2:consultarporreferenciaresponse xmlns:ns2=" <respuestatransaccionreferencia xsi:type="ns2:tarjetacreditorespuesta" xmlns:xsi=" <idtransaccion>562</idtransaccion> <idestado>4</idestado> <nombreestado>en Validación</nombreEstado> <referencia>ref-20</referencia> <codigorespuesta>480</codigorespuesta> <riesgo/> <valor>0.0</valor> <iva>0.0</iva> <basedevolucion>0.0</basedevolucion> <fechaprocesamiento> :01:35 AM</fechaProcesamiento> <mensaje>-48:ha ocurrido un error en el servidor</mensaje> </respuestatransaccionreferencia> </ns2:consultarporreferenciaresponse> </S:Body></S:Envelope> 29

30 OPERACIÓN ConsultarTransaccion La Operación ConsultarTransaccion permite realizar la consulta de una transacción con el número del id IdTransaccion y código de referencia de una compra. FLUJO DEL PROCESO A continuación se describe el flujo del proceso de acuerdo a la gráfica anterior. Envió de petición SOAP a la plataforma ASPH con la información requerida para el proceso de la consulta. Recepción de la información de la plataforma ASPH, una vez recibida la información en la plataforma se busca la información de la transacción solicitada. Si la plataforma encuentra la información requerida devuelve como respuesta los datos encontrados. 30

31 Estructura de datos mensaje de entrada operación ConsultaTransaccion A continuación se detalla la estructura que se debe tener en cuenta para realizar una petición a la operación ConsultarTransaccion. Estructura de datos ConsultarTransaccion La estructura ConsultarTransaccion, permite consultar toda la información de la transacción ingresando el idtransaccion y código de referencia. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido idtransaccion 100 SI Referencia 100 SI Descripción Código de único que identifica la transacción. Código de Referencia que identifica la compra de uno o varios productos. Estructura de datos mensaje de salida operación ConsultarTransaccion A continuación se detalla la estructura que se debe tener en cuenta para interpretar una respuesta después de haber hecho una petición a la operación ConsultaTransaccion. Estructura de datos respuestaconsultartransaccion La estructura respuestatransaccionreferencia, contiene la información detallada de la referencia específica buscada. Nombre Parámetro Tipo de Dato Descripción idtransaccion Número único que identifica la transacción referencia Código de Referencia que identifica la compra de uno o varios productos idestado Int Código del estado de la transacción nombreestado Nombre del estado en que se encuentra la transacción codigorespuesta Código de respuesta que genera la transacción 31

32 codigoautorizacion Código de Autorización que genera la transacción Valor Float El valor que corresponde a la compra Iva Float Valor del impuesto de la compra basedevolucion Float Porcentaje que calcula el valor del iva generado en la compra en caso de tener devolución fechaprocesamiento DATE Fecha que fue generada la transacción antifrauderespuesta antifrauderespuesta Puntaje de riesgo que tuvo la transacción en el módulo antifraude. Estructura de datos antifrauderespuesta Estructura que contiene la información de respuesta del módulo antifraude. Nombre Parámetro Tipo de Dato Descripción riesgo int Puntaje de riesgo que tuvo la transacción en el módulo antifraude. mensaje Mensaje informativo donde indica si fue Aceptada o Rechazada la transacción ENTRADA EJEMPLO ENTRADA Y SALIDA OPERACIÓN ConsultarTransaccion <soapenv:envelope xmlns:soapenv=" xmlns:ws=" <soapenv:header> <wsse:security soapenv:mustunderstand="1" xmlns:wsse=" xmlns=" <wsse:usernametoken> <wsse:username>iatai</wsse:username> <wsse:password Type=" </wsse:usernametoken> 32

33 </wsse:security> </soapenv:header> <soapenv:body> <ws:consultartransaccion> <informacionconsulta> <idtransaccion>1475</idtransaccion> <referencia>test transación nueva prueba</referencia> </informacionconsulta> </ws:consultartransaccion> </soapenv:body> </soapenv:envelope> Salida ConsultarTransaccion APROBADA <S:Envelope xmlns:s=" <S:Body> <ns2:consultartransaccionresponse xmlns:ns2=" <respuestaconsultartransaccion> <idtransaccion>1475</idtransaccion> <referencia>test transación nueva prueba</referencia> <idestado>1</idestado> <nombreestado>aprobada</nombreestado> <codigorespuesta>100</codigorespuesta> <codigoautorizacion>777777</codigoautorizacion> <valor>2.0</valor> <iva>0.0</iva> <basedevolucion>0.0</basedevolucion> <fechaprocesamiento> :38:18 PM</fechaProcesamiento> <mensaje>accept</mensaje> <antifrauderespuesta> <riesgo>17</riesgo> <mensaje>accept</mensaje> </antifrauderespuesta> </respuestaconsultartransaccion> </ns2:consultartransaccionresponse> </S:Body> </S:Envelope> 33

34 OPERACIÓN ObtenerFranquicia La Operación ObtenerFranquicia permite realizar la consulta de las franquicias habilitadas para una cuenta específica. Estructura de datos mensaje de entrada operación ObtenerFranquicia La operación ObtenerFranquicia no requiere de una estructura específica para obtener la información, lo único que requiere es configurar el username token. Para más detalle ver ejemplo de entrada. Estructura de datos mensaje de salida operación ObtenerFranquicia A continuación se detalla la estructura que se debe tener en cuenta para interpretar una respuesta después de haber hecho una petición a la operación ObtenerFranquicia. Estructura de datos obtenerfranquiciasresponse La estructura obtenerfranquiciasresponse, contiene la información detallada de las franquicias que puede usar la cuenta registrada dentro de la plataforma ASPH. Nombre Parámetro Tipo de Dato Descripción respuestafranquicias respuestafranquicias Objeto que contiene la información de las franquicias. Estructura de datos respuestafranquicias Estructura que contiene la información detallada de las franquicias. Nombre Parámetro Tipo de Dato Descripción idfranquicia int Identificador de la franquicia dentro de la plataforma ASPH. nombre Nombre de la franquicia 34

35 EJEMPLO ENTRADA Y SALIDA OPERACIÓN ObtenerFranquicia ENTRADA <soapenv:envelope xmlns:soapenv=" xmlns:ws=" <soapenv:header> <wsse:security soapenv:mustunderstand="1" xmlns:wsse=" xmlns=" <wsse:usernametoken> <wsse:username>iatai</wsse:username> <wsse:password Type=" </wsse:usernametoken> </wsse:security> </soapenv:header> <soapenv:body> <ws:obtenerfranquicias/> </soapenv:body> </soapenv:envelope> SALIDA <S:Envelope xmlns:s=" <S:Body> <ns2:obtenerfranquiciasresponse xmlns:ns2=" <respuestafranquicias> <idfranquicia>2</idfranquicia> <nombre>amex</nombre> </respuestafranquicias> <respuestafranquicias> <idfranquicia>1</idfranquicia> <nombre>visa</nombre> </respuestafranquicias> <respuestafranquicias> <idfranquicia>3</idfranquicia> <nombre>mastercard</nombre> 35

36 </respuestafranquicias> <respuestafranquicias> <idfranquicia>5</idfranquicia> <nombre>dinners Club</nombre> </respuestafranquicias> </ns2:obtenerfranquiciasresponse> </S:Body> </S:Envelope> 36

37 OPERACIÓN TransaccionAereo La Operación TransaccionAereo permite realizar el pago electrónico en cualquier tienda virtual por medio de tarjetas de crédito nacional e internacional, esta transacción se diferencia con la Operación Transaccion es que divide el pago entre la aerolínea y el comercio. FLUJO DEL PROCESO A continuación se describe el flujo del proceso de acuerdo a la gráfica anterior. Envió de petición SOAP a la plataforma ASPH con toda la información requerida para realizar la compra. Recepción de la información en la plataforma ASPH. Una vea es recibida la información en la plataforma, esta es enviada al módulo antifraude, en donde se validan las reglas configuradas de tal forma que la transacción sea aceptada, rechazada o quede en validación. 37

38 Si el resultado generado por el modulo antifraude de la transacción es Aceptada, se retorna notificación de la respuesta a la plataforma ASPH. Si el resultado generado por el modulo antifraude de la transacción es rechazada, se retorna notificación de la respuesta a la plataforma ASPH. Si el resultado generado por el modulo antifraude de la transacción es En validación, se envía a un proceso de verificación manual. Una vez la Plataforma ASPH realiza todo el procesamiento de la transacción, se envía la respuesta de la petición a quien consume el servicio mediante un mensaje SOAP. Estructura de datos mensaje de entrada operación TransaccionAereo A continuación se detalla la estructura que se debe tener en cuenta para realizar una petición a la operación TransaccionAereo. Estructura de datos transacciónaereo Estructura que contiene toda la información necesaria para poder realizar una compra mediante la plataforma ASPH. A continuación se detalla la información que compone esta estructura. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido Compra Compra NA Si Cliente Cliente NA SI TarjetaHabiente TarjetaHabiente NA SI TarjetaCredito TarjetaCredito NA SI Envio Envio NA NO Descripción Estructura que contiene la información de la compra Estructura que contiene la información de la persona quien realiza a compra. Estructura que contiene la información del titular de la tarjeta de crédito Estructura que contiene la información de la tarjeta de crédito con la que se realizará la compra. Estructura que contiene la información del destino a donde se enviará el producto a comprar. 38

39 InformacionFraude InformacionFraude NA SI aereo Lista<Aereo> NA SI Estructura que contiene la información que debe enviarse al módulo antifraude. Estructura que contiene la información del producto o los productos a comprar A continuación se detalla cada uno de los elementos descritos en la estructura anterior. Estructura de datos - Compra Estructura que contiene la información de la compra. Dentro de los campos que contiene esta estructura tenemos la referencia, descripción, y todo lo relacionado con valores del producto o los productos a pagar. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido Referencia Sting 100 SI Descripción Número que identifica la compra Valor Float 9 SI Valor de la compra. IvaAereo Float 9 SI Valor del IVA Aereo. basedebolucionivaa ereo Float 9 SI isomoneda 3 SI numerocuotas Int 2 SI tasaaeroportuaria float 10 SI Base de la devolución de la compra Nombre de la moneda que corresponde al país que fue ejecutada la compra. COP para pesos Colombianos y USD para dólares Numero de cuotas a diferir el valor de la compra. Puede estar entre 1 y 36 Valor de la tasa aeroportuaria valoradmin float 10 SI Valor Administrativo. 39

40 ivaadmin float 10 SI Valor del IVA administrativo. basedevolucionariai vaadmin Float 10 SI Valor de la tasa base de devolución del IVA Administrativo. Estructura de datos - Cliente Estructura que contiene la información de la persona quien realiza a compra. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido Nombre 100 SI Apellido 100 SI documento 20 SI 100 SI telefono 15 NO Descripción Nombre del propietario o de la persona que compró el producto Apellido del propietario o de la persona que compró el producto Número de identificación del propietario o de la persona que compró el producto del dueño o de la persona que compró el producto. Teléfono Residencia del propietario o de la persona que compró el producto. Estructura de datos TarjetaHabiente Estructura que contiene la información del titular de la tarjeta de crédito. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido Nombre 100 SI Apellido 100 SI Descripción Nombre del titular de la tarjeta de crédito Apellido del Titular de la tarjeta de crédito 40

41 Documento 20 No 100 SI Teléfono 15 NO País 2 SI estadoprovincia 2 SI Ciudad 250 SI codigopostal 10 SI Documento de identificación del titular de la tarjeta de crédito de la persona titular de la tarjeta de crédito Teléfono de la persona titular de la tarjeta de crédito País de correspondencia del titular de la tarjeta de crédito. Formato ISO países 2 caracteres Si el país es US tiene que ser 2 letras mayúsculas, en caso contrario no se tendrá en cuenta. Ciudad de correspondencia del titular de la tarjeta de crédito. Código postal del titular de la tarjeta de crédito. Para Estados Unidos de 5 o 5-4 dígitos. Para Canadá LNL NLN (L letra y N número). Estructura de datos TarjetaCredito Estructura que contiene la información de la tarjeta de crédito con la que se realizará la compra. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido franquicia Int 1 SI numerotarjeta 16 SI mesvencimiento 2 SI anovencimiento 4 SI codigoseguridad Int 4 SI Descripción Identificador de la franquicia, ver operación obtenerfranquicias Número de la tarjeta de crédito Mes de vencimiento de la tarjeta de crédito Año de vencimiento de la tarjeta de crédito Son los 3 o 4 últimos números que tiene al respaldo la tarjeta de crédito 41

42 tipocuenta 1 SI Corresponde: Puede ser Crédito C, Ahorros (A) o Corriente (R). Estructura de datos Envio Estructura que contiene la información del destino a donde se enviará el producto a comprar. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido pais 2 SI ciudad 250 SI direccion 250 SI nombre 100 SI apellido 100 SI estadoprovincia 2 SI codigopostal 10 SI Descripción País de correspondencia a donde se enviara el producto. Ciudad a donde se enviara el producto. Dirección de domicilio a donde se enviara el producto. Nombre de la persona que recibe el producto Apellido de la persona que recibe el producto Si el país es Estados Unidos o Canadá debe enviarse: Formato ISO de dos caracteres para estados. Código postal del titular de la tarjeta de crédito. Para Estados Unidos de 5 o 5-4 dígitos. Para Canadá LNL NLN (L letra y N número). 42

43 metodo 50 SI Método de envío del producto. posible valores: - Sameday: servicio en el mismo día o Courier - 1 día: al día siguiente o el servicio durante la noche. - 2 días: el servicio de dos días - 3 días: el servicio de tres días - Lowcost: servicio de menor costo - Pickup: Tienda pick-up - Otra: Otro método de envío Estructura de datos InformacionFraude Estructura que contiene la información que debe enviarse al módulo antifraude quien hace el procesamiento para mitigar la probabilidad de fraude dentro de la transacción. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido Descripción ipcomprador 20 SI IP de donde es enviada la transacción. Cookie 100 SI Identificador de sesión useragent 100 SI Nombre del navegador devicefingerprint 100 SI Identificador del devicefingerprint usado en el script. Ver Modelo de Integración dispositivos huellas dactilares. Estructura de datos Aereo Estructura que contiene la información del producto o los productos a comprar, esta estructura es una lista de objetos de tipo Producto la cual contiene la siguiente información. 43

44 Nombre Parámetro Tipo de Dato Longitud Máximo Requerido Descripción codigoaerolinea 100 SI Código que identifica la aerolínea. nacional Booleano 1 SI Identifica si codigoadmin 9 SI Valor del producto codigoreserva Int 10 SI Código que identifica la reserva. pasajeros List<pasajero> N/A SI Lista de puede contener una o varias estructuras de tipo pasajero ruta Ruta N/A SI Estructura de datos en el que se definen los datos de la ruta. Estructura de datos - Pasajero Estructura de datos que contiene información acerca del proceso de suscripción. Estructura en donde Nombre Parámetro Tipo de Longitud Dato Máximo Requerido Descripción nombre 100 SI Nombre de la persona que va realizar el viaje. apellido 100 SI Apellidos de la persona que va realizar el viaje tipo Int 2 SI Tipo de pasajero. valor float 6 SI Valor del viaje. Estructura de datos - Ruta Estructura de datos que contiene información acerca de la ruta. Estructura en donde Nombre Parámetro Tipo de Longitud Dato Máximo Requerido Descripción idavuelta boolean 1 SI Dato con él se sabe si el viaje es de ida y vuelta o solamente ida. fechasalida Date N/A SI Fecha de salida del vuelo. 44

45 aeropuertos List<aeropu esto> N/A SI Lista en donde se envían una o varias estructuras de datos de aeropuerto. Estructura de datos - Aeropuerto Estructura de datos que contiene la información acerca de los aeropuertos que intervienen en la ruta. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido Descripción codigo 3 SI Código del aeropuerto. Estructura de datos mensaje de salida operación TransaccionAereo A continuación se detalla la estructura que se debe tener en cuenta para interpretar una respuesta después de haber hecho una petición a la operación TransaccionAereo. Estructura de datos - respuestatransaccionaereo Estructura de datos que contiene la información de la respuesta del proceso de pago. Dentro de esta estructura se detalla el estado de la transacción (Aceptada, Rechazada, en Validación, etc.). Nombre Parámetro Tipo de Dato Descripción idtransaccion Número que identifica la transacción Referencia Referncia de la transacción aéreo. idestado Int Código del Estado. nombreestado Nombre del estado que fue generada la transacción. codigorespuesta Código de Respuesta que genera la transacción codigoautorizacion Código que identifica la autorización de la transacción, este código lo genera el banco. valor Float Valor de la transacción 45

46 Iva Float IVA que genera al valor de la transacción basedevolucion Float Base devolución del IVA fechaprocesamiento Date Fecha que fue procesada la transacción mensaje Mensaje que muestra la aceptación o el dispercionesrespuesta List<dispercionesRespue sta> Estructura de datos - dispersionesrespuesta rechazo de la transacción Lista de una o más estructuras de la estructura dispersionesrespuesta Estructura que contiene la información si hay varias transacciones en la misma operación. Nombre Parámetro Tipo de Dato Descripción idtransaccion Número que identifica la transacción Referencia Referncia de la transacción aéreo. idestado Int Código del Estado. nombreestado Nombre del estado que fue generada la transacción. codigorespuesta Código de Respuesta que genera la transacción codigoautorizacion Código que identifica la autorización de la transacción, este código lo genera el banco. valor Float Valor de la transacción Iva Float IVA que genera al valor de la transacción basedevolucion Float Base devolución del IVA fechaprocesamiento Date Fecha que fue procesada la transacción mensaje Mensaje que muestra la aceptación o el rechazo de la transacción Entrada transacción EJEMPLO ENTRADA Y SALIDA OPERACIÓN transaccionaereo <soapenv:envelope xmlns:soapenv=" xmlns:ws=" 46

47 47 <soapenv:header> <wsse:security xmlns=" xmlns:wsse=" <wsse:usernametoken> <wsse:username>iatai</wsse:username> <wsse:password Type=" </wsse:usernametoken> </wsse:security> </soapenv:header> <soapenv:body> <ws:transaccionaereo> <informaciontransaccion> <Compra> <referencia>aereo B1</referencia>  <valor>110</valor> <isomoneda>usd</isomoneda> <numerocuotas>10</numerocuotas> <valoraereo>90</valoraereo> <ivaaereo>10</ivaaereo> <basedevolucionivaaereo>0</basedevolucionivaaereo> <tasaaeroportuaria>10</tasaaeroportuaria> <valoradmin>10</valoradmin> <ivaadmin>0</ivaadmin> <basedevolucionivaadmin>0</basedevolucionivaadmin> </Compra> <Cliente> <nombre>david</nombre> <apellido>cubillos</apellido> <documento> </documento> <telefono> </telefono>  </Cliente> <TarjetaHabiente> <nombre>david</nombre> <apellido>cubillos</apellido> <telefono> </telefono>  <documento> </documento> <pais>co</pais> <estadoprovincia/>

48 48 <ciudad>bogota</ciudad> <direccion>calle 70</direccion> <codigopostal/> </TarjetaHabiente> <TarjetaCredito> <franquicia>1</franquicia> <numerotarjeta> </numerotarjeta>  <mesvencimiento>10</mesvencimiento> <anovencimiento>2020</anovencimiento> <codigoseguridad>123</codigoseguridad> <tipocuenta>c</tipocuenta> </TarjetaCredito>  <Envio> <pais>co</pais> <ciudad>bogota</ciudad> <direccion>cll</direccion> <nombre>david</nombre> <apellido>cubillos</apellido> <estadoprovincia/> <codigopostal/> <metodo/> </Envio> <InformacionFraude> <ipcomprador> </ipcomprador>  <cookie>123</cookie> <useragent>123</useragent> <devicefingerprint>123</devicefingerprint> </InformacionFraude> <Aereo> <codigoaerolinea>p5</codigoaerolinea> <nacional>true</nacional> <codigoadmin>aa</codigoadmin> <codigoreserva>123456</codigoreserva> <Pasajeros>  <Pasajero> <nombre>david</nombre> <apellido>cubillos</apellido> <tipo>1</tipo> <valor>90</valor> </Pasajero> </Pasajeros>

49 <Ruta> <idavuelta>false</idavuelta> <fechasalida> </fechasalida> <Aeropuertos>  <Aeropuerto> <codigo>bog</codigo> </Aeropuerto> <Aeropuerto> <codigo>lim</codigo> </Aeropuerto> </Aeropuertos> </Ruta> </Aereo> </informaciontransaccion> </ws:transaccionaereo> </soapenv:body> </soapenv:envelope> Salida transacción <S:Envelope xmlns:s=" <S:Body> <ns2:transaccionaereoresponse xmlns:ns2=" <respuestatransaccionaereo> <idtransaccion>1771</idtransaccion> <referencia>aereo B1</referencia> <idestado>8</idestado> <nombreestado>en Proceso de Reverso</nombreEstado> <codigorespuesta>00</codigorespuesta> <codigoautorizacion>969659</codigoautorizacion> <valor>110.0</valor> <iva>10.0</iva> <basedevolucion>0.0</basedevolucion> <fechaprocesamiento> :07:55 PM</fechaProcesamiento> <mensaje>transacción Aprobada</mensaje> <dispersionesrespuesta> <dispersionrespuesta> <idtransaccion>1771</idtransaccion> <referencia>aereo B1</referencia> <idestado>8</idestado> <nombreestado>en Proceso de Reverso</nombreEstado> <codigorespuesta>00</codigorespuesta> <codigoautorizacion>969659</codigoautorizacion> 49

50 <valor>100.0</valor> <iva>10.0</iva> <basedevolucion>0.0</basedevolucion> <fechaprocesamiento> :07:55 PM</fechaProcesamiento> <mensaje>transacción Aprobada</mensaje> </dispersionrespuesta> <dispersionrespuesta> <idtransaccion>1772</idtransaccion> <referencia>aereo B1_3</referencia> <idestado>3</idestado> <nombreestado>declinada</nombreestado> <codigorespuesta>error al procesar compra aerolínea</codigorespuesta> <codigoautorizacion>99</codigoautorizacion> <valor>10.0</valor> <iva>0.0</iva> <basedevolucion>0.0</basedevolucion> <fechaprocesamiento> :07:55 PM</fechaProcesamiento> <mensaje>transacción Declinada</mensaje> </dispersionrespuesta> </dispersionesrespuesta> </respuestatransaccionaereo> </ns2:transaccionaereoresponse> </S:Body> </S:Envelope> 50

51 OPERACIÓN reverso La Operación Reverso permite realizar la reversar una transacción con el número del id IdTransaccion y código de referencia de una compra. FLUJO DEL PROCESO 51

52 A continuación se describe el flujo del proceso de acuerdo a la gráfica anterior. Envió de petición SOAP a la plataforma ASPH con la información requerida para el proceso de la consulta. Recepción de la información de la plataforma ASPH, una vez recibida la información en la plataforma se busca la información de la transacción solicitada. Si la plataforma encuentra la información requerida y la transacción es aprobada procede a realizar el reverso y devuelve la respuesta de la operación realizada. Estructura de datos mensaje de entrada operación reverso A continuación se detalla la estructura que se debe tener en cuenta para realizar una petición a la operación reverso. Estructura de datos informacionreverso La estructura informacionreverso, permite reversar o anular una transacción ingresando el idtransaccion y código de referencia. 52

53 Nombre Parámetro Tipo de Dato Longitud Máximo Requerido idtransaccion 100 SI Referencia 100 SI Descripción Código de único que identifica la transacción. Código de Referencia que identifica la compra de uno o varios productos. Estructura de datos mensaje de salida operación reverso A continuación se detalla la estructura que se debe tener en cuenta para interpretar una respuesta después de haber hecho una petición a la operación Reverso. Estructura de datos reversoresponse La estructura reversoresponse, contiene la información detallada de la operación específica realizada. Nombre Parámetro Tipo de Dato Descripción idtransaccion Número único que identifica la transacción referencia Código de Referencia que identifica la compra de uno o varios productos idestado Int Código del estado de la transacción nombreestado Nombre del estado en que se encuentra la transacción codigorespuesta Código de respuesta que genera la transacción codigoautorizacion Código de Autorización que genera la transacción Valor Float El valor que corresponde a la compra Iva Float Valor del impuesto de la compra basedevolucion Float Porcentaje que calcula el valor del iva generado en la compra en caso de tener devolución fechaprocesamiento DATE Fecha que fue generada la transacción mensaje Mensaje que muestra la aceptación o el rechazo de la transacción 53

54 antifrauderespuesta antifrauderespuesta Puntaje de riesgo que tuvo la transacción en el módulo antifraude. EJEMPLO ENTRADA Y SALIDA OPERACIÓN reverso Entrada transacción <soapenv:envelope xmlns:soapenv=" xmlns:ws=" <soapenv:header> <wsse:security soapenv:mustunderstand="1" xmlns:wsse=" xmlns=" <wsse:usernametoken> <wsse:username>iatai</wsse:username> <wsse:password Type=" </wsse:usernametoken> </wsse:security> </soapenv:header> <soapenv:body> <ws:reverso> <informacionreverso> <idtransaccion>2724</idtransaccion> <referencia>pruebatclady</referencia> </informacionreverso> </ws:reverso> </soapenv:body> </soapenv:envelope> Salida transacción <S:Envelope xmlns:s=" <S:Body> <ns2:reversoresponse xmlns:ns2=" <respuestareverso> <idtransaccion>2724</idtransaccion> <referencia>pruebatclady</referencia> 54

55 <idestado>1</idestado> <nombreestado>aprobada</nombreestado> <codigorespuesta>100</codigorespuesta> <codigoautorizacion>888888</codigoautorizacion> <valor>100.0</valor> <iva>0.0</iva> <basedevolucion>0.0</basedevolucion> <fechaprocesamiento> :17:32 AM</fechaProcesamiento> <mensaje>accept</mensaje> <antifrauderespuesta> <riesgo>90</riesgo> <mensaje>accept</mensaje> </antifrauderespuesta> </respuestareverso> </ns2:reversoresponse> </S:Body> </S:Envelope> ESTADOS DE LAS TRANSACCIONES Dentro de la plataforma ASPH se cuenta con un conjunto de estados los cuales permiten saber la situación actual de la transacción de tal forma que quien consuma el servicio pueda interpretar los mensajes generados por la herramienta. Los posibles estados pueden ser: Id Estado Nombre Estado Descripción 55

56 1 Aprobada 2 Rechazada 3 Declinada 4 En Validación 5 En Verificación 6 En proceso 7 En proceso Validado 8 En proceso de Reverso 9 Abortada 10 Reversada Estado que informa que la transacción fue exitosa. Estado que informa que la transacción no paso el módulo antifraude. Estado que informa que la transacción no paso en el banco emisor. Estado que informa que la transacción queda pendiente por revisión en el módulo antifraude. Estado que informa que la transacción queda pendiente por revisión en el momento del pago. Estado que informa que la transacción se encuentra procesando, aun no se sabe en qué estado va a finalizar. Estado que informa que la transacción se encuentra en proceso Validado. Estado que informa que la transacción se encuentra en proceso de Reverso. Estado que informa que la transacción ha sido cancelado o abortada. Estado que informa que la transacción ha sido reversada. MODELO DE INTEGRACIÓN DISPOSITIVOS DE HUELLAS DACTILARES (DiveceFingerprint) 56

57 Sistema de seguridad encargado de detectar las huellas dactilares del dedo por medio de sensores eléctricos, posteriormente genera una imagen digital la cuál es enviada a la computadora y almacenada en una base de datos en los que se le asocia con la información de una persona. FLUJO DEL PROCESO 1. El comprador ingresa a la página de pago y envía un identificador de sesión. 2. Con la Sessión ID que es entregada al cliente, es enviada a la Plataforma ASPH donde busca el valor DiveceFingerprint en el servidor Cloud. 3. Cuando llega los datos de Sessión ID al servidor Cloud envía una página de respuesta al comprador. SEGMENTO DE CÓDIGO PARA LA IMPLEMENTACIÓN DiveceFingerprint EN EL PAGO Y ENVÍO PÁGINA WEB A continuación se relaciona el script que debe ser implementado dentro de la página en donde se encuentra el botón de pagar (formulario de pagos).  57