Que sont les reçus ?
Les reçus sont des enregistrements signés et immuables d’événements discrets — paiements, incidents de sécurité, contrôles de conformité, livraisons, et plus encore. Contrairement aux journaux ou aux pistes d’audit, chaque reçu est :- Signé cryptographiquement avec votre clé d’émetteur (Ed25519 ou ES256)
- Ancré dans le journal de transparence avec une preuve d’inclusion Merkle
- Vérifiable hors ligne via l’exportation du paquet de preuves
- Idempotent — le même événement produit toujours le même reçu
Types de reçus
Les types de reçus définis par la plateforme sont disponibles pour tous les locataires. Chaque type a un schéma JSON par rapport auquel le champpayload est validé avant la signature.
Découverte des types disponibles
AppelezGET /v1/receipt-types pour lister tous les types que votre locataire peut utiliser, ou GET /v1/receipt-types/{name} pour récupérer un seul type et inspecter son schéma JSON.
Création d’un reçu
L’exemple utilise des identifiants et des valeurs de charge utile illustratifs. Remplacez-les par l’émetteur de votre espace de travail, la clé de signature disponible et une charge utile correspondant au schéma de type de reçu sélectionné. Ne soumettez pas l’exemple comme un enregistrement de paiement réel.1
Choisissez un type de reçu
Appelez
GET /v1/receipt-types pour lister les types disponibles et inspecter le schéma pour les champs requis.2
Construisez votre charge utile
Construisez l’objet
payload correspondant aux champs requis pour votre type de reçu. Pour payment_receipt, vous avez besoin de amount, currency, provider, provider_reference, et subject.3
Émettre via l'API
4
Stocker le receipt_id
La réponse inclut le
receipt_id et le log.leaf_index. Stockez les deux pour une vérification future.Exemples de SDK
Lister les reçus
Récupération d’un reçu
Événements de webhook
Abonnez-vous aux événements de réception en configurant un point de terminaison de webhook dans la console :Révocation d’un reçu
La révocation est permanente et enregistrée dans le journal de transparence. Les reçus avec le statutrevoked restent interrogeables et leur horodatage de révocation est inclus dans les paquets de preuves. Vous pouvez inclure un reason facultatif pour enregistrer la raison de la révocation du reçu.
Vérification d’un reçu
Utilisez le point de terminaison de vérification pour vérifier la validité cryptographique et le statut actuel d’un reçu. L’API vérifie la signature, le statut de la clé et l’état de révocation, puis renvoie un verdict.Verdicts
Lots de preuves
Un bundle de preuves est un paquet autonome pour la vérification hors ligne. Il comprend l’enveloppe du reçu signé, la preuve d’inclusion Merkle du journal de transparence et l’instantané de la clé de l’émetteur au moment de l’émission. Après avoir téléchargé un paquet de preuves, vous pouvez vérifier le reçu sans effectuer d’autres appels API.Recherche de reçus
Recherchez dans vos reçus en utilisant la recherche en texte intégral et les filtres à facettes. L’index de recherche prend en charge les requêtes sur le contenu de la charge utile, et vous pouvez affiner les résultats par type, statut, plage de dates ou champs de charge utile indexés.Filtres de recherche
Exportation des reçus
Mettre en file d’attente une exportation en masse asynchrone des reçus au format JSON ou CSV. L’API renvoie immédiatement un ID de tâche. Interrogez le point de terminaison de l’état de l’exportation jusqu’à ce questatus soit complete, puis téléchargez à partir de l’URL pré-signée.
Valeurs du statut d’exportation
Rédaction de reçus
La rédaction supprime définitivement les informations personnelles identifiables (PII) de la charge utile d’un reçu tout en préservant la preuve cryptographique. La signature du reçu, l’entrée du journal de transparence et la preuve d’inclusion Merkle restent intactes — seul lepayload_json est remplacé par un marqueur de rédaction.
Utilisez ceci pour les demandes de droit à l’effacement GDPR sur les reçus contenant des données personnelles.
statuspasse àredactedpayload_jsonest remplacé par{"redacted": true, "redacted_by": "tenant_request"}- Un événement
RECEIPT_REDACTest ancré dans le journal de transparence - Tous les autres champs (signature, preuve de journal, type de reçu) sont conservés
Gestion des reçus dans la console
Vous pouvez gérer le cycle de vie complet des reçus depuis la console sans écrire de code. Ouvrez Reçus dans la barre latérale de la console pour accéder aux fonctionnalités suivantes.Recherche de reçus
La page de liste des reçus comprend une barre de recherche et des filtres. Tapez un mot-clé pour rechercher dans les charges utiles des reçus, ou utilisez les commandes de filtre pour affiner les résultats par type de reçu, statut, émetteur ou plage de dates. Les résultats se mettent à jour en temps réel au fur et à mesure que vous affinez votre requête.Exportation des reçus
Cliquez sur Exporter dans la liste des reçus pour mettre en file d’attente une exportation en masse au format CSV ou JSON. Une bannière d’état apparaît en haut de la page, suivant le travail à travers les étatspending, running et complete. Une fois l’exportation terminée, cliquez sur la bannière pour télécharger le fichier. Vous pouvez également surveiller les tâches d’exportation depuis l’API en utilisant GET /v1/receipt-exports/{id} — voir exporter les reçus.
Téléchargement d’un paquet de preuves
Ouvrez la page de détails de n’importe quel reçu et cliquez sur Télécharger le paquet de preuve pour enregistrer un paquet de vérification autonome. Le paquet comprend l’enveloppe du reçu signé, la preuve d’inclusion Merkle et l’instantané de la clé de l’émetteur — tout ce qui est nécessaire pour la vérification hors ligne.Masquer un reçu
Depuis la page de détails de n’importe quel reçu actif, cliquez sur Masquer pour supprimer définitivement les informations personnellement identifiables de la charge utile. Une boîte de dialogue de confirmation explique que la masquage est irréversible avant de continuer. La masquage n’est disponible que pour les reçus avec le statutactive. Après la masquage, la preuve cryptographique et l’entrée du journal de transparence sont préservées — seul le contenu de la charge utile est supprimé. Voir masquage des reçus pour plus de détails sur les changements.
Politique de rétention
Les reçus sont automatiquement nettoyés en fonction de la politique de rétention définie au moment de la création. Un processus en arrière-plan supprime les reçus expirés selon un calendrier régulier. Définissezretention_policy lors de la frappe :
Les reçus approchant leur date limite de conservation peuvent être expurgés au lieu d’être supprimés si vous avez besoin de préserver la preuve cryptographique tout en supprimant les données de la charge utile.
Prochaines étapes
Spécification du paquet de preuves
Structure complète et étapes de vérification hors ligne pour les bundles de preuves.
Référence de l'API des reçus
Référence API complète pour la création, la recherche, l’exportation et la rédaction de reçus.
Webhooks
Abonnez-vous aux événements de réception et traitez-les en temps réel.
Politiques d'émission
Appliquer des flux d’approbation et des contraintes sur la création de reçus.

