Enrichissements

Un enrichissement est le résultat réglé d'un appel : une identité marchande (ou son absence), un statut, et ce que l'appel a coûté. Il est identifié par un enrichment_id de la forme enr_<uuid>, et son contenu reste lisible pendant 90 jours.

Une transaction, un ou plusieurs enrichissements

Une transaction, identifiée par votre external_transaction_id, commence par un premier enrichissement. Chaque rafraîchissement ajoute un nouvel enrichissement, avec son propre enrichment_id ; il n'écrase jamais le précédent.

tx_8f21c0 (votre external_transaction_id)
├── enr_ffe8…  création            resolved              ← résultat courant au départ
└── enr_dd42…  rafraîchissement    refresh_recalculated  ← devient le résultat courant

À tout moment, la transaction a un résultat courant : le premier, remplacé seulement par un rafraîchissement qui aboutit (refresh_recalculated). C'est lui qu'un nouvel envoi de la même transaction rend en déduplication. Chaque enrichment_id, lui, continue de désigner son propre résultat. Voir Cycle de vie.

Un enrichissement créé avec une seule Idempotency-Key, sans external_transaction_id, existe et se relit, mais il n'est rattaché à aucune transaction : il ne se déduplique pas et ne se rafraîchit pas.

Les trois opérations

Chacune consomme un jeton de débit. Les schémas complets figurent dans la référence de l'API.

Ce qu'il faut retenir

• Un 200 est un résultat réglé, pas forcément un marchand trouvé : lisez enrichment.status. Voir Statuts.
• Un enrichissement est propre au workspace et à l'environnement qui l'ont créé ; toute clé de ce workspace et de cet environnement peut le relire.
• Le contenu expire au bout de 90 jours ; l'identité, la ligne de registre et l'écriture comptable survivent. Voir Rétention et 410.

Dans cette section

• Créer un enrichissement
• Relire un enrichissement
• Rafraîchir
• Statuts
• Cycle de vie
• Rétention et 410