Asignar una tarjeta a un titular de tarjeta

Estas operaciones le permiten asignar una tarjeta del stock a un titular de tarjeta.

Solicitud HTTP

PUT /cards

Parámetros del encabezado

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

Parámetros del cuerpo

Parámetro	Tipo	Patrón	Descripción
cardholder_id requerido	cadena	UUID	ID del titular de la tarjeta.
product_id requerido	cadena	UUID	ID del producto al que se asociará la tarjeta.
document_type requerido	cadena	Tipo de Documento	El tipo de documento del titular de la tarjeta que se registrará en la tarjeta. Ver valores permitidos en Obtener catálogo de tipos de documentos
document_number requerido	cadena	1-27 caracteres	Número de documento perteneciente al tipo de documento.
observations requerido	cadena	0-100 caracteres	Comentarios sobre la asignación.
shipping_method requerido	cadena	B2B | B2C | CUSTOM	Define de dónde se toma la dirección para el envío.
delivery_type requerido	cadena	STANDARD | EXPRESS	Tipo de entrega. EXPRESS indica envío urgente.
delivery_address requerido	objeto o null	—	Dirección de entrega solo cuando shipping_method = CUSTOM.

Estructura de delivery_address

Parámetro	Tipo	Descripción
state	cadena	Estado
township	cadena	Municipio
city	cadena	Ciudad
suburb	cadena	Colonia
street	cadena	Calle
ext_street_number	cadena	Número exterior
int_street_number	cadena	Número interior
postal_code	cadena	Código postal

Regla de dirección según shipping_method

• B2B → Se usa la dirección del titular (cardholder)
• B2C → Se usa la dirección del cliente (client)
• CUSTOM → Se usa delivery_address

Ejemplo de solicitud JSON

{
  "document_type": "CURP",
  "document_number": "1234123481",
  "cardholder_id": "10c54e03-b2f5-4dff-9806-618eb1314f1d",
  "product_id": "2c023492-d989-4a2f-a425-9f9076fdcda5",
  "observations": "Asignacion",
  "shipping_method": "CUSTOM",
  "delivery_type": "STANDARD",
  "delivery_address": {
    "state": "SAN LUIS POTOSI",
    "township": "VILLA DE ARISTA",
    "city": "SAN LUIS POTOSI",
    "suburb": "SANTA TERESA",
    "street": "MOCTEZUMA",
    "ext_street_number": "22",
    "int_street_number": "",
    "postal_code": "76116"
  }
}

Ejemplo de respuesta JSON:

{
    "success": true,
    "code": 0,
    "message": "OK",
    "data": {
        "cardholder": {
            "id": "ab123456-1qq2-1234-tt5g-8873fe52bf54",
            "first_name": "John",
            "second_name": "Doe",
            "surname": "González",
            "second_surname": "Pérez",
            "rfc": "XAXX010101000",
            "curp": "XEXX010101HNEXXXA4"
        },
        "card": {
            "id": "11111111-daa7-1234-aaaa-123123123ecd",
            "type": "PHYSICAL",
            "status": "NEED_ACTIVATION",
            "last_four": "1234",
            "assignation_timestamp": "2025-07-24T00:00:00.000-06:00"
        },
        "account": {
            "id": "22222222-daa7-1234-aaaa-123123123ecd",
            "reference": null,
            "clabe": null,
            "assignation_timestamp": "2025-07-24T00:00:00.000-06:00"
        },
        "product": {
            "id": "33333333-daa7-1234-aaaa-123123123ecd",
            "code": "XXX001",
            "name": "PRODUCT_NAME"
        }
    }
}