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

> Automatic discounts and discount codes that Kanorio applies at checkout.

> Markdown version of https://kanorio.com/ja/developers/products/promotions. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp
>
> Translated from the English original: https://kanorio.com/en/developers/products/promotions.md

Status: **Available**

プロモーションは、チェックアウト時に顧客が支払う金額を変えます。条件を満たしたときに自動で適用される割引と、顧客が入力するコードの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が公開している機能を示します。

## What the APIs expose

| Capability | Status | API | Elements | Hosted site | Webhooks |
| --- | --- | --- | --- | --- | --- |
| Promotions & discount codes | Available | Management API `promotions.*` (list, get, create, update, archive, unarchive, delete; applied automatically at hosted checkout) | — | `/marketing/promotions`, `/data/promotions` | `promotions.redeemed`, `promotions.redemption_revoked`; `ec.order.paid` carries `promotionId` / `promotionCode` |

## API reference

- Management API: [Promotions](https://kanorio.com/en/developers/management-api/promotions) (7 operations)

## Webhook events

- `promotions.redeemed`: Fired when a paid order redeems a promotion (automatic discount or discount code). Carries the promotion, the order and how the discount was split across lines; never the buyer email.
- `promotions.redemption_revoked`: Fired when a full refund revokes a redemption (the promotion usage count is given back). Partial refunds do not revoke.

Payloads: https://kanorio.com/en/developers/webhooks/events

## Recent changes

- 2026-11-03: Promotions: create and manage promotions through the API; selector-based targeting

Full changelog: https://kanorio.com/en/developers/changelog

## For site owners

Dashboard help: https://kanorio.com/ja/help/promotions