Token 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

  <th style={{ textAlign: "left" }}>
    FORMATO
  </th>

  <th style={{ textAlign: "left" }}>
    RESTRICCIONES
  </th>

  <th style={{ textAlign: "left" }}>
    DESCRIPCION
  </th>
</tr>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite números sin espacios.
  </td>

  <td style={{ textAlign: "left" }}>
    Identificador del Comercio en OPENLINEA. Es un valor asignado.
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    contraseña
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras y/o números sin espacios. No mayor a 12 caracteres.
  </td>

  <td style={{ textAlign: "left" }}>
    Clave de Acceso a la Terminal Virtual, configurado para su aplicación.
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    operacion
  </td>

  <td style={{ textAlign: "left" }}>
    Carácter
  </td>

  <td style={{ textAlign: "left" }}>
    Admite una solo letra
  </td>

  <td style={{ textAlign: "left" }}>
    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
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    token
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras y/o números sin espacio, se permite el uso de guiones (-).
  </td>

  <td style={{ textAlign: "left" }}>
    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)
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    tarjeta
  </td>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite solo 16 números sin espacios para Visa, Mastercard y AMEX
  </td>

  <td style={{ textAlign: "left" }}>
    Número de la Tarjeta de Crédito o Débito
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    mes
  </td>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite solo números con 2 dígitos
  </td>

  <td style={{ textAlign: "left" }}>
    Mes de Vencimiento de la Tarjeta de Crédito o Débito
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    anio
  </td>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite solo números con 4 dígitos
  </td>

  <td style={{ textAlign: "left" }}>
    Año de Vencimiento de la Tarjeta de Crédito o Débito
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    dígitos
  </td>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite solo números con 3 dígitos
  </td>

  <td style={{ textAlign: "left" }}>
    Dígitos Verificadores de la Tarjeta de Crédito
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    titular
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite solo Letras, Espacios y Puntos
  </td>

  <td style={{ textAlign: "left" }}>
    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
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    marca
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras. No mayor a 4 caracteres.
  </td>

  <td style={{ textAlign: "left" }}>
    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
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    tipo
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras. Solo debe contener 2 caracteres.
  </td>

  <td style={{ textAlign: "left" }}>
    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
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    calle
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras y/o números sin espacios. No mayor a 20 caracteres.
  </td>

  <td style={{ textAlign: "left" }}>
    Dirección del Tarjetahabiente (se sugiere Calle y Numero)
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    colonia
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras y/o números sin espacios. No mayor a 20 caracteres.
  </td>

  <td style={{ textAlign: "left" }}>
    Colonia del Tarjetahabiente
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    ciudad
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras sin espacios. No mayor a 20 caracteres.
  </td>

  <td style={{ textAlign: "left" }}>
    Ciudad del Tarjetahabiente
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    estado
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras sin espacios. No mayor a 20 caracteres.
  </td>

  <td style={{ textAlign: "left" }}>
    Estado del Tarjetahabiente
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    estadoid
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras. Solo debe contener 2 caracteres.
  </td>

  <td style={{ textAlign: "left" }}>
    Estado del Tarjetahabiente\
    Ejemplo: Nuevo León = NL\
    [Anexo 2 - Código de Estados para México](https://bloomin.readme.io/reference/codigo-de-estados)
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    pais
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras sin espacios. No mayor a 20 caracteres.
  </td>

  <td style={{ textAlign: "left" }}>
    País del Tarjetahabiente
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    paisid
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras. Solo debe contener 2 caracteres.
  </td>

  <td style={{ textAlign: "left" }}>
    Pais del Tarjetahabiente\
    [Anexo 1 - Código de Paises](https://bloomin.readme.io/reference/codigo-de-paises)
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    codigoPostal
  </td>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite números sin espacios
  </td>

  <td style={{ textAlign: "left" }}>
    Código postal del tarjetahabiente
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    email
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras y/o números sin espacios, se permiten los símbolos de arroba (@), punto (.) y guiones (-), (\_). No mayor a 20 caracteres.
  </td>

  <td style={{ textAlign: "left" }}>
    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
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    telefono
  </td>

  <td style={{ textAlign: "left" }}>
    Numérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras y/o números, se permiten los símbolos de paréntesis, corchetes y guiones.
  </td>

  <td style={{ textAlign: "left" }}>
    Número Telefónico
  </td>
</tr>

<tr>
  <td style={{ textAlign: "left" }}>
    tokenCliente
  </td>

  <td style={{ textAlign: "left" }}>
    Alfanumérico
  </td>

  <td style={{ textAlign: "left" }}>
    Admite letras y/o números sin espacios. No mayor a 20 caracteres. <span style="color:blue">(Opcional)</span>
  </td>

  <td style={{ textAlign: "left" }}>
    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.
  </td>
</tr>

VARIABLE
comercioId

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

Token Tarjeta

Variables de Envío

Variables de Retorno

Formato de envío

📘
tokenTarjeta Desarrollo

📘
tokenTarjeta Produccion

Variables de Envío

Variables de Retorno

Formato de envío

📘tokenTarjeta Desarrollo

📘tokenTarjeta Produccion

📘
tokenTarjeta Desarrollo

📘
tokenTarjeta Produccion