# 캘린더 쿠폰 코드

## 캘린더 쿠폰 코드

쿠폰 코드를 사용하면 예약 위젯을 통해 이루어지는 캘린더 예약에 할인을 제공할 수 있습니다. 고객이 결제 시 유효한 쿠폰을 입력하면 할인이 적용되고, 이는 예약 세부 정보의 결제(Payments) 탭에서 추적됩니다.

***

**목차**

* [캘린더 쿠폰 코드 사용 개요](#캘린더-쿠폰-코드-사용-개요)
* [캘린더 쿠폰 코드 사용의 주요 이점](#캘린더-쿠폰-코드-사용의-주요-이점)
* [지원되는 캘린더 및 제한사항](#지원되는-캘린더-및-제한사항)
* [캘린더 쿠폰 코드 사용 방법](#캘린더-쿠폰-코드-사용-방법)
* [자주 묻는 질문](#자주-묻는-질문)

***

## 캘린더 쿠폰 코드 사용 개요

캘린더 쿠폰 코드는 고객이 예약 위젯에서 예약할 때 할인 코드를 입력할 수 있게 해줍니다. 유효한 코드가 적용되면 위젯이 실시간으로 가격을 재계산하고, 예약 기록의 결제(Payments) 탭에 할인(쿠폰) 항목이 표시됩니다. 퍼센트 또는 고정 금액, 유효 기간, 사용 한도, 상품이나 캘린더별 적용 대상 등을 통해 쿠폰 규칙을 제어할 수 있습니다.

***

### 캘린더 쿠폰 코드 사용의 주요 이점

쿠폰을 통해 원활하고 쉽게 타겟 프로모션을 진행할 수 있습니다:

* **높은 전환율**: 적절한 시기의 할인으로 결제 과정의 마찰과 장바구니 포기를 줄입니다.
* **유연한 프로모션**: 시즌 캠페인이나 한정 캠페인을 위해 퍼센트 기반 또는 고정 금액 할인을 사용할 수 있습니다.
* **제어 및 타겟팅**: 연락처별 또는 전체 사용 횟수를 제한하여 쿠폰이 과도하게 사용되지 않도록 합니다.
* **향상된 고객 경험**: 고객이 예약 위젯에서 직접 코드를 적용/제거할 수 있으며 즉시 가격이 업데이트됩니다.

***

### 지원되는 캘린더 및 제한사항

* 쿠폰 코드는 Neo 및 Classic 예약 위젯 모두에서 **모든 캘린더에 완전히 지원**되며, \*\*서비스(v2)\*\*에서도 지원됩니다.
* 쿠폰 코드는 이전 버전인 \*\*서비스 메뉴(v1)\*\*에서는 **지원되지 않습니다**. 보다 현대적인 예약 흐름, 지속적인 지원, 쿠폰 코드와 같은 기능 접근을 위해 서비스(v2)로 이전하는 것을 강력히 권장합니다.
* 쿠폰 코드는 **예약 위젯을 통해서만 사용할 수 있으며**, 앱 내 모달을 통해 수동으로 생성된 예약에는 적용할 수 없습니다. 이 기능에 대한 지원은 향후 릴리스에서 제공될 예정입니다.

***

### 캘린더 쿠폰 코드 사용 방법

**1단계: 캘린더에서 '결제 수신' 및 '쿠폰 코드' 활성화**

쿠폰을 생성하기 전에 캘린더에서 결제가 활성화되어 있는지 확인하세요.

* `Calendar Settings(캘린더 설정) > Forms & Payments(폼 및 결제)`로 이동합니다.
* `Accept Payments(결제 수신)`를 활성화합니다.

활성화되면 상품(Products) 탭에 캘린더 태그가 있는 상품이 자동으로 생성됩니다 (이 상품은 삭제할 수 없습니다).

* 아래로 스크롤하여 **쿠폰 코드 활성화** 옵션을 켜세요.

이렇게 하면 예약 위젯에 쿠폰 입력 필드가 추가됩니다.

참고: 쿠폰을 활성화하려는 각 캘린더마다 개별적으로 활성화해야 합니다.

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155053042348/original/2BmUcD2W08bw34s9w76leLfpB334HvfghQ.png?1756923074)

**2단계: 쿠폰 생성**

`Payments(결제) > Coupons(쿠폰)`로 이동하여 `New Coupon(새 쿠폰)`을 클릭합니다.

다음 옵션들을 설정할 수 있습니다:

* **쿠폰 코드**: 사용자 정의 코드를 입력하거나(예: 10OFF) `Generate(생성)` 버튼을 클릭하여 자동 생성합니다.
* **쿠폰 유형**: 다음 중 선택하세요:
  * 퍼센트 쿠폰(예: 10% 할인)
  * 고정 금액 쿠폰(예: 50,000원 할인)
* **할인 금액**: 퍼센트 또는 고정 할인 값을 입력합니다.
* **시작 및 종료 날짜/시간**: 쿠폰 유효 기간을 정의합니다.
* **사용 횟수 제한**: (선택사항) 쿠폰을 전체적으로 몇 번 사용할 수 있는지 제한합니다.
* **상품/오퍼로 제한**: 쿠폰이 적용될 특정 캘린더나 상품을 선택합니다.
* **고객당 한 번만 사용**: 같은 고객이 여러 번 사용하는 것을 방지합니다.

저장하면 쿠폰을 고객과 공유할 준비가 완료됩니다.

쿠폰 생성에 대한 자세한 정보는 다음을 참조하세요: 상품 쿠폰 생성 방법

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155053042418/original/w6kgwOtoYOhG_9Kz9DHcjiCAh__kzqBt8g.png?1756923179)

**3단계: 고객 경험**

* 캘린더 위젯을 통해 예약할 때 고객은 쿠폰 코드 입력 상자를 볼 수 있습니다.
* 코드가 유효한 경우:
  * 할인이 즉시 적용됩니다
  * 조정된 총액이 결제 전에 표시됩니다
* 코드가 무효한 경우:
  * 오류 메시지가 나타납니다

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155053042475/original/22Nepc6ubOIoY2QkZJ9V__078Aw5h90NfA.png?1756923322)

**4단계: 쿠폰 사용 추적**

모든 쿠폰 및 결제 세부 정보는 예약 세부 정보의 결제(Payments) 탭에서 확인할 수 있습니다:

* 적용된 쿠폰
* 할인 금액
* 조정된 총액
* 참석자별 결제 내역

![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155053042516/original/FurzP0dgxoQDfjPqmhjQ3YDQoQX9kbxrgQ.png?1756923392)

### 중요 업데이트: 주문 생성 및 $0 거래

2025년 12월 22일 릴리스 이후 쿠폰 코드와 캘린더 결제가 관련된 경우 주문, 인보이스, 거래의 동작 방식이 변경되었습니다. 이 섹션에서는 새로운 동작을 명확히 하고 $0 거래 및 누락된 인보이스에 대한 일반적인 질문을 다룹니다.

#### **1. 인보이스 생성 동작 변경**

이전에는 예약에 부분 결제가 포함되면 부분 지불된 인보이스가 자동으로 생성되었습니다. 이번 릴리스 이후로는 이런 경우에 더 이상 인보이스가 생성되지 않고 대신 주문이 생성됩니다.

* 결제(필요한 경우)는 여전히 주문에 대해 수집할 수 있습니다
* 이 변경사항은 플랫폼 전반의 주문 기반 결제 추적을 표준화하는 데 도움이 됩니다

#### **2. $0 거래가 보이는 이유**

앱 내 예약 흐름을 통해 주문이 생성될 때마다 해당 주문에 대해 $0 거래가 기록됩니다.

* 이 거래는 주문 생성을 나타내며 실제 결제가 아닙니다
* 이는 청구나 성공적인 결제를 의미하지 않습니다

#### **3. 주문이 생성되는 경우**

* 캘린더에서 결제가 활성화되어 있으면 항상 주문이 생성됩니다
* 캘린더에서 결제가 활성화되어 있지 않으면 주문이 생성되지 않습니다

이 동작은 다음과 같은 경우에도 적용됩니다:

* 쿠폰 코드로 인해 결제 금액이 $0이 되는 경우
* 예약 시 즉시 결제가 수집되지 않는 경우

#### **4. 기존 워크플로우에 미치는 영향 (인보이스 트리거)**

"인보이스 생성됨" 트리거를 사용하여 구성된 워크플로우가 있다면 업데이트해야 합니다.

필요한 조치: 워크플로우가 예상대로 계속 실행되도록 하려면 인보이스 생성됨 트리거를 주문 생성됨 트리거로 교체하세요.

#### **5. 워크플로우에서 $0 거래 처리**

결제 관련 트리거에 의존하는 워크플로우를 사용하고 있다면 다음과 같이 업데이트하는 것을 권장합니다:

* `Payment Received(결제 수신됨)` 트리거를 사용하세요
* `If/Else` 조건을 추가하세요
* If 브랜치에서 조건을 설정하세요: 금액이 0보다 큰 경우
* 이 브랜치에서만 워크플로우 액션을 트리거하세요

이렇게 하면 실제 결제에 대해서만 워크플로우가 실행되고, 주문 생성 중에 생성되는 $0 시스템 거래에 의해 트리거되지 않습니다.

***

### 자주 묻는 질문

**Q: 예약 후 할인을 어떻게 확인하나요?** 예약을 열고 결제(Payments) 탭을 확인하세요. 할인(쿠폰), 결제 금액, 잔여 잔액 총액을 볼 수 있습니다.

**Q: 쿠폰이 활성화된 후 편집하거나 비활성화할 수 있나요?** 네. `결제 > 쿠폰`에서 쿠폰을 열어 한도/날짜를 업데이트하거나 비활성화할 수 있습니다. 변경사항은 향후 예약에 적용됩니다.

**Q: 실제 카드로 청구하지 않고 쿠폰을 테스트하려면 어떻게 하나요?** 캘린더의 결제 모드를 테스트로 설정하고, 게이트웨이의 테스트 자격 증명(예: Stripe 테스트 카드)을 사용해 테스트 예약을 완료한 다음, 완료되면 다시 라이브로 전환하세요.

**Q: 고객이 한 번의 예약에서 여러 쿠폰을 중복 사용할 수 있나요?** 아니오. 결제당 하나의 활성 코드만 지원됩니다. 고객은 결제 전에 코드를 제거하고 다른 코드를 적용할 수 있습니다.

**Q: 쿠폰 코드는 대소문자를 구분하나요?** 코드는 대소문자를 구분하지 않습니다. 예를 들어, 쿠폰 코드가 'SUMMER25'이고 고객이 'Summer25'로 입력해도 쿠폰이 적용됩니다.

***

*원문 최종 수정: Wed, 7 Jan, 2026 at 4:29 AM* *Hyperclass 사용 가이드 — hyperclass.ai*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hyperclass.gitbook.io/hyperclass-docs/and-calendars/workflow-action-book-appointment/coupon-codes-in-calendars.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.