Realice compras seguras en Internet y autentifique al comprador como legitimo titular de la Tarjeta
El comercio enviará una solicitud de Cargo haciendo uso del esquema de Verificación 3D Secure, para ello enviara un POST a alguna de las siguientes URL's considerando las Credenciales propias de cada Ambiente:
Ambiente de Desarrollo
http://terminalvirtual-test.azurewebsites.net/Token3D/Request3D
Ambiente de Producción
Al ser recibidas las variables en el Gateway de OpenLinea, se redireccionará hacia el Banco Emisor y este desplegará la ventana 3D Secure para proporcionar la clave o contraseña asociada a la Tarjeta de Crédito/Debito registrada. La aplicación de 3D Secure retornará al Gateway de Openlinea el resultado de la autenticación con lo cual se determinará si la operación puede ser procesada por el motor de pagos.
A continuación, podrás encontrar las variables que se requieren para el uso de 3D secure 2.0
Variables de Envío
El resultado de la transacción será enviado a la App o sitio web del comercio mediante un POST a la URL de retorno previamente especificada (Ver variables de respuesta)
| VARIABLE | FORMATO | RESTRICCIONES | DESCRIPCION |
|---|---|---|---|
| OpKey1 | Alfanumérico | Admite letras y/o números (Obligatorio) | Valores de las Cabecera utilizadas para acceder a los servicios de OpenLinea |
| OpKey2 | Alfanumérico | Admite letras y/o números (Obligatorio) | Valores de las Cabecera utilizadas para acceder a los servicios de OpenLinea |
| comercioId | Numérico | Admite números sin espacios. (Obligatorio) | Identificador del Comercio en OPENLINEA. Es un valor asignado. |
| contraseña | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 12 caracteres. (Obligatorio) | Clave de Acceso a la Terminal Virtual, configurado para su aplicación. |
| version3D | Numérico | Admite números sin espacios.(Obligatorio) | Versión de 3D Secure con la cual desea procesar la Transacción. Posibles valores: 2 |
| operacion | Alfanumérico | Admite los valores de VENTA y PREAUTORIZACION (Obligatorio) | Operativa a realizar durante la Transacción enviada. |
| modo | Carácter | Admite una solo letra (Obligatorio) | Identificador del Modo de operación, P=Producción, A=Prueba con Respuesta Aprobada, R=Prueba con Respuesta Rechazada |
| monto | Numérico | Admite números un punto y dos decimales sin espacios, no se permite comas o signos de pesos. (Obligatorio) | Monto a procesar total de la orden o pedido calculado en su aplicación en base a la selección de los servicios y/o productos del cliente. |
| transaccionId | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 20 caracteres. (Obligatorio) | Número de Pedido o identificador UNICO de la orden o pedido de su aplicación |
| referencia | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 20 caracteres. (Opcional) | Referencia libre de uso para su aplicación Dato indispensable si posteriormente desea realizar Busqueda de Transacciones mediante Referencia |
| token | Numérico | Admite letras y/o números sin espacio, se permite el uso de guiones (-). (Obligatorio) | TOKEN mediante el cual se identifica de forma única a la TARJETA Consulte tokenizacion a traves de SOAP o API REST |
| detalles | Alfanumérico | Admite letras y/o números, se permite el uso de caracteres especiales (Opcional) | Parametro para uso exclusivo de la plataforma que realiza la solicitud de cargo |
| urlRetorno | Alfanumérico | Admite Números y Puntos (Obligatorio) | URL a la que habra de redirigirse el flujo de la operacion una vez finalizada la ejecucion de la transacion. |
| diferimiento | Numérico | Admite solo números con 2 dígitos (Opcional) | Para compras de promoción, el número de meses que se concederá al cliente para empezar a pagar (compre hoy pague después). Es un número de dos dígitos justificado con ceros a la izquierda. Ejemplo: 03 (pague dentro de 3 meses) |
| numeroPagos | Numérico | Admite solo números con 2 dígitos (Opcional) | Para compras de promoción, el plazo en que se diluye el pago del cliente (compras a meses con o sin intereses). Es un número de dos dígitos justificado con ceros a la izquierda. Ejemplo: 06 (pague en seis mensualidades) |
| plan | Numérico | Admite solo números con 2 dígitos (Opcional) | Para compras de promoción, indica si ésta se hace con intereses o no al cliente. Valores posibles: 03 = Sin intereses 05 = Con intereses 07 = Sólo diferimiento inicial |
Variables de Retorno
La petición regresara una respuesta mediante un POST a la URL de Retorno proporcionada en su solicitud:
| VARIABLE | FORMATO | RESTRICCIONES | DESCRIPCION |
|---|---|---|---|
| comercioId | Numérico | Números sin espacios | Identificador del Comercio en OPENLINEA. Es un valor asignado. |
| contrasena | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 12 caracteres. | Clave de Acceso a la Terminal Virtual, configurado para su aplicación. |
| modo | Alfanumérico | Admite una solo letra | Identificador del Modo de operación, P=Producción, A=Prueba con Respuesta Aprobada, R=Prueba con Respuesta Rechazada |
| transaccionID | Alfanumérico | Letras y/o números sin espacios. No mayor a 20 caracteres. | Número de Pedido o identificador de la orden o pedido en la Tienda Virtual o Sistema de Ventas del comercio. |
| fechaTransaccion | Alfanumérico | Representación de fecha con formato MM/DD/AA | Fecha procesamiento de la Operación |
| horaTransaccion | Alfanumérico | Representación de hora con formato HH:MM:SS | Hora de procesamiento de la Operación. |
| token | Alfanumérico | Letras y/o números sin espacios. No mayor a 20 caracteres | Identificador Único TOKEN de la TARJETA sobre el cual se realizó la operación. |
| tarjeta | Numérico | 16 dígitos sin espacios. | Número de la Tarjeta de Crédito o Débito. |
| tipo | Alfanumérico | Alfanumérico de 3 a 30 caracteres | Tipo de Tarjeta, Crédito/Débito. |
| marca | Alfanumérico | Alfanumérico de 2 a 10 caracteres. | Marca que respalda la Tarjeta de Crédito o Débito. |
| emisor | Alfanumérico | Alfanumérico de 3 a 30 caracteres | Banco Emisor de la Tarjeta de Crédito o Débito. |
| monto | Numérico | Admite números, un punto y dos decimales sin espacios, no se permite comas o signos de pesos. | Monto a procesar total de la orden o pedido calculado en su aplicación en base a la selección de los servicios y/o productos del cliente. |
| detalles | Alfanumérico | Admite letras y/o números, se permite el uso de caracteres especiales | Parámetro para uso exclusivo de la plataforma que realiza la solicitud de cargo |
| afiliacion | Alfanumérico | Alfanumérico de longitud variable. | Numero de afiliación con la que es ejecutada la Operación. |
| codigoRespuesta | Numérico | Números sin espacios. | Se regresa los siguientes valores: 0 = Aprobada, 1 = Rechazada |
| procReturnMsg | Alfanumérico | Alfanumérico de 1 a 10 caracteres | Código retornado por el procesador de la tarjeta. |
| ccErrCode | Numérico | Numérico de longitud variable. No mayor a 4 caracteres. | Código devuelto por la Institución Financiera |
| ccReturnMsg | Alfanumérico | Alfanumérico de longitud variable | Texto específico retornado por el procesador de pagos |
| codigoAprobacion | Alfanumérico | Alfanumérico de longitud variable | Código de Aprobación Bancaria, típicamente con 6 Dígitos |
| referenciaTransaccionBancaria | Alfanumérico | Alfanumérico de longitud variable | identificador único que sirve para rastrear una transacción bancaria específica. |
| CAVV | Alfanumérico | Alfanumérico de longitud variable | valor generado durante el proceso de autenticación del tarjetahabiente en una transacción 3D Secure. |
| ECI | Numérico | Números sin espacios. | código que indica el nivel de seguridad aplicado a una transacción en línea con tarjeta de crédito. |
| Cardtype | Alfanumérico | Alfanumérico de longitud variable | tipo de tarjeta que se está utilizando en una transacción de pago. |
| status | Numérico | Números sin espacios. | Estatus de la transacción 3D secure |
| Reference3D | Alfanumérico | Alfanumérico de longitud variable | Referencia de la transacción hacia 3D secure |