Zum Hauptinhalt springen
Fragen Sie eine Bestellung über die Bestell-ID ab. Dieser Endpunkt unterstützt zwei Lesemodi: Der anonyme Zugriff gibt nur die für die Zahlungsseite erforderlichen Mindestfelder zurück; wenn der Bestellbesitzer ein Account Token mitführt, werden vollständige Details zurückgegeben.

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:
Die anonyme Antwort enthält nur 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

Der Bestellbesitzer erhält vollständige Order-Details, einschließlich 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 401 zurück; sie erhalten lediglich die minimale öffentliche Projektion.

Rechnungsstornierung und erneute Beantragung

Über GET /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.

Verwandte Schnittstellen