Was sind Quittungen?
Belege sind signierte, unveränderliche Aufzeichnungen diskreter Ereignisse – Zahlungen, Sicherheitsvorfälle, Compliance-Prüfungen, Lieferungen und mehr. Im Gegensatz zu Protokollen oder Audit-Trails ist jeder Beleg:- Kryptografisch signiert mit Ihrem Ausstellerschlüssel (Ed25519 oder ES256)
- Verankert im Transparenzprotokoll mit einem Merkle-Inklusionsnachweis
- Offline verifizierbar über den Export von Proof-Bundles
- Idempotent – dasselbe Ereignis erzeugt immer denselben Beleg
Belegtypen
Plattformdefinierte Belegtypen stehen allen Mandanten zur Verfügung. Jeder Typ hat ein JSON-Schema, gegen das das Feldpayload vor der Signierung validiert wird.
Verfügbare Typen entdecken
Rufen SieGET /v1/receipt-types auf, um alle Typen aufzulisten, die Ihr Mandant verwenden kann, oder GET /v1/receipt-types/{name}, um einen einzelnen Typ abzurufen und sein JSON-Schema zu überprüfen.
Einen Beleg prägen
Das Beispiel verwendet illustrative IDs und Nutzlastwerte. Ersetzen Sie diese durch Ihren Arbeitsbereich-Aussteller, den verfügbaren Signaturschlüssel und eine Nutzlast, die dem ausgewählten Belegtyp-Schema entspricht. Übermitteln Sie das Beispiel nicht als echten Zahlungsdatensatz.1
Wählen Sie einen Belegtyp
Rufen Sie
GET /v1/receipt-types auf, um verfügbare Typen aufzulisten und das Schema auf erforderliche Felder zu überprüfen.2
Erstellen Sie Ihre Payload
Erstellen Sie das Objekt
payload, das den erforderlichen Feldern für Ihren Belegtyp entspricht. Für payment_receipt benötigen Sie amount, currency, provider, provider_reference und subject.3
Über API prägen
4
Die receipt_id speichern
Die Antwort enthält die
receipt_id und log.leaf_index. Speichern Sie beide für zukünftige Verifizierungen.SDK-Beispiele
Belege auflisten
Abrufen eines Belegs
Webhook-Ereignisse
Abonnieren Sie Empfangsereignisse, indem Sie einen Webhook-Endpunkt in der Konsole konfigurieren:Widerruf eines Belegs
Der Widerruf ist dauerhaft und wird im Transparenzprotokoll aufgezeichnet. Belege mit dem Statusrevoked bleiben abfragbar, und ihr Widerrufszeitstempel ist in den Proof-Bundles enthalten. Sie können einen optionalen reason hinzufügen, um den Grund für den Widerruf des Belegs zu erfassen.
Eine Quittung verifizieren
Verwenden Sie den Verify-Endpunkt, um die kryptografische Gültigkeit und den aktuellen Status eines Belegs zu überprüfen. Die API prüft die Signatur, den Schlüsselstatus und den Widerrufsstatus und gibt dann ein Urteil zurück.Urteile
Proof-Bundles
Ein Proof Bundle ist ein eigenständiges Paket zur Offline-Verifizierung. Es enthält den signierten Empfangs-Umschlag, den Merkle-Inklusionsnachweis aus dem Transparenzprotokoll und den Schnappschuss des Ausstellerschlüssels zum Zeitpunkt der Ausstellung. Nach dem Herunterladen eines Proof-Bundles können Sie den Beleg überprüfen, ohne weitere API-Aufrufe zu tätigen.Belege suchen
Suchen Sie in Ihren Belegen mithilfe der Volltextsuche und facettierten Filtern. Der Suchindex unterstützt Abfragen von Nutzlastinhalten, und Sie können die Ergebnisse nach Typ, Status, Datumsbereich oder indizierten Nutzlastfeldern eingrenzen.Suchfilter
Belege exportieren
Einen asynchronen Massenexport von Belegen als JSON oder CSV in die Warteschlange stellen. Die API kehrt sofort mit einer Job-ID zurück. Fragen Sie den Exportstatus-Endpunkt ab, bisstatus complete ist, und laden Sie dann von der vorab signierten URL herunter.
Exportstatuswerte
Belege redigieren
Die Redaktion entfernt PII dauerhaft aus der Nutzlast eines Belegs, während der kryptografische Nachweis erhalten bleibt. Die Signatur des Belegs, der Transparenzprotokolleintrag und der Merkle-Inklusionsnachweis bleiben intakt – nur diepayload_json wird durch einen Redaktionsmarker ersetzt.
Verwenden Sie dies für DSGVO-Anfragen zum Recht auf Löschung von Belegen, die personenbezogene Daten enthalten.
statusändert sich zuredactedpayload_jsonwird durch{"redacted": true, "redacted_by": "tenant_request"}ersetzt- Ein
RECEIPT_REDACTEreignis ist im Transparenzprotokoll verankert - Alle anderen Felder (Signatur, Log-Nachweis, Belegtyp) bleiben erhalten
Belege in der Konsole verwalten
Sie können den gesamten Beleg-Lebenszyklus von der Konsole aus verwalten, ohne Code schreiben zu müssen. Öffnen Sie Belege in der Konsolen-Seitenleiste, um auf die folgenden Funktionen zuzugreifen.Belege suchen
Die Seite mit der Belegliste enthält eine Suchleiste und Filter. Geben Sie ein Stichwort ein, um Beleg-Payloads zu durchsuchen, oder verwenden Sie die Filtersteuerelemente, um die Ergebnisse nach Belegtyp, Status, Aussteller oder Datumsbereich einzugrenzen. Die Ergebnisse werden in Echtzeit aktualisiert, während Sie Ihre Abfrage verfeinern.Exportieren von Belegen
Klicken Sie in der Belegliste auf Exportieren, um einen Massenexport als CSV oder JSON in die Warteschlange zu stellen. Ein Statusbanner erscheint oben auf der Seite und verfolgt den Auftrag durch die Zuständepending, running und complete. Sobald der Export abgeschlossen ist, klicken Sie auf das Banner, um die Datei herunterzuladen. Sie können Exportaufträge auch über die API mit GET /v1/receipt-exports/{id} überwachen – siehe Belege exportieren.
Herunterladen eines Proof-Bundles
Öffnen Sie die Detailseite eines beliebigen Belegs und klicken Sie auf Nachweis-Bundle herunterladen, um ein eigenständiges Verifizierungspaket zu speichern. Das Bundle enthält den signierten Belegumschlag, den Merkle-Inklusionsnachweis und den Ausstellerschlüssel-Snapshot – alles, was für die Offline-Verifizierung benötigt wird.Redigieren eines Belegs
Klicken Sie auf der Detailseite eines aktiven Belegs auf Redigieren, um persönlich identifizierbare Informationen dauerhaft aus der Nutzlast zu entfernen. Ein Bestätigungsdialog erklärt, dass die Redaktion irreversibel ist, bevor Sie fortfahren. Die Redaktion ist nur für Belege mit dem Statusactive verfügbar. Nach der Redaktion bleiben der kryptografische Nachweis und der Transparenzprotokolleintrag erhalten – nur der Inhalt der Nutzlast wird entfernt. Weitere Informationen zu den Änderungen finden Sie unter Belege redigieren.
Aufbewahrungsrichtlinie
Belege werden automatisch gemäß der zum Zeitpunkt der Erstellung festgelegten Aufbewahrungsrichtlinie bereinigt. Ein Hintergrundprozess löscht abgelaufene Belege nach einem regelmäßigen Zeitplan. Setzen Sieretention_policy beim Prägen:
Belege, die sich ihrem Aufbewahrungsende nähern, können geschwärzt statt gelöscht werden, wenn Sie den kryptografischen Nachweis erhalten möchten, während Sie die Payload-Daten entfernen.
Nächste Schritte
Proof-Bundle-Spezifikation
Vollständige Struktur und Offline-Verifizierungsschritte für Proof-Bundles.
Receipts API-Referenz
Vollständige API-Referenz für das Prägen, Suchen, Exportieren und Redigieren von Belegen.
Webhooks
Abonnieren Sie Empfangsereignisse und verarbeiten Sie diese in Echtzeit.
Ausstellungsrichtlinien
Genehmigungsworkflows und Einschränkungen für die Belegprägung durchsetzen.

