Adjuntar un comprobante de identidad o domicilio
Realice este paso una vez que exista la identidad o el domicilio y haya cargado los archivos requeridos mediante create_encrypt_files con el tipo de comprobante seleccionado. Utilice un identificador vigente obtenido de get_proof_types, que corresponda al requisito y a la categoría de la entidad.
Conserve identity_id y address_id obtenidos de create_document; el UUID del perfil es diferente. La compatibilidad con la adjunción posterior de comprobantes de domicilio para perfiles recién creados sigue en revisión. Si se rechaza el domicilio, consulte el portal o al equipo de soporte antes de volver a intentarlo.
Crear el comprobante
Utilice una cuenta habilitada de la API de MultiTEL y su dirección IP autorizada. Los ejemplos utilizan credenciales de autenticación HTTP Basic obtenidas de variables de entorno; siga las convenciones de autenticación de su tipo de cuenta. Envíe las solicitudes mediante HTTPS. Compruebe tanto la respuesta HTTP como el campo del objeto JSON status.code; los errores de la aplicación pueden recibirse con HTTP 200. Los ejemplos siguientes son ficticios.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--header 'Content-Type: application/json' \
--data @proof-request.json \
https://api.multitel.net/v3/create_proof{
"entity_type": "identities",
"entity_id": "33333333333333333333333333333333",
"proof_type_id": "11111111111111111111111111111111",
"encrypted_file_ids": [
"22222222222222222222222222222222"
]
}| Campo | Significado |
|---|---|
entity_type | Utilice identities o addresses. Elija la categoría que corresponda tanto a la entidad de destino como a los archivos cargados. |
entity_id | Identificador de la identidad o del domicilio perteneciente a su cuenta. Utilice el identificador devuelto por su flujo de documentos; no lo sustituya por un número de teléfono ni por un identificador de documento que no esté relacionado. |
proof_type_id | Identificador del tipo de comprobante seleccionado. Asegúrese de que corresponda a la carga y al requisito. |
encrypted_file_ids | Matriz JSON no vacía de identificadores de archivo devueltos por create_encrypt_files. Los archivos deben pertenecer a la misma cuenta, no haber caducado y corresponder a la categoría de la entidad. No es una lista de rutas de archivos locales. |
También se aceptan datos de formulario con repeticiones del campo encrypted_file_ids[]. Es preferible utilizar una matriz JSON real o una matriz de formulario; no envíe una matriz codificada en JSON como un valor escalar ordinario de formulario.
Conservar el identificador del comprobante
{
"status": {
"code": 200,
"msg": "Proof created successfully."
},
"response": {
"id": "44444444444444444444444444444444",
"entity_type": "identities",
"entity_id": "33333333333333333333333333333333",
"proof_type_id": "11111111111111111111111111111111",
"proof_type_name": "Example identity proof"
}
}Una respuesta satisfactoria confirma la creación de la asociación del comprobante. No confirma la aprobación de la identidad o del domicilio, la validación de todos los requisitos del país ni la activación de un número de teléfono.
Errores y archivos cargados caducados
El código 500 de la API se utiliza cuando faltan datos de entrada obligatorios, se producen fallos del operador o la respuesta del operador no es válida. El código 404 se utiliza cuando la entidad de destino no está asociada con la cuenta actual, el tipo de comprobante no es válido, no se encuentra un archivo cargado para esta cuenta y categoría o este ha caducado, o no quedan identificadores de archivo utilizables. Lea status.msg junto con el código.
Vuelva a cargar cualquier archivo requerido que haya caducado utilizando la categoría de comprobante correcta antes de adjuntarlo. Si alguno de los archivos proporcionados no es válido, este controlador se detiene antes de enviar la solicitud de creación del comprobante. No se ofrece ninguna clave de idempotencia: si se agota el tiempo de espera, compruebe el documento existente en el portal antes de repetir la adjunción.