Zum Hauptinhalt springen

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 Feld payload vor der Signierung validiert wird.

Verfügbare Typen entdecken

Rufen Sie GET /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 Status revoked 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.
Die vollständige Bündelstruktur finden Sie in der API-Referenz für Proof-Bundles.
Sie können Proof-Bundles direkt aus der Konsole herunterladen. Öffnen Sie die Detailseite eines Belegs und klicken Sie auf Proof-Bundle herunterladen. Siehe Herunterladen in der Konsole.

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

Sie können Belege auch über die Konsole suchen, ohne Code schreiben zu müssen. Öffnen Sie Belege in der Seitenleiste und verwenden Sie die Suchleiste und Filtersteuerungen. Siehe Suchen in der Konsole.

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, bis status complete ist, und laden Sie dann von der vorab signierten URL herunter.

Exportstatuswerte

Sie können Exporte in die Warteschlange stellen und deren Fortschritt über die Konsole verfolgen. Öffnen Sie Belege, klicken Sie auf Exportieren und wählen Sie CSV oder JSON. Ein Statusbanner verfolgt den Auftrag, bis der Download bereit ist. Siehe Exportieren in der Konsole.

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 die payload_json wird durch einen Redaktionsmarker ersetzt. Verwenden Sie dies für DSGVO-Anfragen zum Recht auf Löschung von Belegen, die personenbezogene Daten enthalten.
Die Schwärzung ist dauerhaft. Die ursprüngliche Nutzlast kann nicht wiederhergestellt werden. Der kryptografische Nachweis bleibt für Prüfzwecke gültig.
Nach der Redaktion:
  • status ändert sich zu redacted
  • payload_json wird durch {"redacted": true, "redacted_by": "tenant_request"} ersetzt
  • Ein RECEIPT_REDACT Ereignis 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ände pending, 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 Status active 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 Sie retention_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.