Consultar listado de Tarjetas
GET/tarjeta
Consultar listado de Tarjetas
Request
Query Parameters
Possible values: >= 5 and <= 100
Default value: 25
Máximo de registros a regresar
Número de página
Possible values: [actualizacion, cliente_id, creacion, iin, marca, nombre, pan, terminacion, token]
Valor que será usado como referencia en la búsqueda
Possible values: [asc, desc]
Podrá ser de orden Ascendente (asc) o Descendente (desc)
Responses
- 200
- 400
- 401
- 404
- 4XX
- 5XX
Listado de objetos tipo Tarjetas
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
Possible values: [success, fail, error]
Estatus de la petición
Possible values: [200, 400, 401, 404, 500]
Código http de respuesta en el header
Fecha y hora de creación del plan
Tiempo Unix o POSIX
data
object
tarjetas
object
Arreglo de objetos tipo Cliente
data
object[]
Token de Tarjeta
Possible values: >= 14 characters and <= 19 characters
Número de tarjeta sanitizado
Terminación o últimos cuatro dígitos
Nombre como aparece en la tarjeta
Possible values: >= 1 and <= 12
Mes de expiración de tarjeta
Año de expiración de tarjeta
direccion
object
Fecha de creación del objeto
Possible values: <= 120 characters
Línea de dirección 1
Possible values: <= 120 characters
Línea de dirección 2
Possible values: <= 120 characters
Línea de dirección 3
Possible values: >= 3 characters and <= 10 characters
Código postal
telefono
object
Possible values: [no_definido, movil, casa, oficina, facturacion, mensajeria, temporal]
De acuerdo al catálogo tipo teléfono
Codigo telefónico de un país
Codigo telefónico de área
Valor opcional, prefijo utilizado por algunos países
Teléfono del cliente
Extensión
Possible values: <= 60 characters
Municipio o delegación
Possible values: <= 60 characters
Ciudad
Possible values: >= 3 characters and <= 3 characters
Identificador de estado de tres caracteres de acuerdo al estándar ISO 3166-2
Possible values: >= 3 characters and <= 3 characters
Identificador de país de tres caracteres de acuerdo al estándar ISO 3166-1
Possible values: <= 120 characters
Referencia adicional, ejemplo: nombre de entre calle 1
Possible values: <= 120 characters
Referencia adicional, ejemplo: nombre de entre calle 2
Possible values: >= -90 and <= 90
Coordenadas de longitud de localización del domicilio
Possible values: >= -90 and <= 90
Coordenadas de latitud de localización del domicilio
Primeros seis dígitos de una tarjeta, equivale a BIN
Possible values: [visa, mastercard, discover, amex, diners_club, jcb, switch, solo, dankort, maestro, forbrugsforeningen, laser]
De acuerdo al catálogo Marca de Tarjeta
Id de cliente en plataforma T1pagos
Determina si la tarjeta es la utilizada por dafault para el cliente asignado
Determina si la tarjeta sólo se puede utilizar para un único cargo
Índice de inicio
Índice de fin
Possible values: >= 5 and <= 100
Default value: 10
Número de registros por página
Possible values: >= 1
Página actual de registros
Possible values: >= 1
Número de última página
Total de registros
Total de registros
{
"status": "success",
"http_code": 200,
"datetime": "2024-05-22T21:56:52.814Z",
"timestamp": 0,
"data": {
"tarjetas": {
"data": [
{
"token": "string",
"pan": "411111******1111",
"terminacion": 0,
"nombre": "string",
"expiracion_mes": 0,
"expiracion_anio": 0,
"direccion": {
"creacion": "2024-05-22T21:56:52.814Z",
"linea1": "string",
"linea2": "string",
"linea3": "string",
"cp": "string",
"telefono": {
"tipo": "no_definido",
"codigo_pais": "string",
"codigo_area": "string",
"prefijo": "string",
"numero": "5566778899",
"extension": 0
},
"municipio": "string",
"ciudad": "string",
"estado": "string",
"pais": "string",
"referencia_1": "string",
"referencia_2": "string",
"longitud": 0,
"latitud": 0
},
"iin": 0,
"marca": "visa",
"cliente_id": "string",
"default": true,
"cargo_unico": true,
"creacion": "2024-05-22T21:56:52.814Z",
"actualizacion": "2024-05-22T21:56:52.814Z"
}
],
"desde": 0,
"hasta": 0,
"registros_por_pagina": 10,
"pagina_actual": 0,
"ultima_pagina": 0,
"total_pagina": 0,
"total": 0
}
}
}
Error en petición
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [error, fail]
Estatus de la petición
error
object
Código http de respuesta en el header
Fecha y hora de creación.
Tiempo Unix o POSIX
Datos del error obtenido, sólo estará presente en errores HTTP 400
{
"status": "error",
"error": {
"code": 0,
"type": "string",
"message": "string"
},
"http_code": 0,
"datetime": "2024-05-22T21:56:52.815Z",
"timestamp": 0,
"data": {}
}
No autorizado
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [error, fail]
Estatus de la petición
error
object
Código http de respuesta en el header
Fecha y hora de creación.
Tiempo Unix o POSIX
Datos del error obtenido, sólo estará presente en errores HTTP 400
{
"status": "error",
"error": {
"code": 0,
"type": "string",
"message": "string"
},
"http_code": 0,
"datetime": "2024-05-22T21:56:52.815Z",
"timestamp": 0,
"data": {}
}
No se ha encontrado el recurso solicitado
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [error, fail]
Estatus de la petición
error
object
Código http de respuesta en el header
Fecha y hora de creación.
Tiempo Unix o POSIX
Datos del error obtenido, sólo estará presente en errores HTTP 400
{
"status": "error",
"error": {
"code": 0,
"type": "string",
"message": "string"
},
"http_code": 0,
"datetime": "2024-05-22T21:56:52.815Z",
"timestamp": 0,
"data": {}
}
Error en petición
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [error, fail]
Estatus de la petición
error
object
Código http de respuesta en el header
Fecha y hora de creación.
Tiempo Unix o POSIX
Datos del error obtenido, sólo estará presente en errores HTTP 400
{
"status": "error",
"error": {
"code": 0,
"type": "string",
"message": "string"
},
"http_code": 0,
"datetime": "2024-05-22T21:56:52.815Z",
"timestamp": 0,
"data": {}
}
Error interno
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [error, fail]
Estatus de la petición
error
object
Código http de respuesta en el header
Fecha y hora de creación.
Tiempo Unix o POSIX
Datos del error obtenido, sólo estará presente en errores HTTP 400
{
"status": "error",
"error": {
"code": 0,
"type": "string",
"message": "string"
},
"http_code": 0,
"datetime": "2024-05-22T21:56:52.816Z",
"timestamp": 0,
"data": {}
}