Crear Tarjeta

CREAR TARJETA (POST)

Para crear una nueva Tarjeta, se requiere enviar una petición de tipo POST, adicionar en el HEADER de la petición las Credenciales necesarias para acceder al servicio, estas son comercioId y contrasena. Los cuales deberán contener los valores asignados por Operaciones en Línea al momento de generada su Afiliación.

Como parte del cuerpo del POST se deberán incluir los siguientes parámetros:

  <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.\ <span style="color:red">(Header)</span>
  </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.\ <span style="color:red">(Header)</span>
  </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. <span style="color:blue">(Opcional)</span>
  </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 y Mastercard
  </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" }}>
    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" }}>
    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" }}>
    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 Cliente (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 Cliente
  </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 cliente
  </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" }}>
    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" }}>
    Numero 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.
  </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.\ <span style="color:blue">(Opcional)</span>
  </td>
</tr>

VARIABLE
comercioId

Valores de Retorno

  <th>
    FORMATO
  </th>

  <th>
    RESTRICCIONES
  </th>

  <th>
    DESCRIPCION
  </th>
</tr>

  <td>
    Alfanumérico
  </td>

  <td>
    Admite letras y/o números de longitud variable
  </td>

  <td>
    TOKEN mediante el cual se identifica de forma única a la Tarjeta, este dato es requerido en el caso de operaciones de Actualización, Búsqueda y/o Eliminación de Tarjeta.
  </td>
</tr>

<tr>
  <td>
    id
  </td>

  <td>
    Numérico
  </td>

  <td>
    Admite números sin espacios.
  </td>

  <td>
    ID del comercio
  </td>
</tr>

<tr>
  <td>
    tarjeta
  </td>

  <td>
    Numérico
  </td>

  <td>
    Admite solo 16 números sin espacios para Visa y Mastercard
  </td>

  <td>
    Número de la Tarjeta de Crédito o Débito
  </td>
</tr>

<tr>
  <td>
    mes
  </td>

  <td>
    Numérico
  </td>

  <td>
    Admite solo números con 2 dígitos
  </td>

  <td>
    Mes de Vencimiento de la Tarjeta de Crédito o Débito
  </td>
</tr>

<tr>
  <td>
    anio
  </td>

  <td>
    Numérico
  </td>

  <td>
    Admite solo números con 4 dígitos
  </td>

  <td>
    Año de Vencimiento de la Tarjeta de Crédito o Débito
  </td>
</tr>

<tr>
  <td>
    digitos
  </td>

  <td>
    Numérico
  </td>

  <td>
    Admite solo números con 3 dígitos
  </td>

  <td>
    Dígitos Verificadores de la Tarjeta de Crédito
  </td>
</tr>

<tr>
  <td>
    titular
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Admite solo Letras, Espacios y Puntos
  </td>

  <td>
    Nombre completo del Titular tal cual aparece en la Tarjeta de Crédito
  </td>
</tr>

<tr>
  <td>
    marca
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Admite solo números con 2 dígitos
  </td>

  <td>
    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>
    tipo
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Admite solo números con 2 dígitos
  </td>

  <td>
    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>
    Nombre
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Admite letras y/o números. No mayor a 20 caracteres.
  </td>

  <td>
    Nombre del Cliente
  </td>
</tr>

<tr>
  <td>
    apellidos
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Admite letras y/o números. No mayor a 20 caracteres.
  </td>

  <td>
    Apellidos del Cliente
  </td>
</tr>

<tr>
  <td>
    calle
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Admite letras y/o números. No mayor a 20 caracteres.
  </td>

  <td>
    Dirección del Cliente (se sugiere Calle y Numero)
  </td>
</tr>

<tr>
  <td>
    colonia
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Admite letras y/o números. No mayor a 20 caracteres.
  </td>

  <td>
    Dirección del Cliente (se sugiere cualquier referencia que ayude a ubicar la dirección del Cliente)
  </td>
</tr>

<tr>
  <td>
    ciudad
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Admite letras y/o números. No mayor a 20 caracteres.
  </td>

  <td>
    Ciudad
  </td>
</tr>

<tr>
  <td>
    estado
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Admite letras y/o números. No mayor a 20 caracteres.
  </td>

  <td>
    Estado
  </td>
</tr>

<tr>
  <td>
    estadoId
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Admite letras. Solo debe contener 2 caracteres
  </td>

  <td>
    Estado del Tarjetahabiente\
    Ejemplo: Nuevo León = NL\
    Anexo 2 - Código de Estados para México\
    Dato indispensable para el esquema 3D Secure 2.0
  </td>
</tr>

<tr>
  <td>
    pais
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Admite letras y/o números. No mayor a 20 caracteres.
  </td>

  <td>
    País
  </td>
</tr>

<tr>
  <td>
    paisId
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Admite letras. Solo debe contener 2 caracteres
  </td>

  <td>
    País de Tarjetahabiente\
    Ejemplo: México = MX\
    Anexo 1 - Código de Países\
    Dato indispensable para el esquema 3D Secure 2.0
  </td>
</tr>

<tr>
  <td>
    codigoPostal
  </td>

  <td>
    Numérico
  </td>

  <td>
    Admite números sin espacios.
  </td>

  <td>
    Código Postal
  </td>
</tr>

<tr>
  <td>
    email
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    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>
    Dirección de Correo Electrónico para el envío de Notificaciones.
  </td>
</tr>

<tr>
  <td>
    telefono
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Admite letras y/o números, se permiten los símbolos de paréntesis, corchetes y guiones.
  </td>

  <td>
    Número Telefónico
  </td>
</tr>

<tr>
  <td>
    tokenCliente
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Admite letras y/o números de longitud variable
  </td>

  <td>
    Token mediante el cual se identifica de forma única al Cliente y se utiliza en caso de querer asociar la Tarjeta al Catálogo de Clientes.\
    (Opcional)
  </td>
</tr>

<tr>
  <td>
    estatus
  </td>

  <td>
    Numérico
  </td>

  <td>
    Admite números sin espacios.
  </td>

  <td>
    Estatus de errores
  </td>
</tr>

<tr>
  <td>
    fechaAlta
  </td>

  <td>
    Alfanumérico
  </td>

  <td>
    Admite letras y/o números de longitud variable
  </td>

  <td>
    Fecha exacta en la cual se creó el cliente
  </td>
</tr>

VARIABLE
token

📘
Crear Tarjeta Desarrollo
https://servertest.operacionesenlinea.com/OpenLineaRestAPI/api/tarjetas/

📘
Crear Tarjeta Produccion
https://servertest.operacionesenlinea.com/OpenLineaRestAPI/api/tarjetas/

Crear Tarjeta

CREAR TARJETA (POST)

Valores de Retorno

📘
Crear Tarjeta Desarrollo

📘
Crear Tarjeta Produccion

CREAR TARJETA (POST)

Valores de Retorno

📘Crear Tarjeta Desarrollo

📘Crear Tarjeta Produccion

📘
Crear Tarjeta Desarrollo

📘
Crear Tarjeta Produccion