プロモーションと価格ルール

プロモーションは、チェックアウト時に顧客が支払う金額を変えます。条件を満たしたときに自動で適用される割引と、顧客が入力するコードの2種類があります。プロモーションは割引対象を指し示すものであり、商品がプロモーションを持つわけではありません。

APIの位置づけ

• Management APIでプロモーションを管理します：promotions.list、promotions.get、promotions.create、promotions.update（PATCH）、promotions.archive、promotions.unarchive、promotions.delete。ルールはダッシュボードと同じで、promotions.createはIdempotency-Keyに対応しています。
• 商品リストではなくセレクターで対象を指定します：kinds（PRODUCT、BOOKING、CUSTOM）、refs（商品と任意のバリエーション、予約リソース、またはカスタム品目の独自SKU）、categoryIds、priceRange。marketIdsでプロモーションを一部のマーケットに限定できます。予約やカスタム品目も対象にでき、最低注文金額の割引にも含められます。
• Kanorioはホスト型チェックアウトの中でプロモーションを評価するため、フロントエンドで割引を計算する必要はありません。ヘッドレスのストアフロントはプロモーションを読み取ってバッジを表示できますが、割引が適用されるのはKanorioのチェックアウトページのみです。
• promotions.redeemedとpromotions.redemption_revokedを購読すると、支払い済み注文がプロモーションを利用したとき、および全額返金で利用回数が戻ったときに通知を受け取れます。ec.order.paidにはpromotionIdとpromotionCodeが含まれます。

下のサポート表は、APIが公開している機能を示します。