Zum Hauptinhalt springen

Transaktionsstatus abrufen

Liefert den aktuellen Status einer Transaktion anhand ihrer id mittels API-Key.

Anfrage

GET /api/v1/transactions/{transaction_id}
Header: x-api-key: <api_key>

{transaction_id} ist die interne id (UUID) der Transaktion, als Pfadsegment.

Antwortfelder

FeldBeschreibung
amountBetrag (kleinste Einheiten)
amount_with_feeBetrag inkl. Gebühr
amount_destZielbetrag bei Konvertierung (kleinste Einheiten), falls zutreffend
currencyWährung
currency_destZielwährung bei Konvertierung, falls zutreffend
descriptionBeschreibung
envUmgebung (prod / test)
error_descriptionFehlertext bei rejected
finishedAbschlusszeit (ISO)
idInterne UUID
routeVerwendete Verarbeitungsroute
startedStartzeit (ISO)
statusStatus (siehe Abschnitt „Status" im Glossar; created, charging, charged, refunded, rejected, failed)
txidExterne ID (Client)
typeTyp (payment / payout)
widget_urlWidget-URL (falls vorhanden)
simple_auth_redirect_urlURL für Zusatzauth / 3DS

Beispiel

curl --location 'https://app.heth.me/api/v1/transactions/c033ceaa-3726-4479-8be3-c9af8a0b2336' \
--header 'x-api-key: IHR_KEY'

Hinweise

  • Exponentielles Backoff beim Polling.
  • Fehlendes finished = Verarbeitung läuft.
  • txid idempotent halten.