Crear nueva tarjeta
POST/tarjeta
Crear nueva tarjeta
Request
- application/json
Body
Crear nueva tarjeta
Possible values: >= 3 characters and <= 60 characters
Nombre como aparece en la tarjeta
Possible values: >= 14 characters and <= 19 characters
Número de tarjeta
Possible values: >= 3 characters and <= 4 characters
Código de seguridad de la tarjeta cvv2, cvc
Possible values: >= 1 and <= 12
Mes de expiración
Possible values: >= 2 characters and <= 4 characters, <= 9999
Año de expiración
direccion
object
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
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
Responses
- 200
- 400
- 401
- 4XX
- 5XX
Tarjeta creada
- application/json
- Schema
- Example (from schema)
Schema
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
tarjeta
object
Objeto tipo Tarjeta
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
{
"status": "success",
"http_code": 200,
"datetime": "2024-05-22T21:56:52.809Z",
"timestamp": 0,
"data": {
"tarjeta": {
"token": "string",
"pan": "411111******1111",
"terminacion": 0,
"nombre": "string",
"expiracion_mes": 0,
"expiracion_anio": 0,
"direccion": {
"creacion": "2024-05-22T21:56:52.809Z",
"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.809Z",
"actualizacion": "2024-05-22T21:56:52.809Z"
}
}
}
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.810Z",
"timestamp": 0,
"data": {}
}
No autenticado
- application/json
- Schema
Schema
any
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.810Z",
"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.810Z",
"timestamp": 0,
"data": {}
}