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)
<th>
FORMATO
</th>
<th>
RESTRICCIONES
</th>
<th>
DESCRIPCION
</th>
</tr>
<td>
Alfanumérico
</td>
<td>
Admite letras y/o números\ <span style="color:red">(Obligatorio)</span>
</td>
<td>
Valores de las Cabecera utilizadas para acceder a los servicios de OpenLinea
</td>
</tr>
<tr>
<td>
OpKey2
</td>
<td>
Alfanumérico
</td>
<td>
Admite letras y/o números <span style="color:red">(Obligatorio)</span>
</td>
<td>
Valores de las Cabecera utilizadas para acceder a los servicios de OpenLinea
</td>
</tr>
<tr>
<td>
comercioId
</td>
<td>
Numérico
</td>
<td>
Admite números sin espacios. <span style="color:red">(Obligatorio)</span>
</td>
<td>
Identificador del Comercio en OPENLINEA. Es un valor asignado.
</td>
</tr>
<tr>
<td>
contraseña
</td>
<td>
Alfanumérico
</td>
<td>
Admite letras y/o números sin espacios. No mayor a 12 caracteres. <span style="color:red">(Obligatorio)</span>
</td>
<td>
Clave de Acceso a la Terminal Virtual, configurado para su aplicación.
</td>
</tr>
<tr>
<td>
version3D
</td>
<td>
Numérico
</td>
<td>
Admite números sin espacios.<span style="color:red">(Obligatorio)</span>
</td>
<td>
Versión de 3D Secure con la cual desea procesar la Transacción. Posibles valores:\
2
</td>
</tr>
<tr>
<td>
operacion
</td>
<td>
Alfanumérico
</td>
<td>
Admite los valores de VENTA y PREAUTORIZACION <span style="color:red">(Obligatorio)</span>
</td>
<td>
Operativa a realizar durante la Transaccion enviada.
</td>
</tr>
<tr>
<td>
modo
</td>
<td>
Carácter
</td>
<td>
Admite una solo letra <span style="color:red">(Obligatorio)</span>
</td>
<td>
Identificador del Modo de operación, P=Producción, A=Prueba con Respuesta Aprobada, R=Prueba con Respuesta Rechazada
</td>
</tr>
<tr>
<td>
monto
</td>
<td>
Numérico
</td>
<td>
Admite números un punto y dos decimales sin espacios, no se permite comas o signos de pesos. <span style="color:red">(Obligatorio)</span>
</td>
<td>
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.
</td>
</tr>
<tr>
<td>
transaccionId
</td>
<td>
Alfanumérico
</td>
<td>
Admite letras y/o números sin espacios. No mayor a 20 caracteres. <span style="color:red">(Obligatorio)</span>
</td>
<td>
Número de Pedido o identificador UNICO de la orden o pedido de su aplicación
</td>
</tr>
<tr>
<td>
referencia
</td>
<td>
Alfanumérico
</td>
<td>
Admite letras y/o números sin espacios. No mayor a 20 caracteres. <span style="color:blue">(Opcional)</span>
</td>
<td>
Referencia libre de uso para su aplicación\
Dato indispensable si posteriormente desea realizar Busqueda de Transacciones mediante Referencia
</td>
</tr>
<tr>
<td>
token
</td>
<td>
Numérico
</td>
<td>
Admite letras y/o números sin espacio, se permite el uso de guiones (-). <span style="color:red">(Obligatorio)</span>
</td>
<td>
TOKEN mediante el cual se identifica de forma única a la TARJETA\
Consulte tokenizacion a traves de [SOAP](https://bloomin.readme.io/reference/token-tarjeta-1) o [API REST](https://bloomin.readme.io/reference/tarjetas-1)
</td>
</tr>
<tr>
<td>
detalles
</td>
<td>
Alfanumérico
</td>
<td>
Admite letras y/o números, se permite el uso de caracteres especiales <span style="color:blue">(Opcional)</span>
</td>
<td>
Parametro para uso exclusivo de la plataforma que realiza la solicitud de cargo
</td>
</tr>
<tr>
<td>
urlRetorno
</td>
<td>
Alfanumérico
</td>
<td>
Admite Números y Puntos <span style="color:red">(Obligatorio)</span>
</td>
<td>
URL a la que habra de redirigirse el flujo de la operacion una vez finalizada la ejecucion de la transacion.
</td>
</tr>
<tr>
<td>
diferimiento
</td>
<td>
Numérico
</td>
<td>
Admite solo números con 2 dígitos <span style="color:blue">(Opcional)</span>
</td>
<td>
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)
</td>
</tr>
<tr>
<td>
numeroPagos
</td>
<td>
Numérico
</td>
<td>
Admite solo números con 2 dígitos <span style="color:blue">(Opcional)</span>
</td>
<td>
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)
</td>
</tr>
<tr>
<td>
plan
</td>
<td>
Numérico
</td>
<td>
Admite solo números con 2 dígitos <span style="color:blue">(Opcional)</span>
</td>
<td>
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
</td>
</tr>
| VARIABLE |
|---|
| OpKey1 |
Variables de Retorno
La petición regresara una respuesta mediante un POST a la URL de Retorno proporcionada en su solicitud:
<th>
FORMATO
</th>
<th>
RESTRICCIONES
</th>
<th>
DESCRIPCION
</th>
</tr>
<td>
Numérico
</td>
<td>
Números sin espacios
</td>
<td>
Identificador del Comercio en OPENLINEA. Es un valor asignado.
</td>
</tr>
<tr>
<td>
token
</td>
<td>
Alfanumérico
</td>
<td>
Letras y/o números sin espacios. No mayor a 20 caracteres
</td>
<td>
Identificador Único TOKEN de la TARJETA sobre el cual se realizó la operación.
</td>
</tr>
<tr>
<td>
tarjeta
</td>
<td>
Numérico
</td>
<td>
16 dígitos sin espacios.
</td>
<td>
Número de la Tarjeta de Crédito o Débito.
</td>
</tr>
<tr>
<td>
tipo
</td>
<td>
Alfanumérico de 3 a 30 caracteres
</td>
<td>
16 dígitos sin espacios.
</td>
<td>
Tipo de Tarjeta, Crédito/Débito.
</td>
</tr>
<tr>
<td>
marca
</td>
<td>
Alfanumérico
</td>
<td>
Alfanumérico de 2 a 10 caracteres.
</td>
<td>
Marca que respalda la Tarjeta de Crédito o Débito.
</td>
</tr>
<tr>
<td>
emisor
</td>
<td>
Alfanumérico de 3 a 30 caracteres
</td>
<td>
16 dígitos sin espacios.
</td>
<td>
Banco Emisor de la Tarjeta de Crédito o Débito.
</td>
</tr>
<tr>
<td>
transaccionID
</td>
<td>
Alfanumérico
</td>
<td>
Letras y/o números sin espacios. No mayor a 20 caracteres.
</td>
<td>
Número de Pedido o identificador de la orden o pedido en la Tienda Virtual o Sistema de Ventas del comercio.
</td>
</tr>
<tr>
<td>
fechaTransaccion
</td>
<td>
Alfanumérico
</td>
<td>
Representación de fecha con formato MM/DD/AA
</td>
<td>
Fecha procesamiento de la Operación
</td>
</tr>
<tr>
<td>
horaTransaccion
</td>
<td>
Alfanumérico
</td>
<td>
Representación de hora con formato HH:MM:SS
</td>
<td>
Hora de procesamiento de la Operación.
</td>
</tr>
<tr>
<td>
monto
</td>
<td>
Numérico
</td>
<td>
Admite números, un punto y dos decimales sin espacios, no se permite comas o signos de pesos.
</td>
<td>
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.
</td>
</tr>
<tr>
<td>
codigoRespuesta
</td>
<td>
Numérico
</td>
<td>
Números sin espacios.
</td>
<td>
Se regresa los siguientes valores:\
0 = Aprobada,\
1 = Rechazada
</td>
</tr>
<tr>
<td>
procReturnMsg
</td>
<td>
Alfanumérico
</td>
<td>
Alfanumérico de 1 a 10 caracteres
</td>
<td>
Código retornado por el procesador de la tarjeta.
</td>
</tr>
<tr>
<td>
ccErrCode
</td>
<td>
Numérico
</td>
<td>
Numérico de longitud variable. No mayor a 4 caracteres.
</td>
<td>
Código devuelto por la Institución Financiera
</td>
</tr>
<tr>
<td>
ccReturnMsg
</td>
<td>
Alfanumérico
</td>
<td>
Alfanumérico de longitud variable
</td>
<td>
Texto específico retornado por el procesador de pagos
</td>
</tr>
<tr>
<td>
codigoAprobacion
</td>
<td>
Alfanumérico
</td>
<td>
Alfanumérico de longitud variable
</td>
<td>
Código de Aprobación Bancaria, típicamente con 6 Dígitos
</td>
</tr>
<tr>
<td>
afiliacion
</td>
<td>
Alfanumérico
</td>
<td>
Alfanumérico de longitud variable.
</td>
<td>
Numero de afiliación con la que es ejecutada la Operación.
</td>
</tr>
<tr>
<td>
detalles
</td>
<td>
Alfanumérico
</td>
<td>
Admite letras y/o números, se permite el uso de caracteres especiales
</td>
<td>
Parámetro para uso exclusivo de la plataforma que realiza la solicitud de cargo
</td>
</tr>
| VARIABLE |
|---|
| comercioId |