Kanorio
Kanorio 개발자

비즈니스 시스템

프로모션 및 가격 규칙

Kanorio가 결제 시 적용하는 자동 할인 및 할인 코드에 대해 알아봅니다.

사용 가능

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

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가 제공하는 기능을 보여 줍니다.

API로 제공되는 범위

  • Promotions & discount codes사용 가능
    API
    Management API promotions.* (list, get, create, update, archive, unarchive, delete; applied automatically at hosted checkout)
    호스팅 사이트
    /marketing/promotions, /data/promotions
    Webhooks
    promotions.redeemed, promotions.redemption_revoked; ec.order.paid carries promotionId / promotionCode

API 레퍼런스

Webhook 이벤트

  • 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.

최근 변경

  • 2026-11-03 Promotions: create and manage promotions through the API; selector-based targeting
전체 변경 내역 보기

사이트 운영자용

관리 화면에서 이 제품을 사용하는 방법은 도움말 센터에서 안내합니다.

도움말 센터 열기