INFORMACIÓN TÉCNICA SOBRE COMERCIO ELECTRÓNICO SEGURO VISA- FORMULARIO

Transcripción

1 INFORMACIÓN TÉCNICA SOBRE COMERCIO ELECTRÓNICO SEGURO VISA- FORMULARIO Página 1 de 17

2 INDICE 1. DEFINICIONES INTEGRACIÓN (MODO FORMULARIO) REQUERIMIENTOS PARA EL FLUJO DE PAGO ETAPA 1: REGISTRO DEL PEDIDO Y GENERACIÓN DE E-TICKET ETAPA 2: NAVEGACIÓN ETAPA 3: CONSULTA DEL RESULTADO DE LA TRANSACCIÓN ANEXOS CÓDIGOS DE ACCIÓN CÓDIGOS ECI CÓDIGOS DE ACCIÓN AUTORIZACIÓN Página 2 de 17

3 1. Definiciones Para efectos del presente documento se consideran los siguientes términos: PSP: Proveedor de Servicios de Pago (PSP- Payment Service Providers). Empresas con relación contractual con VisaNet que ofrecen servicios de pago a comercios patrocinados. Tarjeta no autenticada: Cuando una tarjeta no es validada por la entidad Entidad Emisora: Entidad encargada de emitir tarjetas de pago Visa a los tarjetahabientes con los que mantiene una relación contractual o comercial. 2. Integración (Modo ) El comercio debe cumplir con los siguientes requerimientos para integrarse al de Pagos Requerimientos para el flujo de Pago El proceso de pagos consta de 3 etapas: Registro del pedido y generación de e-ticket. Navegación para completar la información de pago del tarjetahabiente ( de Pago). Consulta del resultado de la transacción. La primera y la última etapa se realizan a través de la invocación a Web Services (WS), mientras que la segunda se realiza re-direccionando la navegación mediante HTTPS POST Etapa 1: Registro del pedido y generación de e-ticket Para el registro del pedido, se invocará un Web Service publicado por VisaNet. A. XML de generación de e-ticket. Los parámetros a enviar, obligatoriamente, son los siguientes: CANAL 1 Canal a través del cual se está realizando la compra. Siempre tendrá el valor 3 (Web) PRODUCTO 1 Producto VisaNet a través del cual se está realizando la compra. Siempre tendrá el valor 1 (Comercio electrónico de pagos) CODTIENDA 9 Es el identificador del Comercio. Este campo se compone de 9 caracteres. NUMORDEN 9 Número de orden o pedido. Este número es generado por el comercio, debe ser numérico y único para cada transacción. MOUNT Es el monto que se cargará en la transacción. Formato: #####.## El símbolo decimal es el punto y siempre debe incluir dos valores decimales. Página 3 de 17

4 A continuación se muestran los parámetros que podrán ser enviados por el comercio obteniéndolos de su base de datos 1. NOMBRE 200 Nombre del titular de la tarjeta APELLIDO 200 Primer apellido del titular de la tarjeta Correo electrónico del titular de la tarjeta DIRECCIÓN 200 Dirección en el estado de cuenta de la tarjeta. CIUDAD 100 Ciudad del estado de cuenta de la tarjeta. Los comercios afiliados bajo la modalidad de PSP deberán enviar los siguientes parámetros: CODASOCIADO 9 Código del comercio asociado que es asignado por el PSP. NOMBREASOCIADO 17 Nombre del comercio asociado. MCC 4 MCC del comercio asociado. Adicionalmente, el comercio podrá enviar datos adicionales en el siguiente campo: DATO_COMERCIO 100 Datos opcionales que el comercio puede enviar. Estos se incluirán, sin modificaciones, en el XML de respuesta. Estos campos se enviarán como parámetros al Web Service contenidos en una cadena XML con el siguiente formato: <?xml version="1.0" encoding="utf-8"?> <nuevo_eticket> <parametros> < parametro id="canal">3</parametro> <parametro id="producto">1</parametro> <parametro id="codtienda">string</parametro> <parametro id="numorden">string</parametro> <parametro id="mount"> String </parametro> <parametro id="nombre"> String </parametro> 1 Se debe tener en consideración que si el comercio envía estos campos, obteniéndolos de su base de datos, el tarjetahabiente no podrá modificarlos en el formulario de pagos. No obstante, se agilizará el proceso compra ya que se reducirá la cantidad de campos a ser completados por el tarjetahabiente. Página 4 de 17

5 <parametro id="apellido"> String </parametro> <parametro id="correo"> String </parametro> <parametro id="direccion"> String </parametro> <parametro id="ciudad"> String </parametro> <parametro id="codasociado"> String </parametro> <parametro id="nombreasociado"> String </parametro> <parametro id="mcc"> String </parametro> </parametros> </nuevo_eticket> <parametro id="dato_comercio">string</parametro> B. XML de generación de e-ticket. El Web Service retornará un XML de respuesta, en el que estará incluido el valor de e-ticket generado. El XML de respuesta tendrá el siguiente formato: <?xml version="1.0" encoding="utf-8"?> <eticket> <registro> <campo id= CODTIENDA >String</campo> <campo id= NUMORDEN >String</campo> <campo id= ETICKET >String</campo> </registro> </eticket> </mensajes/> Dentro de la trama se identifican los siguientes nodos y sub-nodos: 1. Registro: Agrupa los campos del e-ticket generado. 2. Campo: Que indicará los valores enviados como parámetros de respuesta. Puede tener los siguientes ID s: CODTIENDA 9 Identificador del Comercio. Este campo se compone de 9 caracteres. NUMORDEN 9 Número de orden o pedido. Este número es generado por el comercio, debe ser numérico y único para cada transacción. ETICKET 30 Es el valor de e-ticket generado. Página 5 de 17

6 MENSAJE Descripción si hubo algún error en la información enviada al WS Etapa 2: Navegación Con el valor de e-ticket obtenido (ver punto 2.1.1), se deberá re-direccionar la navegación del tarjetahabiente al formulario de pagos de VisaNet. La página de invocación del comercio debe permitir la interacción a través de HTTPS POST. Cada comercio debe invocar el de VisaNet enviando el siguiente parámetro para iniciar el flujo de pago: ETICKET 30 Número de e-ticket generado. Una vez que se envíe este valor al formulario de pagos, este mostrará el número de Orden y el monto asociados al e-ticket, para que el cliente ingrese los datos de su tarjeta. El parámetro debe ir como atributo tipo hidden (Ej. Input type=hidden) El URL al cual debe de enviarse este parámetro es: El comercio podrá incluir el formulario en un iframe. Sin embargo, éste debe tener obligatoriamente barras de desplazamiento (scroll bars) para poder adaptarse al tamaño del formulario de pagos en caso este último sufra modificaciones. El formulario de pagos para tarjetas nacionales 2 se presenta en la figura 4. 2 Los campos marcados con asterisco (*) son obligatorios. Página 6 de 17

7 Figura 4: para ingreso de tarjetas nacionales Para el caso de tarjetas foráneas se agregan los siguientes campos al formulario: Dirección consignada en el estado de cuenta de la tarjeta. Ciudad consignada en el estado de cuenta de la tarjeta. País consignado en el estado de cuenta de la tarjeta. Código postal de la dirección consignada en el estado de cuenta de la tarjeta. El formulario de pagos para tarjetas foráneas 3 (emitidas en el extranjero) se muestra en la figura 5. 3 Los campos marcados con asterisco (*) son obligatorios. Página 7 de 17

8 Figura 5: para ingreso de tarjetas foráneas La pasarela de pagos (POS Multimerchant) mostrará al usuario una pantalla informando que la transacción está siendo procesada, la pantalla será la siguiente: Página 8 de 17

9 Figura 6: Mensaje de información cuando la transacción está siendo procesada Terminado el procesamiento de la transacción la pasarela de pagos invocará a una página de respuesta del comercio enviando el siguiente parámetro: ETICKET 30 Valor del e-ticket de la transacción de pago procesada. El parámetro es retornado a través de HTTP POST y sólo indica el fin del proceso de la transacción. No indica el resultado de la misma (aprobación, denegación, etc.). Para conocer el resultado del proceso de pagos, el comercio deberá realizar la consulta de resultado del pedido (Etapa 3: Consulta del resultado de la transacción). Página 9 de 17

10 Etapa 3: Consulta del resultado de la transacción Para conocer el resultado de la operación, el comercio deberá invocar a un Web Service publicado por VisaNet, con lo cual podrá obtener los parámetros que indican el resultado del proceso de pago. En la consulta, el comercio deberá invocar al Web Service enviando una cadena XML con el siguiente formato: <?xml version="1.0" encoding="utf-8"?> <consulta_eticket> </consulta_eticket> <parametros> <parametro id="codtienda">string</parametro> <parametro id="eticket">string</parametro> </parametros> Dentro de la trama se identifican los siguientes nodos: 1. Parámetros: Agrupa a los parámetros enviados para la consulta. 2. Parámetro: Detalla los parámetros de consulta. Puede tener los siguientes ID s: CODTIENDA 9 Código que se le asignó al comercio al afiliarse a comercio electrónico. ETICKET 30 Valor de e-ticket que se generó al inicio de la transacción. Es único por transacción. El Web Service responderá un XML que contiene el resultado de todas las operaciones asociadas a este e-ticket. El formato del XML de respuesta es el siguiente: <?xml version="1.0" encoding="utf-8"?> <respuesta_eticket> <pedido id=" " eticket=" "> <operacion id="1"> <campo id="respuesta">string</campo> <campo id="estado">string</campo> <campo id="cod_tienda">string</campo> <campo id="nordent">string</campo> <campo id="cod_accion">string</campo> <campo id="pan">string</campo> <campo id="nombre_th">string</campo> <campo id="ori_tarjeta">string</campo> <campo id="nom_emisor">string</campo> <campo id="eci">string</campo> <campo id="dsc_eci">string</campo> <campo id="cod_autoriza">string</campo> Página 10 de 17

11 <campo id="cod_rescvv2">string</campo> <campo id="id_unico">string</campo> <campo id="imp_autorizado">string</campo> <campo id="fechayhora_tx">string</campo> <campo id="fechayhora_deposito"/> <campo id="fechayhora_devolucion"/> <campo id="dato_comercio">string</campo> <campo id="dsc_cod_accion">string</campo> <campo id="nrocuotas">string</campo> <campo id="impcuotaaprox">string</campo> </operacion> </pedido> <mensajes/> </respuesta_eticket> Dentro de la trama se identifican los siguientes nodos y sub-nodos: 1. Pedido: Agrupa los datos del pedido y sus operaciones 4. Tiene como valor de ID el número de pedido y como valor el e-ticket (el mismo que se envió en el XML de consulta) 2. Operación: Se tendrá un nodo operacion para cada operación que se haya realizado con este número de pedido. La operación tendrá un ID, que es un correlativo asignado por la pasarela de pagos. Se debe tener en cuenta que, como cada número pedido debe ser único, todas las operaciones posteriores a la primera, serán denegadas con código de acción 300 (Número de pedido duplicado). La operación tiene una serie de sub-nodos que están contenidos bajo el mismo tag campo : a. Campo: Indicará los valores enviados como parámetros de respuesta. Puede tener los siguientes ID s: RESPUESTA 1 Tiene los siguientes valores: 1: Autorizada. 2: Denegada. CODTIENDA 9 Código de la tienda NUMORDEN 9 Número de orden de la tienda. CODACCION 3 Código de denegación y aprobación. El Código de aprobación: PAN 19 Número de tarjetavisa. Está enmascarado, solamente muestra los 6 primeros dígitos y los 4 últimos: ******1001 NOMBRE_TH 100 Nombre y Apellido ingresado por el tarjetahabiente en el formulario de pago. ECI 2 Electronic Commerce Indicator COD_AUTORIZA Código de autorización 4 El pedido puede contener más de una operación, esto se presenta cuando se envía un número de pedido existente. Dentro de un pedido sólo existirá a lo más una operación autorizada. Página 11 de 17

12 ORI_TARJETA 1 Indica origen de tarjeta: N (Tarjeta Nacional) I (Tarjeta Internacional) NOM_EMISOR Nombre del banco emisor de la tarjeta. Solamente en caso que la tarjeta sea nacional. DSC_ECI Descripción del campo ECI RES_CVV2 Resultado de la validación del CVV2 IMP_AUTORIZADO 10 Importe autorizado. ID_UNICO 15 Identificador único de la transacción. DSC_COD_ACCION 100 Descripción del código de acción, permite identificar el motivo de rechazo de una operación. FECHAYHORA_TX 19 Fecha y hora de la transacción. Formato: DD/MM/YYYY hh:mm:ss NROCUOTA 2 Numero de cuotas IMPCUOTAAPROX MENSAJE Importe aproximado del valor de cuota, retornado por el emisor. Información sobre las validaciones de formato que realiza el WS de Autorización. (Ejemplo. Error de formato en el monto enviado). 3. Mensajes: Agrupa los mensajes que se puedan generar cuando se consulta un e-ticket. 4. Mensaje: Este nodo permitirá la inclusión de mensajes hacia el comercio, por algún tipo de error que se haya generado. Cada mensaje tendrá un ID único y siempre se debe revisar si se ha enviado algún mensaje. Se debe tener en consideración que estos parámetros son los que se envían a la fecha de redacción de este documento. Siendo tramas XML, se puede incrementar el número de parámetros de respuesta, de acuerdo a las mejoras que se vayan implementando en la pasarela de pagos, las cuales se informarán oportunamente. Buscar actualizaciones en: En la sección de mensajes, se notificarán errores que se pueden haber producido durante el procesamiento o la invocación al Web Service. Los posibles mensajes son: Validaciones de XML Mensaje Respuesta al comercio El comercio ejecuta el Web El IP xxx.xxx.xx.x no está autorizado XML de respuesta Service desde un numero IP no configurado para el comercio yyyyyy El comercio envía formato XML no tiene el formato correcto XML de respuesta incorrecto del XML El comercio No envía el "CODTIENDA" como campo del XML El comercio No envía el "ETICKET" como campo del XML Campo CODTIENDA no encontrado en el XML Campo ETICKET no encontrado en el XML XML de respuesta XML de respuesta Página 12 de 17

13 Validaciones de Negocio Mensaje Respuesta al comercio Si falla el al intentar obtener los parámetros de respuesta del pedido. Si el campo CODTIENDA no se encuentra registrado en la base de datos Si el número de ETICKET no se encuentra registrado en la base de datos Error de comunicación CODTIENDA no se encuentra registrado ETICKET no se encuentra registrado XML de respuesta XML de respuesta XML de respuesta Nota. El Web Service estará disponible para que sea invocado por el comercio no sólo al terminar el proceso de pago, sino también cuando lo considere necesario, como por ejemplo, para validar una transacción sin respuesta por time out. El comercio debe validar por lo menos los siguientes parámetros antes de dar una compra como aprobada y atender el pedido: respuesta: Deberá tener el valor 1. imp_autorizado: Deberá ser el monto del pedido que se está atendiendo. A. Respuesta final al tarjetahabiente. Una vez obtenido el resultado del proceso de pago, el comercio deberá mostrar la pantalla final de respuesta al cliente. La pantalla final de compra debe mostrar la siguiente información: Logo de la empresa Nombre de la Tienda Teléfono Dirección Comercial Dominio Número de pedido Número de Tarjeta enmascarada : Ej: 4444 XXXX XXXX 3333 Fecha y hora del pedido Importe de la transacción Moneda Descripción del producto Nombre del Comprador Descripción del código de acción Políticas de devolución (o el link a las mismas) Términos y Condiciones (o el link a la página) Incluir un texto indicando al cliente que debe imprimir y guardar el recibo de transacción. En algunos casos por un tema de reclamos, VisaNet solicitará al establecimiento el envío de una copia de esta pantalla final de compra en un plazo no mayor a 48 horas. Página 13 de 17

14 3. Anexos 3.1. Códigos de Acción Códigos ECI Códigos retornados en el proceso de autenticación. Sus valores significan: ECI Descripción de apoyo para el comercio 5 Transacción autenticada 6 Comercio intentó autenticación pero tarjetahabiente no está participando 7 Transacción no autenticada pero enviada en canal seguro 10 Entidad emisora no disponible para autenticación 11 Clave secreta del tarjetahabiente incorrecta 12 Tarjeta Vencida Códigos de Acción Autorización Códigos retornados desde el proceso de autorización. Sus valores significan: Código de Descripción de apoyo para el comercio Descripción a mostrar al cliente acción 101 Operación Denegada. Tarjeta Vencida. Operación Denegada. Tarjeta Vencida. Verifique los datos en su tarjeta e ingréselos correctamente. 102 la entidad 104 Operación Denegada. Operación no permitida para esta tarjeta. 106 Operación Denegada. Exceso de intentos de ingreso de clave secreta. Operación Denegada. Operación no permitida para esta tarjeta. Contactar con la Operación Denegada. Intentos de clave secreta excedidos. Contactar con la 107 la entidad la 108 Operación Denegada. Exceso de actividad. la 109 Operación Denegada. Identificación inválida de establecimiento. el 110 Operación Denegada. Operación no Operación Denegada. Operación no permitida para esta tarjeta. permitida para esta tarjeta. Contactar 111 Operación Denegada. El monto de la transacción supera el valor máximo permitido para operaciones virtuales 112 Operación Denegada. Se requiere clave con la el Operación Denegada. Se requiere clave secreta. secreta. 116 Operación Denegada. Fondos insuficientes. Operación Denegada. Fondos insuficientes. Contactar con entidad emisora de su tarjeta 117 Operación Denegada. Clave secreta Operación Denegada. Clave secreta incorrecta. incorrecta. 118 Operación Denegada. Tarjeta inválida. Operación Denegada. Tarjeta Inválida. Contactar con entidad emisora de su tarjeta. 119 Operación Denegada. Exceso de intentos de ingreso de clave secreta. Operación Denegada. Intentos de clave secreta excedidos. Contactar con Página 14 de 17

15 121 Operación Denegada. Operación Denegada. 126 Operación Denegada. Clave secreta Operación Denegada. Clave secreta inválida. inválida. 129 Operación Denegada. Tarjeta no operativa. Operación Denegada. Código de seguridad invalido. Contactar con entidad emisora de su tarjeta 180 Operación Denegada. Tarjeta inválida. Operación Denegada. Tarjeta Inválida. Contactar con entidad emisora de su tarjeta. 181 Operación Denegada. Tarjeta con restricciones de Débito. Operación Denegada. Tarjeta con restricciones de débito. Contactar con 182 Operación Denegada. Tarjeta con Operación Denegada. Tarjeta con restricciones de Crédito. restricciones de crédito. Contactar con 183 Operación Denegada. Error de sistema. Operación Denegada. Problemas de comunicación. Intente más tarde. 190 entidad 191 entidad 192 entidad 199 Operación Denegada. Operación Denegada. 201 Operación Denegada. Tarjeta vencida. Operación Denegada. Tarjeta vencida. Contactar con entidad emisora de su tarjeta. 202 entidad 204 Operación Denegada. Operación no permitida para esta tarjeta. 206 Operación Denegada. Exceso de intentos de ingreso de clave secreta. entidad emisora de su tarjeta Operación Denegada. Operación no permitida para esta tarjeta. Contactar con Operación Denegada. Intentos de clave secreta excedidos. Contactar con la 207 entidad. 208 Operación Denegada. Tarjeta perdida. 209 Operación Denegada. Tarjeta robada. entidad emisora de su tarjeta 263 Operación Denegada. Error en el envío de parámetros. 264 Operación Denegada. Entidad emisora no está disponible para realizar la autenticación. 265 Operación Denegada. Clave secreta del tarjetahabiente incorrecta. el Operación Denegada. Entidad emisora de la tarjeta no está disponible para realizar la autenticación. Operación Denegada. Clave secreta del tarjetahabiente incorrecta. Contactar con entidad emisora de su tarjeta. 266 Operación Denegada. Tarjeta vencida. Operación Denegada. Tarjeta Vencida. Contactar con entidad emisora de su tarjeta. 280 Operación Denegada. Clave errónea. Operación Denegada. Clave secreta errónea. Contactar con entidad emisora de su tarjeta. 290 entidad 300 Operación Denegada. Número de pedido del comercio duplicado. Favor no atender. Operación Denegada. Número de pedido del comercio duplicado. Favor Página 15 de 17

16 no atender. 306 entidad 401 Operación Denegada. Tienda inhabilitada. el 402 Operación Denegada. Operación Denegada. 403 Operación Denegada. Tarjeta no Operación Denegada. Tarjeta no autenticada 404 Operación Denegada. El monto de la transacción supera el valor máximo permitido. 405 Operación Denegada. La tarjeta ha superado la cantidad máxima de transacciones en el día. 406 Operación Denegada. La tienda ha superado la cantidad máxima de transacciones en el día. autenticada. el el el 407 Operación Denegada. El monto de la transacción no llega al mínimo permitido. el 408 Operación Denegada. CVV2 no coincide. Operación Denegada. Código de seguridad no coincide. Contactar con entidad emisora de su tarjeta 409 Operación Denegada. CVV2 no procesado por entidad 410 Operación Denegada. CVV2 no procesado por no ingresado. 411 Operación Denegada. CVV2 no procesado por entidad 412 Operación Denegada. CVV2 no reconocido por entidad Operación Denegada. Código de seguridad no procesado por la entidad emisora de la tarjeta Operación Denegada. Código de seguridad no ingresado. Operación Denegada. Código de seguridad no procesado por la entidad emisora de la tarjeta Operación Denegada. Código de seguridad no reconocido por la entidad emisora de la tarjeta 413 entidad 414 Operación Denegada. Operación Denegada. 415 Operación Denegada. Operación Denegada. 416 Operación Denegada. Operación Denegada. 417 Operación Denegada. Operación Denegada. 418 Operación Denegada. Operación Denegada. 419 Operación Denegada. Operación Denegada. 420 Operación Denegada. Tarjeta no es VISA. Operación Denegada. Tarjeta no es VISA. 421 entidad 422 Operación Denegada. El comercio no está configurado para usar este medio de pago. Operación Denegada. El comercio no está configurado para usar este medio de pago. Contactar con el 423 Operación Denegada. Se canceló el Operación Denegada. Se canceló el proceso de pago. proceso de pago. 424 entidad Operación Denegada. 666 Operación Denegada. Problemas de Operación Denegada. Problemas de comunicación. Intente más tarde. comunicación. Intente más tarde. 667 Operación Denegada. Transacción sin Operación Denegada. Transacción sin autenticación. Inicio del Proceso de Pago respuesta de Verified by Visa. 668 Operación Denegada. el 669 Operación Denegada. Módulo antifraude. el 670 Operación Denegada. Módulo antifraude. el Página 16 de 17

17 904 Operación Denegada. Formato de mensaje Operación Denegada. erróneo. 909 Operación Denegada. Error de sistema. Operación Denegada. Problemas de comunicación. Intente más tarde. 910 Operación Denegada. Error de sistema. Operación Denegada. 912 Operación Denegada. Entidad emisora no disponible. Operación Denegada. Entidad emisora de la tarjeta no disponible 913 Operación Denegada. Transmisión Operación Denegada. duplicada. 916 entidad Operación Denegada. 928 entidad Operación Denegada. 940 Operación Denegada. Transacción anulada previamente. Operación Denegada. 941 Operación Denegada. Transacción ya Operación Denegada. anulada previamente. 942 Operación Denegada. Operación Denegada. 943 Operación Denegada. Datos originales Operación Denegada. distintos. 945 Operación Denegada. Referencia repetida. Operación Denegada. 946 Operación Denegada. Operación de Operación Denegada. Operación de anulación en proceso. anulación en proceso. 947 Operación Denegada. Comunicación Operación Denegada. Problemas de duplicada. comunicación. Intente más tarde. 948 entidad Operación Denegada. 949 entidad Operación Denegada. 965 entidad Operación Denegada. Página 17 de 17