Crear un titular de tarjeta

Este endpoint es para la generación del titular de la tarjeta.

Nota

 Al registrar un titular de tarjeta, los siguientes campos deben ser únicos y no se pueden compartir con dos titulares de tarjeta diferentes:

• RFC
• CURP
• Correo electrónico
• Teléfono móvil

Nota

Dependiendo la configuración de tu producto algunos campos podrían ser opcionales. Si tienes dudas contacta a [email protected].

Solicitud HTTP

• POST /cardholders

Parámetros del encabezado

Encabezado	Descripción
Authorization  requerida	El bearer token creado en  Obtener token de autorización
Content-Type  requerido	application/json

Parametros del cuerpo

Parámetro	Tipo	Patrón	Descripción
first_name requerido	cadena	1-12 caracteres	El nombre del titular de la tarjeta.
second_name  requerido	cadena	1-12 caracteres	El segundo nombre del titular de la tarjeta.
third_name  opcional	cadena	1-12 caracteres	El tercer nombre del titular de la tarjeta.
surname  requerido	cadena	1-12 caracteres	Apellido del titular de la tarjeta.
second_surname  requerido	cadena	1-12 caracteres	El segundo apellido del titular de la tarjeta.
work_area  opcional	cadena	1-50 caracteres	Área de trabajo del titular de la tarjeta.
rfc  requerido	cadena	10-13 caracteres	RFC del titular de la tarjeta.
curp requerido	cadena	18 caracteres	La CURP del tarjetahabiente.
email  requerido	cadena	correo electrónico	El correo electrónico del titular de la tarjeta.
primary_phone  requerido	cadena	10 dígitos	El teléfono principal del titular de la tarjeta. Puede ser un teléfono local o un teléfono móvil.
mobile_phone requerido	cadena	10 dígitos	El teléfono móvil del titular de la tarjeta.
street requerido	cadena	1-20 caracteres	La dirección del titular de la tarjeta.
ext_street_number  requerido	cadena	1-5 caracteres	Número de dirección del titular de la tarjeta.
int_street_number  opcional	cadena	1-5 caracteres	Número de dirección del titular de la tarjeta.
suburb  requerido	cadena	1-25 caracteres	Dirección del suburbio del titular de la tarjeta.
township  requerido	cadena	1-25 caracteres	Dirección del municipio del titular de la tarjeta.
city  requerida	cadena	1-25 caracteres	Dirección de la ciudad del titular de la tarjeta.
state  requerido	cadena	Estados	La dirección estatal del titular de la tarjeta. Consulte los valores permitidos en Obtener catálogo de estados
postal_code  requerido	cadena	5 dígitos	Código postal de la dirección del titular de la tarjeta.
birthdate requerida	fecha	AAAA-MM-dd	La fecha de nacimiento del titular de la tarjeta.
gender  requerido	cadena	Género	El género del titular de la tarjeta. Consulte los valores permitidos en Obtener catálogo de género
marital_status  requerido	cadena	Estado civil	Estado civil del titular de la tarjeta. Consulte los valores permitidos en el Catálogo de estado civil
has_kids  requerido	booleano	verdadero o falso	Si el titular de la tarjeta tiene hijos o no.
gross_monthly_income opcional	flotar	dígitos	Ingreso bruto mensual del tarjetahabiente (en MXN).
net_monthly_income  opcional	flotar	dígitos	Ingresos netos mensuales del titular de la tarjeta (en MXN).
observations  opcional	cadena	0-100 caracteres	Algunas observaciones sobre el titular de la tarjeta.
external_id  opcional	cadena	0-40 caracteres	Un lugar para poner una referencia externa.
client_id  opcional	cadena	UUID	Identificador del cliente al que será asignado el titular de tarjeta. Si no se proporciona se asigna el cliente que llama al servicio.

Ejemplo de solicitud JSON

{
    "first_name": "John",
    "second_name": "Doe",
    "third_name": "Juan",
    "surname": "González",
    "second_surname": "Pérez",
    "work_area": "Tecnologia",
    "rfc": "XAXX010101000",
    "curp": "XEXX010101HNEXXXA4",
    "email": "[email protected]",
    "primary_phone": "5555555555",
    "mobile_phone": "5555555555",
    "street": "Av. Siempre",
    "ext_street_number": "#12",
    "int_street_number": "Lt3.",
    "suburb": "Nápoles",
    "township": "Benito Juárez",
    "city": "CDMX",
    "state": "CDMX",
    "postal_code": "55120",
    "birthdate": "1995-09-22",
    "gender": "MALE",
    "marital_status": "SOLTERO",
    "has_kids": false,
    "gross_monthly_income": 20000,
    "net_monthly_income": 18000,
    "observations": ""
}

Ejemplo de respuesta JSON:

{
    "success": true,
    "code": 0,
    "message": "OK",
    "data": {
        "cardholder": {
            "id": "ec123456-1qq2-1234-tt5g-8873fe52bf54",
            "first_name": "John",
            "second_name": "Doe",
            "third_name": "Juan",
            "surname": "González",
            "second_surname": "Pérez",
            "rfc": "XAXX010101000",
            "curp": "XEXX010101HNEXXXA4",
            "email": "[email protected]",
            "primary_phone": "5555555555",
            "mobile_phone": "5555555555",
            "work_area": null,
            "address": {
                "street": "Av. Siempre",
                "external_street_number": "#12",
                "internal_street_number": "Lt3.",
                "suburb": "Nápoles",
                "township": "Benito Juárez",
                "city": "CDMX",
                "state": "CDMX",
                "postal_code": "55120",
                "country": "484"
            },
            "birthdate": "1995-09-22",
            "gender": "MALE",
            "has_kids": false,
            "gross_monthly_income": 20000,
            "net_monthly_income": 18000,
            "marital_status": "SOLTERO",
            "observations": "",
            "client_id": "",
            "external_id": ""
        }
    }
}