Vérification de la carte numérique

POST

Vérifie le code QR animé présenté par un utilisateur.

Vérifie le contenu du code QR animé affiché par l’application ExcelID quand l’utilisateur présente sa carte numérique. L’API utilise son propre point d’accès (voir Environnements). Voir le parcours dans Vérification de la carte numérique.

/idcard/verify

Corps de la requête

application/json

qrData chaîne Obligatoire

Le contenu lu dans le code QR, tel quel.

endUserIp chaîne

Si le contrôle se fait à distance (visioconférence), l’adresse IP de la personne. Pour un contrôle en personne, omettez-le.

{ "qrData": "excelid-id.0f3a7c52-9d41-4b6e-8a20-71c5e2d9b3f4.12.7a1c0d…" }

200 · Requête réussie

verificationId chaîne

Référence de la vérification effectuée.

user objet

L’identité vérifiée : personalNumber, name, givenName, surname.

issuer objet

Le partenaire qui a activé l’ExcelID et la date d’activation.

identifiedAt, verifiedAt date

L’heure à laquelle l’utilisateur s’est identifié dans l’application, et celle à laquelle vous avez vérifié le code QR (ISO 8601, UTC).

proof objet

La preuve de l’identification : signature, signedPayload, devicePublicKey. À conserver si vous devez justifier le contrôle.

{
  "verificationId": "c3d2b1a0-5e4f-4a6b-8c7d-9e0f1a2b3c4d",
  "user": { "personalNumber": "B1234567", "name": "Aïcha Ouédraogo", "givenName": "Aïcha", "surname": "Ouédraogo" },
  "issuer": { "partner": "Orange Money", "activatedAt": "2026-11-13T08:52:10Z" },
  "identifiedAt": "2026-11-13T09:40:58Z",
  "verifiedAt": "2026-11-13T09:41:01Z",
  "proof": { "signature": "MEUCIQ…", "signedPayload": "excelid-id:v1:…", "devicePublicKey": "MFkwEwYH…" }
}

Erreurs

HTTP	`errorCode`	Raison
400	`invalidParameters`	Le contenu n’est pas un code ExcelID, ou la requête est mal formée.
400	`qrCodeExpired`	Le code est trop ancien. Demandez à la personne d’afficher à nouveau sa carte.
400	`qrCodeUsed`	Le code a déjà été vérifié : un code ne sert qu’une fois.
401, 403	`unauthorized`	Vous n’avez pas accès au service.