Passer au contenu principal

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 champ payload est validé avant la signature.

Découverte des types disponibles

Appelez GET /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 statut revoked 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.
Consultez la référence de l’API du bundle de preuves pour la structure complète du bundle.
Vous pouvez télécharger des lots de preuves directement depuis la console. Ouvrez la page de détails d’un reçu et cliquez sur Télécharger le lot de preuves. Voir téléchargement dans la console.

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

Vous pouvez également rechercher des reçus depuis la console sans écrire de code. Ouvrez Reçus dans la barre latérale et utilisez la barre de recherche et les contrôles de filtre. Voir recherche dans la console.

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 que status soit complete, puis téléchargez à partir de l’URL pré-signée.

Valeurs du statut d’exportation

Vous pouvez mettre en file d’attente les exportations et suivre leur progression depuis la console. Ouvrez Reçus, cliquez sur Exporter et choisissez CSV ou JSON. Une bannière d’état suit le travail jusqu’à ce que le téléchargement soit prêt. Voir exportation dans la console.

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 le payload_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.
La rédaction est permanente. La charge utile originale ne peut pas être restaurée. La preuve cryptographique reste valide à des fins d’audit.
Après rédaction :
  • status passe à redacted
  • payload_json est remplacé par {"redacted": true, "redacted_by": "tenant_request"}
  • Un événement RECEIPT_REDACT est 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 états pending, 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 statut active. 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éfinissez retention_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.