Tokeniza la información de Tarjeta
Este método le permite almacenar los datos de una TARJETA para que el cliente la pueda utilizar en diversas ocasiones sin necesidad de volver a introducir los datos. Para guardar los datos de una TARJETA, deberá enviar las siguientes variables mediante un mensaje SOAP al webservice previamente indicado, invocando el método tokenTarjeta el cual le permitirá almacenar la información.
Variables de Envío
| VARIABLE | FORMATO | RESTRICCIONES | DESCRIPCION |
|---|---|---|---|
| comercioId | Numérico | Admite números sin espacios. | 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. | Clave de Acceso a la Terminal Virtual, configurado para su aplicación. |
| operacion | Carácter | Admite una solo letra | Identificador de la operación a realizar: A = Almacena una Nueva Tarjeta U = Actualiza los datos de una Tarjeta D = Elimina una Tarjeta En el caso de Actualización de Datos (U), los unicos campos que pueden ser actualizados son: digitos que corresponde al CVV de la Tarjeta mes que corresponde al Mes de Expiración de la Tarjeta anio que corresponde al Año de Expiración de la Tarjeta |
| token | Alfanumérico | Admite letras y/o números sin espacio, se permite el uso de guiones (-). | TOKEN mediante el cual se identifica de forma única a la TARJETA, este dato es requerido en el caso de operaciones de Actualización y/o Eliminación de Tarjeta. (En caso de asignación de nueva tarjeta se envía la variable en blanco) |
| tarjeta | Numérico | Admite solo 16 números sin espacios para Visa, Mastercard y AMEX | Número de la Tarjeta de Crédito o Débito |
| mes | Numérico | Admite solo números con 2 dígitos | Mes de Vencimiento de la Tarjeta de Crédito o Débito |
| anio | Numérico | Admite solo números con 4 dígitos | Año de Vencimiento de la Tarjeta de Crédito o Débito |
| dígitos | Numérico | Admite solo números con 3 dígitos | Dígitos Verificadores de la Tarjeta de Crédito |
| titular | Alfanumérico | Admite solo Letras, Espacios y Puntos | Nombre completo del Titular tal cual aparece en la Tarjeta de Crédito Dato indispensable si posteriormente desea realizar Busqueda de Transacciones mediante el Nombre del Titular |
| marca | Alfanumérico | Admite letras. No mayor a 4 caracteres. | La Marca de la Tarjeta que se esta almacenando. Posibles valores: VISA = Visa MC = MasterCard AMEX = American Express Dato indispensable para el esquema 3D Secure 2.0 |
| tipo | Alfanumérico | Admite letras. Solo debe contener 2 caracteres. | El Tipo de Tarjeta que se está enviando. Posibles valores: CR = Tarjeta de Crédito DB = Tarjeta de Débito Dato indispensable para el esquema 3D Secure 2.0 |
| calle | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 20 caracteres. | Dirección del Tarjetahabiente (se sugiere Calle y Numero) |
| colonia | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 20 caracteres. | Colonia del Tarjetahabiente |
| ciudad | Alfanumérico | Admite letras sin espacios. No mayor a 20 caracteres. | Ciudad del Tarjetahabiente |
| estado | Alfanumérico | Admite letras sin espacios. No mayor a 20 caracteres. | Estado del Tarjetahabiente |
| estadoid | Alfanumérico | Admite letras. Solo debe contener 2 caracteres. | Estado del Tarjetahabiente Ejemplo: Nuevo León = NL Anexo 2 - Código de Estados para México |
| pais | Alfanumérico | Admite letras sin espacios. No mayor a 20 caracteres. | País del Tarjetahabiente |
| paisid | Alfanumérico | Admite letras. Solo debe contener 2 caracteres. | Pais del Tarjetahabiente Anexo 1 - Código de Paises |
| codigoPostal | Numérico | Admite números sin espacios | Código postal del tarjetahabiente |
| Alfanumérico | Admite letras y/o números sin espacios, se permiten los símbolos de arroba (@), punto (.) y guiones (-), (_). No mayor a 20 caracteres. | Dirección de Correo Electrónico para el envío de Notificaciones. Dato indispensable si posteriormente desea realizar Búsqueda de Transacciones mediante el correo registrado | |
| telefono | Numérico | Admite letras y/o números, se permiten los símbolos de paréntesis, corchetes y guiones. | Número Telefónico |
| tokenCliente | Alfanumérico | Admite letras y/o números sin espacios. No mayor a 20 caracteres. (Opcional) | Token mediante el cual se identifica de forma única al Cliente, este dato es requerido en el caso de querer asociar la Tarjeta al Catálogo de Tarjetas de un Cliente. |
Variables de Retorno
La petición regresara una respuesta en formato SOAP conteniendo la siguiente información:
| VARIABLE | FORMATO | RESTRICCIONES | DESCRIPCION |
|---|---|---|---|
| comercioId | Numérico | Números sin espacios | Identificador del Comercio en OPENLINEA. Es un valor asignado. |
| 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. |
| 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. |
| codigoRespuesta | Numérico | Números sin espacios. | Se regresa los siguientes valores: 0 = Aprobada , 1= Rechazada, 2 = Pendiente |
| ccErrorCode | 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 |
| procReturnMsg | Alfanumérico | Alfanumérico de 1 a 10 caracteres | caracteres Código retornado por el procesador de la tarjeta. |
Formato de envío
tokenTarjeta Desarrollo
https://servertest.operacionesenlinea.com/gateway/opGateway.asmx?op=tokenTarjeta
tokenTarjeta Produccion
https://servidorseguro.operacionesenlinea.com/gateway/OpGateway.asmx?op=tokenTarjeta