Schnittstellenübersicht
/orders/{id} und /orders/{id}/ sind derzeit beide verfügbar. Die Bestell-ID ist Teil des Zahlungslinks und sollte als sensible undurchsichtige Kennung behandelt und nicht öffentlich verbreitet werden.
Anonyme Abfrage
Die Zahlungsseite kann bei Verlust des Login-Status direkt lesen:id, description, price, state, pay_way, pay_url, expired_at, created_at. Sie gibt weder Konto, Application, Package, interne Zahlungskennungen noch metadata zurück.
Authentifizierte Abfrage
application / applications, package / packages, bank_details, invoice_automation und Modellfelder. Wenn authentifiziert, aber nicht der Bestellbesitzer, wird 403 zurückgegeben; Superadministratoren sind ausgenommen.
Schlüsselfelder
Die vollständige Antwort kann je nach Zahlungsmethode zusätzliche Felder enthalten. Clients sollten diese nach Bedarf lesen und stets vermeiden, sensible metadata aus der vollständigen Antwort zu protokollieren.
Fehlerbehandlung
404: Die Bestell-ID existiert nicht.403: Angemeldet, aber nicht der Bestellbesitzer.- Anonyme Anfragen geben kein
401zurück; sie erhalten lediglich die minimale öffentliche Projektion.
Rechnungsstornierung und erneute Beantragung
ÜberGET /api/v1/orders/{order_id}/invoice/ kann die aktuelle Rechnung der Bestellung gelesen werden. Nach dem Einreichen einer automatischen Rechnungsstornierung bleibt die Rechnung Issued; red_state zeigt den Fortschritt der Stornierung an. Eine erfolgreiche Einreichung bedeutet nicht, dass die Stornierung abgeschlossen ist. Während auf die Bestätigung gewartet wird, eine Stornorechnung ausgestellt oder archiviert wird, kann für die Bestellung keine Rechnung erneut beantragt werden.
Wenn Administratoren aufgrund falscher Rechnungsinformationen wie Rechnungsbezeichnung oder Steuernummer eine Stornierung beantragen, lautet der Stornierungsgrund „Fehlerhafte Rechnungsstellung“; die durch eine Bestellerstattung ausgelöste automatische Stornierung verwendet weiterhin „Dienstbeendigung“.
Nachdem die Stornorechnung erfolgreich ausgestellt und archiviert wurde, wird die ursprüngliche Rechnung zu Voided, und die Bestellung kann erst dann erneut beantragt werden. Die ursprüngliche Rechnung kann im Rechnungsverlauf eingesehen werden. Wenn die Stornierung fehlschlägt oder das Ergebnis noch überprüft werden muss, übernimmt die Finanzabteilung die Prüfung; die Rechnungsbeschränkung für die Bestellung wird nicht vorzeitig aufgehoben. Manuell ausgestellte Rechnungen müssen zunächst im Steuer- oder Rechnungssystem storniert oder per Stornorechnung korrigiert werden, bevor die Finanzabteilung dies auf der Plattform bestätigt.

