INTER ATIONAL ALLIANCE TRAVEL ASSISTANCE & INSUR PROCESO DE INTEGRACIÓN BOTÓN DE PAGO

Transcripción

1 INTER N ATIONAL ALLIANCE TRAVEL ASSISTANCE & INSUR PROCESO DE INTEGRACIÓN BOTÓN DE PAGO

2 TABLA DE CONTENIDO SOLUCIÓN TECNOLÓGICA... 4 INFORMACIÓN TECNICA... 5 FLUJO DEL PROCESO... 6 COMO FUNCIONA?... 6 Transacción Aprobada:... 8 Transacción Rechazada:... 8 Transacción Declinada:... 9 Transacción Validación:... 9 Transacción Verificación:... 9 Transacción En Verificación Manual:... 9 Ejemplo de la estructura que debe componer el Array dentro del mensaje a enviar ENVÍO DE DATOS SOLICITUD PETICIÓN POST EJEMPLO CONSUMO SERVICIO CONSULTA Estructura de datos - UsernameToken Estructura de datos ConsultaPorReferencia Estructura de datos respuestatransaccionreferencia EJEMPLO ENTRADA Y SALIDA OPERACIÓN ConsultaPorReferencia RECOMENDACIONES... 22

3 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. La ventaja de utilizar nuestra plataforma: - Disminuye considerablemente los riesgos al realizar transacciones Online, llevando el servicio de control y monitoreo de las transacciones. - Permite realizar integraciones sencillas con carritos de compra o transacciones aéreas, en aplicaciones como Magento, PrestaShop, Joomla, entre otros. - Permite visualizar y administrar las ventas realizadas en todos los países del mundo desde un solo panel administrativo.

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

5 INFORMACIÓN TECNICA A continuación se describe 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: php URL: Tarjeta de Crédito para pruebas: Visa: American Express: MasterCard: AMBIENTE DE PRODUCCIÓN URL: Para obtener la información del ambiente de producción se bebe tener un proceso de contratación de la plataforma con la compañía.

6 FLUJO DEL PROCESO COMO FUNCIONA? El usuario ingresa a un sitio web a realizar el proceso de compra de un comercio, al momento de ingresar al formulario de pago, hace click en el botón nuestro sistema envía una solicitud POST al servidor web para validar la transacción. Una vez verificada la información se despliega el formulario de pago.

7 Formulario de pago Este formulario es personalizado según las necesidades del cliente (Color, Imagen corporativa, publicidad y datos de la transacción según lo requieran). Después de ser validada la transacción por nuestra plataforma ASPH es enviada la información del estado al cliente indicándole en qué estado está la transacción (Aprobada, Declinada, Rechazada).

8 Cuando la transacción genera un error el sistema le indica al usuario el tipo de error para que sea revisado y corregido e intentar realizar nuevamente el proceso de pago para terminar la transacción. Validación de errores en el formulario A continuación se detallan los estados de las transacciones: Id Estado Nombre Estado 1 Aprobada 2 Rechazada 3 Declinada 4 En Validación 5 En Verificación 8 En Verificación Manual Transacción Aprobada: Cuando la transacción es aprobada se envía un mensaje al cliente informando el estado de la transacción aprobada mediante un Array que corresponde a una respuesta silenciosa. El mensaje a mostrar al usuario depende del cliente. Transacción Rechazada:

9 Cuando la transacción queda en estado Rechazada por el módulo antifraude, el sistema envía un mensaje informando al cliente indicando que la transacción ha sido Rechazada por medio de una petición POST que corresponde a una respuesta silenciosa que realiza la plataforma y envía la respuesta a la página que realizo el llamado a la pantalla de registro de la transacción por medio del botón de pago. El mensaje a mostrar al usuario depende del cliente. Transacción Declinada: Cuando la transacción queda en estado Declinada, el sistema envía un mensaje informando al cliente que la transacción ha sido declinada por la entidad bancaria por medio de una petición POST que corresponde a una respuesta silenciosa que realiza la plataforma y envía la respuesta a la página que realizo el llamado a la pantalla de registro de la transacción por medio del botón de pago. El mensaje a mostrar al usuario depende del cliente. Transacción Validación: Cuando la transacción queda en estado Validación por el módulo antifraude, el sistema envía un mensaje informando al cliente que la transacción ha quedado en validación medio de una petición POST que corresponde a una respuesta silenciosa que realiza la plataforma y la envía la respuesta a la página que realizo el llamado a la pantalla de registro de la transacción por medio del botón de pago. Transacción Verificación: Cuando la transacción queda en estado Verificación por el módulo antifraude, el sistema envía un mensaje informando al cliente que la transacción ha quedado en verificación por medio una petición POST que corresponde a una respuesta silenciosa que realiza la plataforma y la envía la respuesta a la página que realizo el llamado a la pantalla de registro de la transacción por medio del botón de pago. Transacción En Verificación Manual: Cuando la transacción queda en estado Verificación Manual por el módulo antifraude, el sistema envía un mensaje informando al cliente que la transacción ha quedado en Verificación Manual por medio de una petición POST que corresponde a una respuesta silenciosa que realiza la plataforma y la envía la respuesta a la página que realizo el llamado a la pantalla de registro de la transacción por medio del botón de pago. Ejemplo de la estructura que debe componer la petición POST de respuesta.

10 Array ( [idtransaccion] => [idestado] => 1 [nombreestado] => Aprobada [referencia] => TEST_767 [codigorespuesta] => 1 [codigoautorizacion] => [riesgo] => [valor] => 1000 [iva] => 0 [basedevolucion] => 0 [fechaprocesamiento] => :02:23 AM [mensaje] => ) ENVÍO DE DATOS SOLICITUD PETICIÓN POST

11 La solicitud post se define como el envío de información requerida para el diligenciamiento del formulario a través del cual se realiza el pago. A continuación se detallan los campos que deben ser enviados dentro de la solicitud POST para acceder al formulario que contiene la información de pago. - Definición firma_cadena Cadena encapsulada en MD5 concatenada la cual seguridad del mensaje enviado. permite realizar la verificación de firma_cadena = apikeycomercio~publickey~codigoreferencia~valor~isomoneda - Definición Apikeycomercio Es el código utilizado para generar la firma digital, información que es entregada por IATAI. Estructura de datos Solicitud Petición Post Variable Tipo de dato Longitud Máximo Requerido publickey String 100 Si Descripción Identificador único de comercio. Información brindada por IATAI codigoreferencia String 100 Si Referencia única que identifica la transacción dentro del sistema. descripcion String 100 Si Descripción de producto valor Float 9 Si Valor de la compra. iva Float 9 Si Valor IVA de la compra. Si no se desea aplicar IVA se debe enviar cero (0) basedevolucioniva Float 9 Si isomoneda String 3 Si nombrecliente String 100 Si Base devolución IVA. Si no se desea aplicar la base devolución IVA se debe enviar cero (0) Identificador de la moneda en que se realizará el pago. Para Colombia se debe enviar (COP), para Estados Unidos enviar (USD) Nombre del cliente que realiza la compra

12 apellidocliente String 100 Si documentoidentificacion String 20 Si cliente String 100 Si telefono String 15 Si telefonooficina String 15 No paiscorrespondencia Formato ISO países 2 caracteres 2 Si estadoprovincia String 2 Si ciudadcorrespondencia String 100 Si direccioncorrespondencia String 250 Si codigopostalcorrespondencia String 9 Si paisenv Formato ISO países 2 caracteres 2 No ciudadenv String 250 No direccionenv String 250 No nombreenv String 100 No apellidoenv String 100 No Apellido del cliente que realiza la compra Documento de identificación de la persona que realiza la compra de la persona que realiza la compra Teléfono de la persona que realiza la compra Teléfono de la oficina de quien realiza la compra País de correspondencia del tarjetahabiente. 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 tarjetahabiente. Dirección de correspondencia del tarjetahabiente. Código postal para la dirección de envío. El Código postal debe constar de 5 a 9 dígitos. Si el país de envío es EE.UU., debe corresponder a 9 dígitos LNL NLN. País a donde se enviará la compra Ciudad a donde se enviará la compra Dirección a donde se enviará la compra Nombre de la persona que recibe el envío. Apellido de la persona que recibe el envío.

13 estadoprovinciaenv String 2 No codigopostalenv String 9 No Estado a donde se enviará la compra. Si el país es US tiene que ser 2 letras mayúsculas, en caso contrario no se tendrá en cuenta. Código postal de la ciudad a donde se enviará la compra. Código postal para la dirección de envío. El código postal debe constar de 5 a 9 dígitos. Si el país de envío es los EE.UU., debe corresponder a 9 dígitos LNL NLN. urlredirect String 100 SI URL para re direccionar urlsilenciosa String 100 SI URL para devolver respuesta por medio de mensaje POS. signaturepost String 100 SI Firma encriptada (md5) del Mensaje POS. productos Array[] - SI Array list de productos que se relacionan dentro de la compra. Detalle de la petición POST de productos

14 Esta estructura detalle los datos del producto a comprar, el código, nombre, valor, código categoría y nombre categoría en el proceso del envío de datos solicitud post. Variable Tipo de dato Tipo de dato Requerido Descripción codigoitem String 100 SI Código que identifica el producto nombreitem String 100 SI Nombre del producto valoritem Int 9 SI Valor del producto cantidaditem Int - SI Cantidad disponible del producto codigocategoria String 100 NO Código que identifica la categoría que va asociada al producto- si en este caso no es necesario favor enviar la notificación N/A nombrecategoria String 100 NO Nombre de la categoría que va asociada al producto, si en este caso no es necesario favor enviar la notificación N/A EJEMPLO

15 Para poder visualizar el ejemplo del ENVÍO DE DATOS SOLICITUD PETICIÓN POST, se debe copiar este código HTML e ingresar los datos requeridos. <form method="post" action="dirección Personalizada"> <input type="image" border="0" alt="" src="boton_pagar_pequeno.png" onclick="this.form.urlsend.value = window.location.href;"/> <input name="publickey" type="hidden" value="347gqwyu3axx"/> <input name="codigoreferencia" type="hidden" value=" "/> <input name="descripcion" type="hidden" value="test test"/> <input name="valor" type="hidden" value="10000"/> <input name="iva" type="hidden" value="16"/> <input name="basedevolucioniva" type="hidden" value="0"/> <input name="isomoneda" type="hidden" value="usd"/> <input name="nombrecliente" type="hidden" value="iatai"/> <input name="apellidocliente" type="hidden" value="iatai colombia"/> <input name="documentoidentificacion" type="hidden" value=" "/> <input name=" cliente" type="hidden" value="iatai@reject.com"/> <input name="telefono" type="hidden" value=" "/> <input name="telefonooficina" type="hidden" value=" "/> <input name="paiscorrespondencia" type="hidden" value="co"/> <input name="estadoprovincia" type="hidden" value="cun"/> <input name="ciudadcorrespondencia" type="hidden" value="bog"/> <input name="direccioncorrespondencia" type="hidden" value="calle 70 N 7-40"/> <input name="codigopostalcorrespondencia" type="hidden" value="10001"/> <input name="paisenv" type="hidden" value="co"/> <input name="ciudadenv" type="hidden" value="bog"/> <input name="direccionenv" type="hidden" value="calle 70 N 7-40"/> <input name="nombreenv" type="hidden" value="tecnología"/> <input name="apellidoenv" type="hidden" value="iatai"/> <input name="estadoprovinciaenv" type="hidden" value="cun"/> <input name="codigopostalenv" type="hidden" value="10001"/> <input type="hidden" name="productos[producto][codigoitem]" value="1"> <input type="hidden" name="productos[producto][nombreitem]" value="tiquete_1"> <input type="hidden" name="productos[producto][valoritem]" value="1000"> <input type="hidden" name="productos[producto][cantidaditem]" value="1"> <input type="hidden" name="productos[producto][codigocategoria]" value="12"> <input type="hidden" name="productos[producto][nombrecategoria]" value="categoria_1"> <input name="urlredirect" id="urlredirect" value="" type="hidden"/> <input name="urlsilenciosa" id="urlsilenciosa" value="" type="hidden"/> <input name="urlsend" id="urlsend" value="" type="hidden"/> <input name="signaturepost" value="d18480c65ded97a54e0831d233334f77" type="hidden"/> </form>

16 Cuando la transacción terminar el proceso de verificación de los datos recibidos, Se envía una URL Silenciosa que corresponde a la URL del cliente, para que puedan ser verificados los estados de la transacción. Los estados que pueden validar depende del acuerdo que se llegue con el cliente, ya sea (Aprobada, Declinada y Rechazada). Esta URL es re direccionada, Ejemplo: dominio.com/resp?codigoreferencia del Cliente. De esta manera pondrán validar la información de la transacción.

17 CONSUMO SERVICIO CONSULTA La plataforma ASPH de IATAI permite realizar la consulta del estado de transacciones mediante el consume del web service. las 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 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.

18 Después de realizar el envío de la información mediante el formulario POST en la cual fue ejecutado el pago, se podrá realizar la consulta que corresponde a la Operación ConsultaPorReferencia, permite realizar la consulta con el número de la referencia de la compra que genera la transacción. 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 - UsernameToken El elemento UsernameToken describe el método por el cual un consumidor de un servicio Web puede proporcionar un elemento UsernameToken como medio para identificar al solicitante mediante un nombre de usuario y opcionalmente, una contraseña o una clave secreta. Nombre Parámetro Tipo de Dato Longitud Máximo Estructura de datos ConsultaPorReferencia Requerido Username String 100 SI Password Sting 100 SI Descripción Nombre que corresponde la cuenta asociada al servicio Gateway Clave de acceso del servicio que es asignada a la cuenta

19 La estructura ConsultaPorReferencia, permite ingresar el código de referencia que identifica la compra de uno o varios productos. Nombre Parámetro Tipo de Dato Longitud Máximo Requerido Referencia String 100 SI Descripción Código de Referencia que identifica la compra de uno o varios productos. Estructura de datos respuestatransaccionreferencia La estructura respuestatransaccionreferencia, se puede tener como respuesta el proceso de la transacción del método ConsultaPorReferencia. Nombre Parámetro Tipo de Dato Requerido Descripción idtransaccion INT N/A Número que identifica la transacción idestado INT N/A Código del estado de la transacción nombreestado STRING N/A Nombre del estado en que se encuentra la transacción referencia STRING N/A Código de Referencia que identifica la compra de uno o varios productos. codigorespuesta INT N/A Código de respuesta que genera la transacción codigoautorizacion INT N/A Código de Autorización que genera la transacción Valor INT N/A El valor que corresponde a la compra Iva DECIMAL N/A Valor del impuesto de la compra basedevolucion DECIMAL N/A Porcentaje que calcula el valor del iva generado en la compra en caso de tener devolución fechaprocesamiento DATE N/A Fecha que fue generada la transacción mensaje STRING N/A Mensaje informativo donde indica si fue Aceptada o Rechazada la transacción EJEMPLO ENTRADA Y SALIDA OPERACIÓN ConsultaPorReferencia

20 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. 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 ACEPTADA <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> <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>

21 <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> <idestado>3</idestado> <nombreestado>declinada</nombreestado> <referencia>xasddssasxg5cdhdfdfdzdfjfd</referencia> <codigorespuesta>100</codigorespuesta> <codigoautorizacion/> <riesgo/> <valor>0.0</valor> <iva>0.0</iva> <basedevolucion>0.0</basedevolucion> <fechaprocesamiento> :16:52 AM</fechaProcesamiento> <mensaje>accept</mensaje>

22 </respuestatransaccionreferencia> </ns2:consultarporreferenciaresponse> </S:Body> </S:Envelope> VALIDACION <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>9999</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> RECOMENDACIONES La plataforma ASPH es un servicio de integración que permite realizar pagos en internet con tarjetas de crédito nacional e internacional de forma segura y confiable, para utilizar nuestra plataforma se recomienda: Tener cuenta bancaria local o tener la empresa registrada en los países donde se quiere recibir los pagos locales. También es necesario realizar convenios de recaudo con los Bancos locales en cada país en donde va a procesar sus pagos.

23 Agradecemos que si existen dudas frente a la implementación o procedimiento general se pongan en contacto directo con el Ingeniero José Joaquín Gamboa correo electrónico: tech@iatai.com.