事前準備
- Account Token を使用します。
- 注文リストから自身の注文 ID を取得します。
API 概要
state を使用して結果を判断し、finished_at を完了時刻として使用してください。現在のモデルには paid_at フィールドはありません。ステータス値には Pending、Paid、Finished、Expired、Failed、Refunded があります。
支払い期限は、まだ Pending 状態の注文のみを Expired に変更します。返金済みの Refunded 注文は、更新時または遅延した支払いコールバックを受信した後も、返金済みの状態を維持します。
再試行に関する推奨事項
- 通常の支払いでは、プラットフォームのコールバックを優先して利用してください。ステータスが長時間更新されない場合にのみ、能動的に refresh を行ってください。
- 固定の高頻度ポーリングは行わないでください。指数バックオフを推奨し、明確な終端状態になった後は停止してください。
401はトークンが無効であることを示します。403は注文所有者ではないことを示します。404は注文が存在しないことを示します。- 支払いサービスの照会に失敗した場合は、注文 ID と trace ID を保持して後で再試行してください。ステータス確認の代わりに重複した注文を作成しないでください。

