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
| Feld | Beschreibung |
|---|---|
| amount | Betrag (kleinste Einheiten) |
| amount_with_fee | Betrag inkl. Gebühr |
| amount_dest | Zielbetrag bei Konvertierung (kleinste Einheiten), falls zutreffend |
| currency | Währung |
| currency_dest | Zielwährung bei Konvertierung, falls zutreffend |
| description | Beschreibung |
| env | Umgebung (prod / test) |
| error_description | Fehlertext bei rejected |
| finished | Abschlusszeit (ISO) |
| id | Interne UUID |
| route | Verwendete Verarbeitungsroute |
| started | Startzeit (ISO) |
| status | Status (siehe Abschnitt „Status" im Glossar; created, charging, charged, refunded, rejected, failed) |
| 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/c033ceaa-3726-4479-8be3-c9af8a0b2336' \
--header 'x-api-key: IHR_KEY'
Hinweise
- Exponentielles Backoff beim Polling.
- Fehlendes
finished= Verarbeitung läuft. txididempotent halten.