Skip to main content
Fragen Sie proaktiv den neuesten Status der der Bestellung entsprechenden Zahlungsmethode ab und synchronisieren Sie ihn mit der Plattform. Diese Anfrage kann auf Zahlungsdienste zugreifen und den Bestellstatus ändern; verwenden Sie sie nur bei verzögerten Rückrufen oder wenn eine sofortige Bestätigung erforderlich ist.

Vorbereitungen

Schnittstellenübersicht

Bei Erfolg wird das vollständige aktualisierte Order-Objekt zurückgegeben. Verwenden Sie state, um das Ergebnis zu bestimmen, und finished_at als Abschlusszeitpunkt; das aktuelle Modell hat kein Feld paid_at. Zu den Statuswerten gehören Pending, Paid, Finished, Expired, Failed und Refunded. Die Zahlungsfrist ändert nur Bestellungen, die sich weiterhin im Status Pending befinden, in Expired. Bereits erstattete Bestellungen im Status Refunded bleiben auch nach einer Aktualisierung oder dem Empfang eines verspäteten Zahlungsrückrufs im erstatteten Status.

Wiederholungsempfehlungen

  • Verlassen Sie sich bei normalen Zahlungen vorrangig auf Plattform-Rückrufe; führen Sie nur dann aktiv ein Refresh durch, wenn der Status lange nicht aktualisiert wird.
  • Verwenden Sie kein festes hochfrequentes Polling. Es wird exponentielles Backoff empfohlen, und stoppen Sie bei einem eindeutigen Endstatus.
  • 401 bedeutet, dass das Token ungültig ist; 403 bedeutet, dass Sie nicht der Bestellinhaber sind; 404 bedeutet, dass die Bestellung nicht existiert.
  • Wenn die Abfrage des Zahlungsdienstes fehlschlägt, bewahren Sie die Bestell-ID und die Trace-ID auf und versuchen Sie es später erneut; erstellen Sie keine doppelten Bestellungen als Ersatz für die Statusbestätigung.

Zugehörige Schnittstellen