Feldkonventionen & Glossar
Betrag & Währung
| Begriff | Definition |
|---|
| amount | Integer in kleinsten Einheiten |
| amount_with_fee | Betrag inkl. Gebühr |
| currency | Währungs-/Token-Code (USDT) |
Bezeichner
| Begriff | Definition |
|---|
| id | Interne Transaktions-UUID |
| txid | Idempotente externe Kunden-ID |
Routing & Umgebung
| Begriff | Definition |
|---|
| route | Verarbeitungsalias (konfiguriert für API-Key) |
| env | Umgebung: prod (Default) oder test |
Status
| Status | Bedeutung |
|---|
| created | Angenommen, wartet |
| charging | In Verarbeitung |
| charged | Erfolgreich |
| rejected | Fehlgeschlagen |
Zeitfelder
| Feld | Bedeutung |
|---|
| started | Startzeit (ISO) |
| finished | Abschlusszeit (ISO) |
money_storage Felder
| Feld | Bedeutung |
|---|
| network | Blockchain-Netzwerk |
| type | Instrumenttyp |
| wallet_id | Wallet-ID |
| cardnumber | Virtuelle Kartennummer |
| cvv | Virtueller Karten-CVV |
| exp_month / exp_year | Ablaufdaten |
| cardholder | Karteninhaber |
Fehler
| Feld | Bedeutung |
|---|
| error_description | Fehlertext (nicht stabil) |
Idempotenz
Gleiche Operation erneut nur mit identischem txid senden.
Polling
Intervalle: 1s, 2s, 4s, 8s … bis charged oder rejected.
Webhook
Informativ – Status immer per GET verifizieren.