OpenLinea permite agregar Tarjetas a la cuenta de un cliente, eliminarlas, recuperar la información de alguna en específico y listarlas. Se pueden almacenar múltiples tarjetas a nivel cliente o comercio para realizar cargos posteriores sin la necesidad de enviar nuevamente toda la información.
A continuación, se detalla la estructura de TARJETA, así como las operaciones a realizar sobre dicho objeto.
LISTADO DE TARJETAS (GET)
Para obtener una lista de los Clientes registrados, solo deberá enviar una petición de tipo GET adicionando en el HEADER de la petición las credenciales necesarias para acceder al servicio, estas son comercioId y contraseña. Los cuales deberán contener los valores asignados por Operaciones en Línea al momento de generada su Afiliación.
El servicio regresará un arreglo de objetos tipo Tarjeta con todas las registradas en el sistema.
| VALORES | FORMATO | RESTRICCIONES | DESCRIPCION |
|---|---|---|---|
| comercioId | Numérico | Admite números sin espacios. | Identificador del Comercio en OPENLINEA. Es un valor asignado. (Header) |
| 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. (Header) |
Valores de Retorno
| VARIABLE | FORMATO | RESTRICCIONES | DESCRIPCION |
|---|---|---|---|
| token | Alfanumérico | Admite letras y/o números de longitud variable | 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. |
| id | Numérico | Admite números sin espacios. | ID del comercio |
| tarjeta | Numérico | Admite solo 16 números sin espacios para Visa y Mastercard | 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 |
| digitos | 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 |
| marca | Alfanumérico | Admite solo números con 2 dígitos | 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 solo números con 2 dígitos | 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 |
| Nombre | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Nombre del Cliente |
| apellidos | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Apellidos del Cliente |
| calle | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Dirección del Cliente (se sugiere Calle y Numero) |
| colonia | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Dirección del Cliente (se sugiere cualquier referencia que ayude a ubicar la dirección del Cliente) |
| ciudad | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Ciudad |
| estado | Alfanumérico | Admite letras y/o números. No mayor a 20 caracteres. | Estado |
| 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 y/o números. No mayor a 20 caracteres. | País |
| paisId | Alfanumérico | Admite letras. Solo debe contener 2 caracteres | País de Tarjetahabiente Ejemplo: México = MX Anexo 1 - Código de Países |
| codigoPostal | Numérico | Admite números sin espacios. | Código Postal |
| 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. | |
| telefono | Alfanumé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 de longitud variable | 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) |
| estatus | Numérico | Admite números sin espacios. | Estatus de errores |
| fechaAlta | Alfanumérico | Admite letras y/o números de longitud variable | Fecha exacta en la cual se creó el cliente |
Listado de Tarjetas Desarrollo
https://servertest.operacionesenlinea.com/OpenLineaRestAPI/api/tarjetas/
Listado de Tarjetas Produccion
https://servidorseguro.operacionesenlinea.com/OpenLineaRestAPI/api/tarjetas/