Transaktionsstatus abrufen
Liefert den aktuellen Status einer Transaktion anhand ihrer id mittels API-Key.
Anfrage
GET /api/v1/transactions?id={transaction_id}
Header: x-api-key: <api_key>
Erforderlich: Parameter id.
Antwortfelder
| Feld | Beschreibung |
|---|---|
| amount | Betrag (kleinste Einheiten) |
| amount_with_fee | Betrag inkl. Gebühr |
| currency | Währung |
| description | Beschreibung |
| env | Umgebung (prod / test) |
| error_description | Fehlertext bei rejected |
| finished | Abschlusszeit (ISO) |
| id | Interne UUID |
| started | Startzeit (ISO) |
| status | Status (created, charging, charged, rejected) |
| txid | Externe ID (Client) |
| type | Typ (payment / payout) |
| widget_url | Widget-URL (falls vorhanden) |
| simple_auth_redirect_url | URL für Zusatzauth / 3DS |
Beispiel
curl --location 'https://app.heth.me/api/v1/transactions?id=c033ceaa-3726-4479-8be3-c9af8a0b2336' \
--header 'x-api-key: IHR_KEY'
Hinweise
- Exponentielles Backoff beim Polling.
- Fehlendes
finished= Verarbeitung läuft. txididempotent halten.