Coupon の設定と利用

​

仕組み

​

対応範囲

​

Merchant Portal で設定する

​

API から Coupon を適用する

​

1 回払い

{
  "orderCurrency": "USD",
  "orderAmount": "100.00",
  "promotionInfo": {
    "promotionCode": "SAVE20"
  },
  "paymentInfo": {
    "productName": "ONE_TIME_PAYMENT"
  }
}

{
  "orderCurrency": "USD",
  "orderAmount": "100.00",
  "promotionInfo": {
    "couponId": "coupon_123"
  },
  "paymentInfo": {
    "productName": "ONE_TIME_PAYMENT"
  }
}

​

Subscription

{
  "currency": "USD",
  "amount": "100.00",
  "promotionInfo": {
    "promotionCode": "SAVE20"
  }
}

{
  "currency": "USD",
  "amount": "100.00",
  "promotionInfo": {
    "couponId": "coupon_123"
  }
}

​

Waffo Checkout で Promotion Code を入力させる

• Waffo は、Merchant で Coupon が有効で、注文作成時に割引が適用されていない場合にのみ入力欄を表示します。
• Checkout で入力できるのは Promotion Code です。couponId は入力できません。
• Waffo は Promotion Code を検証し、支払金額を再計算して表示します。
• 無効、期限切れ、利用条件外、または利用上限に達した Promotion Code は拒否されます。注文が通知なく定価で続行されることはありません。
• Merchant が API から Coupon を適用済みの場合、Checkout は割引後の金額を表示し、Promotion Code 入力欄を表示しません。

​

返金と決済結果

• 返金可能額の上限は割引後の Merchant 注文金額です。割引前の金額ではありません。
• Webhook または照会 API が返す最終ステータスを決済結果として扱ってください。ブラウザーのリダイレクトを決済成功の証明にしないでください。
• promotionCode または couponId を業務注文または Subscription とともに保存し、割引結果の照合と調査に利用してください。

​

受け入れチェックリスト

• Sandbox と対象 Production Merchant の両方で Coupon が有効になっています。
• 権限のあるアカウントで Merchant Portal の Coupons と Promotion Codes を開き、レコードを作成、表示できます。
• 1 回払いで promotionCode と couponId をそれぞれ使用した注文が成功し、各リクエストには一方のフィールドだけが含まれています。
• 割引を事前適用していない 1 回払い注文では、Checkout に有効な Promotion Code を入力でき、再計算後の金額が表示されます。
• 無効、期限切れ、または利用条件外の Promotion Code ではエラーが表示され、定価で続行されません。
• Subscription の作成または変更リクエストで Coupon が適用され、後続の請求期間は Coupon の適用期間設定に従います。
• Webhook または照会レスポンスで決済の最終ステータスを確認できます。1 回払いでは、originalAmount と orderAmount がそれぞれ割引前と割引後の金額に一致します。
• 返金額が割引後の Merchant 注文金額を超えていません。