Crear un perfil de registro

Cree el perfil una sola vez

Esta solicitud crea un perfil de registro local junto con los registros de identidad y de dirección en el operador. Empiece por consultar los países de registro, tipos de número y requisitos vigentes. Los requisitos dependen del país y del tipo de número que piense registrar.

Una respuesta de creación correcta no equivale a una aprobación regulatoria ni a la activación de un número. Guarde por separado el UUID del documento, el ID de identidad y el ID de dirección: cumplen finalidades distintas. Esta solicitud modifica datos de la cuenta y no es una operación de solo validación.

Solicitud de creación

Autentíquese con su cuenta de API de MultiTEL habilitada y su dirección IP permitida. Los ejemplos utilizan credenciales HTTP Basic almacenadas en variables de entorno. Compruebe tanto la respuesta HTTP como el campo JSON status.code; una respuesta HTTP 200 por sí sola no demuestra que la operación se haya realizado correctamente. Todos los valores de ejemplo son ficticios.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data @registration-profile.json \
  https://api.multitel.net/v3/create_document

{
  "identity_type": "Personal",
  "first_name": "Example",
  "last_name": "Person",
  "phone_number": "12025550123",
  "email": "end-user@example.com",
  "city": "Example City",
  "postal_code": "00000",
  "country": "US",
  "address": "1 Example Street",
  "nationality": "US",
  "signature": "BASE64_PNG_OF_THE_AUTHORIZED_END_USER_SIGNATURE"
}

El JSON es un perfil Personal ilustrativo, no una identidad real lista para enviar. Sustituya sus datos y la firma por la información del usuario final exigida por las reglas de registro seleccionadas. También se admite la entrada codificada como formulario.

Campos del perfil de registro
Campo	Obligatoriedad y formato
`identity_type`	Obligatorio. Utilice el valor exacto Personal o Business; la validación condicional depende del uso de mayúsculas.
`first_name, last_name`	Obligatorios, cada uno de 64 caracteres como máximo. Para una empresa, indique los datos del representante exigidos por el país seleccionado.
`phone_number`	Valor telefónico numérico obligatorio, de al menos ocho caracteres. Un número internacional compuesto solo por dígitos, incluido su código de país, es válido para esta validación; se trata de un número de contacto, no de la compra de un número.
`city, postal_code, address`	Obligatorios, cada uno de 64 caracteres como máximo.
`country`	Código ISO obligatorio del país de la dirección, tomado del catálogo de registro. El servicio lo resuelve al registro de país del operador.
`signature`	Datos de firma obligatorios. El portal actual envía los bytes de la imagen PNG en Base64 sin el prefijo data:image/png;base64,. Obtenga la firma del usuario final mediante su flujo de trabajo autorizado; un marcador de posición no vacío no constituye una firma válida.
`nationality`	Obligatorio para Personal, como código ISO de país. No lo sustituya por un UUID de país.
`company_name, incorporation_country`	Obligatorios para Business. El nombre de la empresa tiene 64 caracteres como máximo; incorporation_country es un código ISO de país.
`email`	Correo electrónico de contacto opcional del usuario final, de 254 caracteres como máximo. Si el correo electrónico se omite o está vacío, no hereda el correo electrónico de la cuenta base.
`company_reg_number, vat_id, id_number, personal_tax_id, birth_date, description`	Opcionales en este controlador, aunque el país/operador seleccionado puede exigir algunos de ellos. Proporcione los formatos requeridos para ese registro. Las llamadas directas a la API no aplican automáticamente todas las normalizaciones que realiza el portal.

Este controlador directo v3 exige los campos de dirección y crea una dirección. No dé por hecho que la opción del portal para aplazar la dirección esté disponible a través de él.

Conserve los tres identificadores

A continuación se muestran algunos campos seleccionados de la respuesta; la respuesta real también contiene la información del perfil enviada y los datos de la firma. Trate la respuesta completa como información privada.

{
  "status": {
    "code": 200,
    "msg": "Success Create Registration Detail."
  },
  "response": {
    "uuid": "11111111111111111111111111111111",
    "identity_id": "22222222222222222222222222222222",
    "address_id": "33333333333333333333333333333333",
    "country_iso": "US",
    "email": "end-user@example.com"
  }
}

response.uuid identifica el perfil local. Utilícelo con get_document. En las respuestas de documents y get_document, el mismo identificador de perfil se denomina id.
response.identity_id identifica la identidad para las posteriores pruebas de identidad y documentos justificativos.
response.address_id identifica la dirección creada. Consérvelo por separado; el UUID del perfil local no es un ID de dirección. La compatibilidad de la adjunción posterior de pruebas de dirección para perfiles recién creados sigue en revisión.

Los dos endpoints de lectura del perfil no devuelven identity_id ni address_id, así que conserve la respuesta de creación correcta original. Si se ha perdido, utilice la vista de documentos del portal o póngase en contacto con el soporte antes de crear un sustituto.

Avanzado: adjuntar pruebas precargadas durante la creación

Puede proporcionar identity_encryptfiles y address_encryptfiles como matrices de ID devueltos por create_encrypt_files. Cargue los archivos con un tipo de prueba correspondiente a la categoría de entidad adecuada y envíe la solicitud antes de que caduque la referencia de archivo, aproximadamente a los 20 minutos. El controlador de creación comprueba la cuenta, la categoría y la caducidad de cada referencia proporcionada.

Estos campos tienen nombres distintos del encrypted_file_ids del endpoint de adjunción posterior. Durante la creación, cada archivo se envía como una solicitud de prueba independiente, incluso cuando varios archivos comparten un mismo tipo de prueba. Para una prueba de identidad que deba contener varios archivos juntos, utilice la solicitud create_proof posterior con una sola matriz. La creación correcta del perfil por sí sola no proporciona resultados de aprobación individuales de las pruebas.

Si una prueba de dirección posterior se rechaza para una dirección recién creada, no sustituya el UUID del perfil ni vuelva a crear la identidad repetidamente. Deténgase y compruebe el perfil en el portal o con el soporte. La ruta de lectura/consulta de pruebas de dirección sigue siendo una limitación de la revisión.

Errores y creación parcial

El código 400 de la API abarca la validación de campos, los errores de creación en el operador y los errores de guardado local. Los errores de validación pueden aparecer como entradas indexadas por campo en response. El código 500 se utiliza para un país de registro no disponible o no válido, y el código 404 para referencias precargadas inexistentes o caducadas. Lea status.msg además del código.

El perfil local y las operaciones ascendentes en el operador no forman una única transacción atómica. Una solicitud fallida puede dejar estado en el sistema ascendente incluso cuando no aparece ningún perfil local en la lista. No se expone ninguna clave de idempotencia de cliente. Tras un tiempo de espera agotado o un fallo incierto, inspeccione los perfiles existentes y póngase en contacto con el soporte antes de repetir la creación; una lista documents vacía no demuestra que no se haya creado nada en el sistema ascendente.