Erreurs et reprises
Distinguer HTTP et résultat métier
Une erreur HTTP décrit l’issue de l’appel. Un rejet métier décrit le résultat de l’opération. Une réponse HTTP réussie à une initiation ne prouve pas que le paiement est irrévocable : consultez son statut ou suivez les notifications.
Le contrat utilise le format de problème RFC 7807 avec notamment type, title, detail, instance et status. Consultez les réponses déclarées pour l’opération appelée dans la référence API.
Reconnaître quelques motifs
| Code métier | Sens dans les guides Business |
|---|---|
DU03 | txId déjà utilisé |
BE23 | Alias invalide |
AG07 | Solde du compte débiteur insuffisant |
AM04 | Garantie du participant insuffisante |
FF10 | Erreur de traitement du système interne du participant |
Les motifs disponibles dépendent de l’opération. Ne déduisez pas un code HTTP d’un code métier, ni l’inverse.
Reprendre après une réponse incertaine
Conservez le txId, l’instructionId et l’end2endId disponibles, l’opération appelée et l’heure de l’appel. Consultez ensuite le résultat par la route adaptée : paiement envoyé par txId, vérification par end2endId, demande émise par txId, lot par instructionId, ou mouvement entre comptes filtré par txId.
Ne créez pas une nouvelle opération financière pour compenser une simple absence de réponse. Faites clarifier l’état auprès du participant si les consultations ne permettent pas de déterminer le résultat. Un txId déjà utilisé n’est pas une invitation à générer un autre identifiant et à renvoyer le paiement.
Pour un statut 429, tenez compte des indications de temporisation fournies par le serveur. Une nouvelle tentative d’écriture doit toujours respecter les règles d’idempotence propres à l’opération ; n’appliquez pas une politique de reprise uniforme à tous les endpoints.
Préparer une demande d’assistance
Transmettez au participant les références de l’opération, l’heure, le chemin appelé et le statut reçu. Retirez les jetons, clés d’API, secrets HMAC, clés privées et données client inutiles de toute trace partagée.