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
card_number requerido	cadena	16 dígitos*	El card_number que se asignará
cardholder_id requerido	cadena	UUID	ID del titular de 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	El número de documento perteneciente al tipo de documento.
latitude requerida	flotante	Formato de dígitos "DD.ddddd" (precisión de 5 decimales)	Latitud desde donde se realiza la asignación. Las latitudes sur están precedidas por un signo menos. Las latitudes oscilan entre -90 y 90
longitude requerida	flotante	Formato de dígitos "DDD.ddddd" (precisión decimal de 5)	Longitud desde donde se realiza la asignación. Las longitudes oeste van precedidas de un signo menos. Las longitudes van de -180 a 180
observations opcionales	cadena	0-100 caracteres	Algunos comentarios sobre la asignación

Nota

*Si el card_number se envía con 16 dígitos, se debe enviar cifrado y codificado en Base 64. Consulte Cifrado y codificación de datos

Ejemplo de solicitud JSON:

{
    "card_number":"t7wog3ytUChBC2xdLNe-sAQ-VXt7xgDi6U_iNSGQPyA7hPBYs1-_mLt", 
    "cardholder_id": "55555555-daa7-1234-aaaa-123123123ecd",
    "document_type": "INE",
    "document_number": "1234123412",
    "observations":"",
    "latitude": 12.65343,
    "longitude": -134.87536
}

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": "PHISYCAL",
            "status": "NEED_ACTIVATION",
            "masked_card_number": "************1234",
            "card_number": "************1234"   
        },
        "account": {
            "id": "22222222-daa7-1234-aaaa-123123123ecd",
            "reference": "555555555",
            "clabe": null
        }
    }
}