# 프로모션 및 가격 규칙

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

> Markdown version of https://kanorio.com/ko/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**

프로모션은 고객이 결제 시 지불하는 금액을 바꿉니다. 조건을 충족하면 자동으로 적용되는 할인과 고객이 입력하는 코드 두 가지가 있습니다. 프로모션은 할인 대상을 가리키며, 상품이 프로모션을 소유하지 않습니다.

## 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/ko/help/promotions