Erreurs
Les erreurs que vous pouvez rencontrer, leur cause et la réaction attendue.
Redirection d’autorisation
Quand la transaction échoue, A3BC redirige vers votre redirect_uri avec error et error_description (format OIDC standard).
| Situation | Cause probable | Que faire |
|---|---|---|
Erreur sur redirect_uri avant même d’arriver à l’app |
L’URL diffère d’un seul caractère de l’URI enregistrée. | Comparez octet par octet (schéma, hôte, chemin, slash final). |
| Erreur après le parcours utilisateur | Consentement refusé, authentification échouée, ACR non satisfaite, claim obligatoire indisponible, incident technique. | Affichez un message clair et proposez de recommencer. |
state différent |
Retour non initié par votre session. | Rejetez. |
| Claim absent alors que le scope est demandé | L’utilisateur ne l’a pas fourni à son IdP. | Ce n’est pas une erreur : prévoyez ce cas. |
| Code refusé au token endpoint | Code déjà utilisé, expiré, redirect_uri différente. |
Le code est à usage unique : recommencez le parcours. |
| Informations introuvables | Plus de 30 minutes après le consentement. | Stockez dès la réception. |
API document
| HTTP | Corps | Cause |
|---|---|---|
401 |
{"code":"004013","message":"ingress auth: authentication failed"} |
Mauvais ou absent jeton bearer. |
500 |
code, message |
Erreur interne. |
API de partage différé
Voir le tableau des codes. Réessayez uniquement sur 00001 et 00010.
Webhook
| Constat | Cause | Que faire |
|---|---|---|
| Notifications renvoyées en boucle | Votre endpoint ne répond pas 200, 201 ou 204. |
Répondez rapidement et traitez en tâche de fond. |
| Signature invalide | HMAC calculé sur un corps modifié, clé non décodée de base64, casse de la comparaison. | Voir Signature. |
Même id reçu plusieurs fois |
Reprise normale. | Dédupliquez sur id. |