INTEGRACIÓN WEB SERVICE MÓDULO DE PAGO

(1)

INTEGRACIÓN WEB SERVICE

MÓDULO DE PAGO

(2)

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

Estructura de datos – TarjetaHabiente ... 10

Estructura de datos – TarjetaCredito ... 11

Estructura de datos – Envio ... 12

Estructura de datos – InformacionFraude ... 13

Estructura de datos – Productos ... 13

Estructura de datos - SuscripcionTransaccion ... 14

Estructura de datos - suscribir ... 14

Estructura de datos - SuscripcionUsuario ... 14

Estructura de datos mensaje de salida operación Transaccion ... 15

Estructura de datos - respuestaTransaccion ... 15

Estructura de datos - antifraudeRespuesta ... 16

EJEMPLO ENTRADA Y SALIDA OPERACIÓN transaccion ... 18

OPERACIÓN ConsultaPorReferencia ... 24

Estructura de datos mensaje de entrada operación ConsultaPorReferencia ... 25

Estructura de datos – ConsultaPorReferencia ... 25

Estructura de datos mensaje de salida operación ConsultaPorReferencia ... 26

Estructura de datos – respuestaTransaccionReferencia ... 26

EJEMPLO ENTRADA Y SALIDA OPERACIÓN ConsultaPorReferencia ... 27

OPERACIÓN ConsultarTransaccion ... 30

Estructura de datos mensaje de entrada operación ConsultaTransaccion ... 31

Estructura de datos – ConsultarTransaccion ... 31

Estructura de datos mensaje de salida operación ConsultarTransaccion... 31

Estructura de datos – respuestaConsultarTransaccion ... 31

Estructura de datos – antifraudeRespuesta ... 32

EJEMPLO ENTRADA Y SALIDA OPERACIÓN ConsultarTransaccion ... 32

OPERACIÓN ObtenerFranquicia ... 34

Estructura de datos mensaje de entrada operación ObtenerFranquicia ... 34

Estructura de datos mensaje de salida operación ObtenerFranquicia ... 34

Estructura de datos obtenerFranquiciasResponse ... 34

Estructura de datos respuestaFranquicias ... 34

EJEMPLO ENTRADA Y SALIDA OPERACIÓN ObtenerFranquicia ... 35

(3)

OPERACIÓN TransaccionAereo ... 37

Estructura de datos mensaje de entrada operación TransaccionAereo ... 38

Estructura de datos – transacciónAereo ... 38

Estructura de datos - Compra ... 39

Estructura de datos - Cliente ... 40

Estructura de datos – TarjetaHabiente ... 40

Estructura de datos – TarjetaCredito ... 41

Estructura de datos – Envio ... 42

Estructura de datos – InformacionFraude ... 43

Estructura de datos – Aereo ... 43

Estructura de datos - Pasajero ... 44

Estructura de datos - Ruta ... 44

Estructura de datos - Aeropuerto ... 45

Estructura de datos mensaje de salida operación TransaccionAereo ... 45

Estructura de datos - respuestaTransaccionAereo ... 45

Estructura de datos - dispersionesRespuesta ... 46

EJEMPLO ENTRADA Y SALIDA OPERACIÓN transaccionAereo ... 46

ESTADOS DE LAS TRANSACCIONES ... 55

OPERACIÓN reverso ... 51

Estructura de datos mensaje de entrada operación reverso ... 52

Estructura de datos – informacionReverso ... 52

Estructura de datos mensaje de salida operación reverso ... 53

Estructura de datos – reversoResponse ... 53

EJEMPLO ENTRADA Y SALIDA OPERACIÓN reverso ... 54

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

TABLA DE ERRORES ... 59

RECOMENDACIONES ... 63

(4)

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.

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

(6)

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: http://pruebas.allegraplatform.com/GatewayIatai/IPPG?wsdl username Token:

-Username: Iatai -Password: Iatai

Tarjeta de Crédito para pruebas:

Visa: 4111111111111111

American Express: 378282246310005 MasterCard: 5555555555554444

AMBIENTE DE PRODUCCIÓN

Lenguaje de desarrollo: Java Tecnología: JAX-WS

Versión de SOAP: SOAP 1.2

Wsdl: https://secure.allegraplatform.com/GatewayIatai/IPPG?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.

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

(8)

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 Descripción

Compra Compra NA Si

Estructura que contiene la información de la compra

Cliente Cliente NA SI

Estructura que contiene la información de la persona quien realiza a compra.

TarjetaHabiente TarjetaHabiente NA SI

Estructura que contiene la información del titular de la tarjeta de crédito

TarjetaCredito TarjetaCredito NA SI

Estructura que contiene la información de la tarjeta de crédito con la que se realizará la compra.

Envio Envio NA SI

Estructura que contiene la información del destino a donde se enviará el producto a comprar.

InformacionFraude InformacionFraude NA SI

Estructura que contiene la información que debe enviarse al módulo antifraude.

(9)

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.

productos Lista<producto> NA SI

Estructura que contiene la información del

producto o los productos a comprar

SuscripcionTransaccion SuscripcionTransaccion NA NO

Estructura que contiene la respuesta del proceso de suscripción de la tarjeta de crédito

referencia Sting 100 SI Número que identifica la

compra

descripcion String 100 No 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 Base de la devolución de la

compra

isoMoneda String 3 SI

Nombre de la moneda que corresponde al país que fue ejecutada la compra. COP para pesos Colombianos y USD para dólares

numeroCuotas Int 2 SI

Numero de cuotas a diferir el valor de la compra. Puede estar entre 1 y 36

(10)

10

Estructura de datos - Cliente

Estructura que contiene la información de la persona quien realiza a compra.

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

Nombre String 100 SI Nombre del titular de la tarjeta

de crédito

Apellido String 100 SI Apellido del Titular de la tarjeta

de crédito

Documento String 20 No Documento de identificación del

titular de la tarjeta de crédito emailCliente String 100 SI Email de la persona titular de la

tarjeta de crédito Nombre

Parámetro Tipo de Dato Longitud

Nombre String 100 SI

Nombre del propietario o de la persona que compró el producto

Apellido String 100 SI

Apellido del propietario o de la persona que compró el producto

documento String

20 SI

Número de identificación del propietario o de la persona que compró el producto

email String 100 SI

E-mail del dueño o de la persona que compró el producto.

telefono String 15 SI

Teléfono Residencia del propietario o de la persona que compró el producto.

telefonoOficina String 15 NO

Teléfono de oficina del propietario o de la persona que compró el producto.

(11)

Teléfono String 15 SI Teléfono de la persona titular de la tarjeta de crédito

País String 2 SI

País de correspondencia del titular de la tarjeta de crédito.

Formato ISO países 2 caracteres

estadoProvincia String 2 SI

Si el país es US tiene que ser 2 letras mayúsculas, en caso

contrario no se tendrá en cuenta.

Ciudad String 250 SI Ciudad de correspondencia del

titular de la tarjeta de crédito.

Dirección String 250 SI Dirección de correspondencia del

titular de la tarjeta de crédito

codigoPostal String 10 SI

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.

Idfranquicia Int 1 SI

Identificador de la franquicia, ver operación

obtenerFranquicias

numeroTarjeta String 16 SI Número de la tarjeta de

crédito

mesVencimiento String 2 SI Mes de vencimiento de la

tarjeta de crédito

anoVencimiento String 4 SI Año de vencimiento de la

tarjeta de crédito

codigoSeguridad Int 4 SI

Son los 3 o 4 últimos números que tiene al

respaldo la tarjeta de crédito

tipoCuenta String 1 SI

Corresponde: Puede ser Crédito ‘C’, Ahorros (A) o Corriente (R).

(12)

12

Estructura de datos – Envio

Estructura que contiene la información del destino a donde se enviará el producto a comprar.

pais String 2 SI País de correspondencia a

donde se enviara el producto.

ciudad String 250 SI Ciudad a donde se enviara el

producto.

direccion String 250 SI Dirección de domicilio a donde

se enviara el producto.

nombre String 100 SI Nombre de la persona que

recibe el producto

apellido String 100 SI Apellido de la persona que

recibe el producto

estadoProvincia String 2 SI

Si el país es Estados Unidos o Canadá debe enviarse:

Formato ISO de dos caracteres para estados.

codigoPostal String 10 SI

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

metodo String 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

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

Longitud

ipComprador String 20 SI IP de donde es enviada la

transacción.

hostComprador String 100 NO

El nombre del dominio de donde es enviando la transacción.

Cookie String 100 SI Identificador de sesión

userAgent String 100 SI Nombre del navegador

deviceFingerPrint String 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.

codigoItem Int 100 SI Código que identifica el

producto

nombreItem String 100 SI Nombre del producto

valorItem Float 9 SI Valor del producto

cantidadItem Int - SI

Cantidad disponible del producto debe ser mayor a 0

codigoCategoria Int 100 SI

Código que identifica la categoría que va asociada al producto

nombreCategoria String 100 SI

Nombre de la categoría que va asociada al producto

(14)

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

Longitud

Suscribir Boolean - SI

Bandera donde indica si se desea 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 String 100 SI Nombre de la persona que

va a suscribir

Apellido String 100 SI Apellido de la persona que

va a suscribir

cedula String 20 SI Cedula de la persona que

va a suscribir

email String 100 SI Correo electrónico de la

persona que va a suscribir

teléfono String 15 SI Número de Teléfono de la

celular String 15 NO Número de celular de la

(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 String Número que identifica la transacción

idEstado Int Código del Estado

nombreEstado String Nombre del estado que fue generada la transacción

referencia String Código de Referencia que identifica la compra de uno o varios productos codigoRespuesta String Código de Respuesta que genera la

transacción codigoAutorizacion String

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 String Mensaje que muestra la aceptación o el

rechazo de la transacción

antifraudeRespuesta antifraudeRespuesta Estructura que contiene la respuesta del módulo antifraude para la transacción suscripcionTarjetaCreditoR

espuesta

suscripcionTarjetaCredit oRespuesta

Estructura que contiene la respuesta del proceso de suscripción de la tarjeta de crédito

(16)

16

Estructura de datos - antifraudeRespuesta

Estructura que contiene la respuesta del módulo antifraude para la transacción.

riesgo Int

Es la escala de 0 a 100 que devuelve el modulo antifraude que indica el riesgo de la tracción

mensaje String 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.

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 String 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ó.

(17)

Estructura de datos – suscripcionRespuesta Objeto que contiene la información de la suscripción.

idUsuarioSubscripcion Int Código que identifica de la

suscripción

suscripcionID String 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.

idFranquicia Int

Identificador de la franquicia, ver operación

obtenerFranquicias

nombreFranquicia String 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ó.

nombreTarjetaHabiente String Nombre del titular de la tarjeta de crédito

apellidoTarjetaHabiente String Apellido del titular de la tarjeta de crédito

(18)

18

emailTarjetaHabiente String Email del titular de la tarjeta de crédito

telefonoTarjetaHabiente String Teléfono del titular de la tarjeta de crédito

documentoTarjetaHabiente String Documento de identificación del titular de la tarjeta de crédito paisCorrespondencia String País residencia del titular de la

tarjeta de crédito

estadoProvincia String

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.

ciudadCorrespondencia int Nombre del titular de la tarjeta

de crédito

direccionCorrespondencia String Dirección del titular de la tarjeta de crédito

codigoPostal String

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="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:ws="http://ws.iatai.com/">

<soapenv:Header>

<wsse:Security soapenv:mustUnderstand="1" xmlns:wsse="http://docs.oasis-

open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns="http://docs.oasis- open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">

<wsse:UsernameToken>

<wsse:Username>iatai</wsse:Username>

<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss- username-token-profile-1.0#PasswordText">iatai</wsse:Password>

</wsse:UsernameToken>

</wsse:Security>

</soapenv:Header>

<soapenv:Body>

<ws:transaccion>

(19)

<referencia>Test transación 1</referencia>

<descripcion>prueba</descripcion>

</Compra>

<apellido>Ocampo</apellido>

<email>[email protected]</email>

<apellido>Ocampo</apellido>

<direccion>calle 60</direccion>

</TarjetaHabiente>

</TarjetaCredito>

<Envio>

<direccion>calle 89</direccion>

<nombre>sonia</nombre>

<apellido>castro</apellido>

(20)

20 <estadoProvincia>1</estadoProvincia>

<metodo>fasfadsfasdfas</metodo>

</Envio>

<hostComprador>localhost</hostComprador>

<cookie>jm9l2lf11pv6qr63jpaampeln3</cookie>

<userAgent>Mozilla/5.0 (Windows NT 6.1; WOW64; rv:22.0) Gecko/20100101 Firefox/22.0</userAgent>

<deviceFingerPrint>jm9l2lf11pv6qr63jpaampeln3</deviceFingerPrint>

</InformacionFraude>

<nombreItem>zapatos</nombreItem>

</producto>

</productos>

<apellido>ocampo</apellido>

</SuscripcionUsuario>

</SuscripcionTransaccion>

</informacionTransaccion>

</ws:transaccion>

</soapenv:Body>

</soapenv:Envelope>

Salida transacción

(21)

Aprobada

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">

<S:Body>

<ns2:transaccionResponse xmlns:ns2="http://ws.iatai.com/">

<nombreEstado>Aprobada</nombreEstado>

<mensaje>ACCEPT</mensaje>

</antifraudeRespuesta>

</suscripcionTarjetaRespuesta>

<apellidoTarjetaHabiente>OCAMPO</apellidoTarjetaHabiente>

<emailTarjetaHabiente>[email protected]</emailTarjetaHabiente>

<direccionCorrespondencia>calle 60</direccionCorrespondencia>

(22)

22 <codigoPostal>N/A</codigoPostal>

</suscripcionTitularRespuesta>

</suscripcionRespuesta>

</suscripcionTarjetaCreditoRespuesta>

</respuestaTransaccion>

</ns2:transaccionResponse>

</S:Body>

</S:Envelope>

Rechazada

<S:Body>

<nombreEstado>Rechazada</nombreEstado>

<mensaje>REJECT</mensaje>

</S:Body>

</S:Envelope>

Declinada

<S:Body>

(23)

<nombreEstado>Declinada</nombreEstado>

</S:Body>

</S:Envelope>

Validación

<S:Body>

<nombreEstado>Validación</nombreEstado>

<mensaje>REJECT</mensaje></antifraudeRespuesta></respuestaTransaccion>

</ns2:transaccionResponse></S:Body>

(24)

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.

(25)

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

(26)

26

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.

idTransaccion String Número que identifica la transacción

idEstado INT Código del estado de la transacción

nombreEstado String Nombre del estado en que se

encuentra la transacción

referencia String

Código de Referencia que identifica la compra de uno o varios

productos.

codigoRespuesta String Código de respuesta que genera la

transacción

codigoAutorizacion String 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 String Mensaje adicional

Nombre

Parámetro Tipo de Dato Longitud

Referencia String 19 SI Código de Referencia que identifica la

compra de uno o varios productos.

(27)

EJEMPLO ENTRADA Y SALIDA OPERACIÓN ConsultaPorReferencia

Entrada

<soapenv:Header>

</wsse:Security>

</soapenv:Header>

<soapenv:Body>

<ws:consultarPorReferencia>

</ws:consultarPorReferencia>

</soapenv:Body>

</soapenv:Envelope>

Salida ConsultaPorReferencia APROBADA

<S:Body>

<ns2:consultarPorReferenciaResponse xmlns:ns2="http://ws.iatai.com/">

<respuestaTransaccionReferenciaxsi:type="ns2:tarjetaCreditoRespuesta"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

(28)

28 <referencia>WT100721832133345</referencia>

</respuestaTransaccionReferencia>

</ns2:consultarPorReferenciaResponse>

</S:Body>

</S:Envelope>

RECHAZADA

<S:Body>

<respuestaTransaccionReferencia xsi:type="ns2:tarjetaCreditoRespuesta"

<nombreEstado>Rechazada</nombreEstado>

</S:Body></S:Envelope>

DECLINADA

<S:Body>

(29)

<nombreEstado>Declinada</nombreEstado>

<referencia>xasddssasxg5cdhdfdfdzdfjfd</referencia>

</S:Body>

</S:Envelope>

VALIDACIÓN

<S:Body>

<nombreEstado>En Validación</nombreEstado>

<mensaje>-48:Ha ocurrido un error en el servidor</mensaje>

</S:Body></S:Envelope>

(30)

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.

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

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

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.

idTransaccion String Número único que identifica la transacción referencia String Código de Referencia que identifica la compra

de uno o varios productos

idEstado Int Código del estado de la transacción

nombreEstado String Nombre del estado en que se encuentra la transacción

codigoRespuesta String Código de respuesta que genera la transacción

Nombre Parámetro

Tipo de Dato

Longitud

idTransaccion String 100 SI Código de único que identifica la transacción.

Referencia String 100 SI Código de Referencia que identifica la compra de uno o varios productos.

(32)

32

codigoAutorizacion String 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.

riesgo int Puntaje de riesgo que tuvo la transacción en

el módulo antifraude.

mensaje String Mensaje informativo donde indica si fue

Aceptada o Rechazada la transacción

EJEMPLO ENTRADA Y SALIDA OPERACIÓN ConsultarTransaccion

ENTRADA

<soapenv:Header>

(33)

</wsse:Security>

</soapenv:Header>

<soapenv:Body>

<ws:consultarTransaccion>

<referencia>Test transación nueva prueba</referencia>

</informacionConsulta>

</ws:consultarTransaccion>

</soapenv:Body>

</soapenv:Envelope>

Salida ConsultarTransaccion

APROBADA

<S:Body>

<ns2:consultarTransaccionResponse xmlns:ns2="http://ws.iatai.com/">

<referencia>Test transación nueva prueba</referencia>

</respuestaConsultarTransaccion>

</ns2:consultarTransaccionResponse>

</S:Body>

</S:Envelope>

INTEGRACIÓN WEB SERVICE MÓDULO DE PAGO