Zum Hauptinhalt springen

​
Was ist eine Transaktion?

Jeder Checkout-Abschluss, jede Ledger-Buchung oder jedes Card-Network-Lifecycle-Event kann eine unveränderliche Transaktions-Zeile erstellen oder aktualisieren — für Auditing, Reporting und Webhooks.

​
Transaktionsfelder

FeldBeschreibung
idEindeutige ID (z. B. tx_xxx)
agentIdWelcher Agent die Zahlung durchgeführt hat
intentIdDer Intent, der sie autorisiert hat
amountEurosBerechneter Betrag
merchantHändlername
statuscompleted, pending, failed
typeSiehe Tabelle unten
memoOptionale Notiz (nachträglich hinzufügbar)
createdAtZeitstempel

​
Transaktions-type-Werte

Diese Werte entsprechen dem, was die API und Issuer-Webhooks persistieren:
typeBedeutung
authorizationKartenautorisierung oder Ledger-basierter Checkout (z. B. POST /checkout/execute, POST /checkout/confirm)
checkout_fillBrowser-Checkout: Fill Token eingelöst via POST /checkout/fill; Formular ausgefüllt, ohne Kartendaten dem Agent offenzulegen
settlementClearing / Settlement-Betrag vom Kartennetzwerk (Issuer-Webhooks)
refundRückerstattung auf der Karte (Issuer-Webhooks)

​
Transaktionen auflisten

curl https://api.getovra.com/transactions \
  -H "Authorization: Bearer sk_test_..."

​
Memo hinzufügen

curl -X PATCH https://api.getovra.com/transactions/tx_xxx \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"memo": "Büromaterial für Q2"}'

​
Ledger

Jede Zahlung belastet Karten-Ausgabesaldo und Kunden-Wallet im Gleichschritt, wobei Ledger-Einträge auf die Transaktion verweisen. In der Sandbox bewegt sich kein echtes Geld; das Verhalten richtet sich nach Ihren Umgebungsflags.