Joindre un justificatif d’identité ou de domicile

Effectuez cette étape une fois l’identité ou l’adresse créée et ses fichiers requis téléversés via create_encrypt_files avec le type de justificatif sélectionné. Utilisez un identifiant à jour provenant de get_proof_types, correspondant à l’exigence et à la catégorie de l’entité.

Conservez les valeurs identity_id et address_id renvoyées par create_document ; l’identifiant UUID du profil est différent. La compatibilité du rattachement ultérieur d’un justificatif de domicile aux profils nouvellement créés est toujours à l’étude. Si l’adresse est rejetée, consultez le portail ou contactez l’assistance avant de réessayer.

Créer le justificatif

Utilisez un compte API MultiTEL activé et l’adresse IP autorisée pour ce compte. Les exemples utilisent des identifiants d’authentification HTTP Basic issus de variables d’environnement ; respectez les conventions d’authentification propres à votre type de compte. Envoyez les requêtes via HTTPS. Vérifiez à la fois la réponse HTTP et, dans le contenu JSON, le champ status.code ; des erreurs applicatives peuvent être renvoyées avec le statut HTTP 200. Les exemples ci-dessous sont fictifs.

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"
  ]
}

Champs de la requête
Champ	Signification
`entity_type`	Utilisez identities ou addresses. Choisissez la catégorie correspondant à la fois à l’entité ciblée et aux fichiers téléversés.
`entity_id`	Identifiant de l’identité ou de l’adresse appartenant à votre compte. Utilisez l’identifiant renvoyé par votre parcours de gestion des documents ; ne le remplacez pas par un numéro de téléphone ou par l’identifiant d’un document sans rapport.
`proof_type_id`	Identifiant du type de justificatif sélectionné. Veillez à sa cohérence avec les fichiers téléversés et l’exigence.
`encrypted_file_ids`	Tableau JSON non vide contenant les identifiants de fichiers renvoyés par create_encrypt_files. Les fichiers doivent appartenir au même compte, ne pas avoir expiré et correspondre à la catégorie de l’entité. Il ne s’agit pas d’une liste de chemins de fichiers locaux.

Les données de formulaire sont également acceptées avec plusieurs occurrences du champ encrypted_file_ids[]. Privilégiez un véritable tableau JSON ou un tableau de formulaire ; n’envoyez pas un tableau encodé en JSON comme une simple valeur scalaire de formulaire.

Conserver l’identifiant du justificatif

{
  "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"
  }
}

Une réponse indiquant un succès confirme la création de l’association du justificatif. Elle ne confirme ni l’approbation de l’identité ou de l’adresse, ni la validation de toutes les exigences du pays, ni l’activation d’un numéro de téléphone.

Erreurs et fichiers téléversés expirés

Le code 500 de l’API est utilisé lorsque des données requises sont absentes, en cas de défaillance de l’opérateur ou de réponse non valide de celui-ci. Le code 404 est utilisé lorsque l’entité ciblée n’est pas associée au compte actuel, que le type de justificatif n’est pas valide, qu’un fichier téléversé est introuvable pour ce compte et cette catégorie ou a expiré, ou qu’il ne reste aucun identifiant de fichier utilisable. Lisez status.msg en complément du code.

Téléversez de nouveau tout fichier requis ayant expiré, en utilisant la bonne catégorie de justificatif, avant de le joindre. Si l’un des fichiers fournis n’est pas valide, ce gestionnaire s’arrête avant d’envoyer la requête de création du justificatif. Aucune clé d’idempotence n’est proposée : après un dépassement du délai d’attente, vérifiez le document existant dans le portail avant de répéter le rattachement.