決済ライフサイクルと注文ステータス - Waffo Documentation

注文ステータスの遷移

注文ステータス一覧

ステータス	説明	最終状態
`PAY_IN_PROGRESS`	注文を受け付け、ユーザーが決済中です	いいえ
`AUTHORIZATION_REQUIRED`	決済手段にユーザーの認可が必要です(電子ウォレットなど)	いいえ
`AUTHED_WAITING_CAPTURE`	認可済み、キャプチャ確認待ち(カード決済。加盟店側のキャプチャ確認が必要)	いいえ
`PAY_SUCCESS`	決済成功	はい
`ORDER_CLOSE`	注文クローズ(キャンセル、失敗、タイムアウト)	はい

サブスクリプションのステータス

サブスクリプションは IN_PROGRESS から始まります。ユーザーによる決済手段の選択または認可が必要な場合は AUTHORIZATION_REQUIRED に遷移します。ユーザーが認可を完了すると処理を続行して ACTIVE に進み、失敗またはタイムアウトした場合は CLOSE に遷移します。キャンセル系のステータスと EXPIRED は最終状態です。次の図では、作成、認可、有効化、終了の主要な遷移のみを示します。各最終ステータスは下表を参照してください。

ステータス	説明	対応
`AUTHORIZATION_REQUIRED`	ユーザー認可が必要(電子ウォレットのケース)	`subscriptionAction` URL にリダイレクト
`IN_PROGRESS`	ユーザーがサブスクリプションを確認中	Webhook を待機
`ACTIVE`	サブスクリプション有効、正常に課金中	`subscriptionId` を保存
`CLOSE`	クローズ(タイムアウトまたは失敗)	必要に応じて再開
`MERCHANT_CANCELLED`	加盟店によるキャンセル	—
`USER_CANCELLED`	ユーザーによるキャンセル	ローカルレコードを更新
`CHANNEL_CANCELLED`	チャネルによるキャンセル	ユーザーに通知
`PLATFORM_CANCELLED`	プラットフォームによるキャンセル	サブスクリプション照会レスポンスの `cancelReason` を確認
`EXPIRED`	サブスクリプションの期限切れ	必要に応じて再開

返金ステータス

ステータス	説明
`REFUND_IN_PROGRESS`	返金処理中
`ORDER_PARTIALLY_REFUNDED`	一部返金完了
`ORDER_FULLY_REFUNDED`	全額返金完了
`ORDER_REFUND_FAILED`	返金失敗

ベストプラクティス

Webhook を唯一の信頼できる情報源として扱ってください: リダイレクト URL はユーザー体験のためだけのものであり、決済結果の判定には使用しないでください。

中間ステータスの扱い: PAY_IN_PROGRESS の注文を自動的にクローズせず、Webhook を待つか能動的に照会してください
冪等な処理: Webhook は複数回配信される可能性があります。処理ロジックが冪等であることを確認してください。詳しくは冪等性を参照してください
不明なステータス: エラーコード E0001 が発生した場合は、元の paymentRequestId で照会し、注文を自動クローズしないでください。完全な処理フローはエラー処理を参照してください