Skip to main content
注文に対応する支払い方法の最新ステータスを能動的に照会し、プラットフォームに同期します。このリクエストは支払いサービスにアクセスして注文ステータスを変更する可能性があるため、コールバックが遅延している場合、または直ちに確認が必要な場合にのみ使用してください。

事前準備

API 概要

成功すると、更新後の完全な Order オブジェクトを返します。state を使用して結果を判断し、finished_at を完了時刻として使用してください。現在のモデルには paid_at フィールドはありません。ステータス値には Pending、Paid、Finished、Expired、Failed、Refunded があります。 支払い期限は、まだ Pending 状態の注文のみを Expired に変更します。返金済みの Refunded 注文は、更新時または遅延した支払いコールバックを受信した後も、返金済みの状態を維持します。

再試行に関する推奨事項

  • 通常の支払いでは、プラットフォームのコールバックを優先して利用してください。ステータスが長時間更新されない場合にのみ、能動的に refresh を行ってください。
  • 固定の高頻度ポーリングは行わないでください。指数バックオフを推奨し、明確な終端状態になった後は停止してください。
  • 401 はトークンが無効であることを示します。403 は注文所有者ではないことを示します。404 は注文が存在しないことを示します。
  • 支払いサービスの照会に失敗した場合は、注文 ID と trace ID を保持して後で再試行してください。ステータス確認の代わりに重複した注文を作成しないでください。

関連 API