> For the complete documentation index, see [llms.txt](https://kakaobusiness.gitbook.io/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kakaobusiness.gitbook.io/main/tool/checkout/benefits/targetbenefits.md).
# 인증 고객 혜택 관리
카카오톡 디지털카드를 보유한 고객에게 추가 적립 혜택을 제공하는 타겟형 혜택 기능입니다. 학생·임산부·반려동물 보호자처럼 원하는 고객군에게만 더 큰 혜택을 주고, 그 혜택을 구매 결정까지 자연스럽게 이어지도록 설계했습니다.
이 가이드 하나로 메뉴 진입부터 혜택 설정, 구매자에게 보이는 화면, 적립·정산 정책까지 모두 확인하실 수 있습니다.
{% hint style="info" %}
**해당 가이드는 이런 분께 필요합니다.**
* 스토어 전체 또는 특정 상품에 고객군별 추가 적립을 걸어 재구매와 충성 고객을 늘리고 싶은 판매자님께 권합니다.
{% endhint %}
***
### 1. 인증 고객 혜택 관리란?
디지털카드는 카카오톡 지갑에서 발급받는 고객 인증 수단입니다. 톡학생증, 임산부카드, 반려동물카드처럼 특정 자격이나 관심사를 증명하는 카드로, 고객은 자신이 보유한 카드에 맞는 혜택을 받게 됩니다.
판매자는 "이 카드를 가진 고객에게 몇 % 더 적립해 줄지"만 정하면 됩니다. 나머지 매칭과 계산은 톡체크아웃이 자동으로 처리합니다.
* **판매자**는 스토어 전체에 공통 적용할 혜택과 특정 상품에만 적용할 개별 혜택을 각각 설정합니다.
* **구매자**는 주문서에서 본인에게 적용 가능한 혜택을 즉시 확인하고, 예상 적립 포인트를 보며 구매를 결정합니다.
{% hint style="info" %}
인증 고객 혜택은 **할인이 아니라 적립**입니다.
결제 금액이 즉시 깎이는 것이 아니라, 조건을 충족하면 포인트로 적립됩니다.
{% endhint %}
#### 이런 점이 좋습니다
* 원하는 고객군에게만 혜택을 집중해 마케팅 비용 대비 전환 효율을 높일 수 있습니다.
* 스토어 공통 혜택과 상품별 혜택을 나눠, 전략 상품에는 더 큰 혜택을 걸 수 있습니다.
* 구매자는 주문서에서 "지금 사면 얼마가 쌓이는지"를 눈으로 확인하므로 구매 결정이 빨라집니다.
* 적립은 구매 결정 시점에 지급되어, 단순 결제가 아닌 실제 구매 완주를 유도합니다.
***
### 2. 시작하기 전에
#### 2-1. 메뉴 위치
톡체크아웃 관리자 센터 왼쪽 메뉴에서 **고객 혜택 관리 > 인증 고객 혜택 관리**로 들어갑니다. 처음 진입하면 **전체 혜택** 탭이 기본으로 열립니다.
#### 2-2. 권한
판매자 관리자 계정이면 별도 신청 없이 바로 사용할 수 있습니다. 계정별로 감춰지는 대상은 없습니다.
#### 2-3. 미리 알아두면 좋은 두 가지
먼저 어떤 디지털카드를 스토어에 노출할지는 카카오(운영자) 어드민에서 관리합니다. \
판매자 화면에 보이는 카드 목록, 카드명, 설명 문구, 노출 순서, 뱃지(추천·인기·신규)는 모두 어드민 설정을 그대로 따릅니다.
또한 혜택은 카드별 **적립률(%)**과 **ON/OFF 상태**로 관리합니다. \
적립률을 입력해 두어도 상태가 OFF이면 고객에게 적용되지 않습니다.
{% hint style="info" %}
카카오 운영자가 스토어의 인증 혜택 서비스 상태를 **운영불가**로 바꾼 경우, \
설정값은 바꿀 수 있어도 혜택은 실제로 적용되지 않습니다.
이때는 메뉴에 "관리자에 의해 고객 인증 혜택이 적용되지 않습니다" 안내가 표시됩니다.
자세한 사항은 고객센터로 문의해 주세요.
{% endhint %}
***
### 3. 빠른 시작 — 온보딩 위자드 3단계
인증 고객 혜택을 한 번도 저장한 적이 없다면, 메뉴 진입 시 설정을 빠르게 끝낼 수 있는 온보딩 위자드가 자동으로 열립니다. 세 단계면 첫 혜택이 켜집니다.
{% stepper %}
{% step %}
#### **시작하기**
위자드 안내 화면에서 **시작하기**를 누르면 디지털카드 선택 화면으로 넘어갑니다. 지금 설정하고 싶지 않다면 **닫기**를 눌러 디지털카드 목록 페이지로 이동할 수 있습니다.
{% endstep %}
{% step %}
#### **디지털카드 선택**
스토어에 적용된 디지털카드가 어드민에서 설정한 순서대로 나열됩니다. 카드명 아래에는 각 카드를 설명하는 문구가 함께 표시됩니다. 혜택을 줄 카드를 선택한 뒤 **적립률 설정하기**를 누릅니다.
* 카드를 하나도 선택하지 않으면 **적립률 설정하기** 버튼은 비활성화됩니다.
* **이전**을 눌러도 선택한 값은 그대로 유지됩니다.
{% endstep %}
{% step %}
#### **적립률 설정**
선택한 카드에 적용할 적립률을 입력합니다.
* 처음 진입하면 입력창에 추천값 **5**가 안내로 표시됩니다.
* 적립률은 **0.1% 단위**로 설정할 수 있습니다.
* 값을 입력하면 **혜택 활성화하기** 버튼이 켜집니다.
**혜택 활성화하기**를 누르면 입력한 적립률이 반영되어 목록 페이지로 이동하고, 첫 혜택이 곧바로 적용됩니다.
{% endstep %}
{% endstepper %}
{% hint style="info" %}
적립률은 **0.5% \~ 99.9%** 범위에서 설정할 수 있습니다.
0.5% 미만을 입력하면 "적립률은 0.5\~99.9%까지 설정하실 수 있습니다"라는 안내가 표시됩니다.
{% endhint %}
***
### 4. 전체 혜택 설정 (스토어 단위)
**전체 혜택**은 스토어 안에서 톡체크아웃으로 판매하는 **모든 상품**에 공통 적용되는 혜택입니다. \
카드별로 적립률과 ON/OFF를 지정합니다.
#### 4-1. 설정 방법
1. **인증 고객 혜택 관리 > 전체 혜택** 탭으로 들어갑니다.
2. **혜택 수정하기**(아직 설정 전이라면 **혜택 설정하기**)를 누르면 카드별 적립률 입력창과 ON/OFF 토글이 활성화됩니다.
3. 혜택을 줄 카드의 적립률을 입력하고 상태를 ON으로 바꿉니다.
4. **저장**을 누르면 "카드 혜택 상태를 저장하시겠습니까?" 확인 후 즉시 적용됩니다.
#### 4-2. 적립률 입력 규칙
| 항목 | 규칙 |
| ------------ | ------------------------ |
| 입력 범위 | 0.5% \~ 99.9% (0.1% 단위) |
| 숫자 외 문자 | 입력되지 않습니다 |
| 0.5% 미만 입력 | "0.5% 이상으로 입력해주세요" 안내 표시 |
| 99.9% 초과 입력 | 자동으로 99.9%로 조정 |
| 입력창을 비우고 저장 | 0%로 표기 |
| 적립률만 입력하고 저장 | ON/OFF와 무관하게 값은 저장됩니다 |
{% hint style="info" %}
카드별 적립률을 모두 합한 값이 100%를 넘으면 저장 시 "최대 적립률 초과" 팝업이 표시됩니다.
상품 가격보다 많은 포인트가 적립되지 않도록 설정을 확인해 주세요.
{% endhint %}
취소를 누르면 "저장하지 않은 변경사항이 있습니다. 취소하시겠습니까?" 확인 후 이전 상태로 돌아갑니다. 아직 아무 카드도 켜지 않은 초기 상태에서는 모든 카드가 OFF, 적립률은 0%로 표시되며, 버튼은 눈에 잘 띄도록 파란색 **혜택 설정하기**로 노출됩니다.
***
### 5. 상품별 혜택 설정
특정 상품에만 다른 혜택을 걸고 싶을 때 사용합니다. 전략 상품, 신상품, 재고 소진이 필요한 상품에 유용합니다.
{% hint style="info" %}
상품별 혜택이 설정된 상품에는 **전체 혜택이 적용되지 않습니다.**
상품별 혜택이 항상 우선합니다.
상품별 혜택을 설정하려면 먼저 전체 혜택이 한 번 이상 설정되어 있어야 합니다.
{% endhint %}
#### 5-1. 상품 등록하기
**상품별 혜택** 탭에서 **상품별 혜택 등록하기**를 누르면 3단계 팝업이 진행됩니다.
{% stepper %}
{% step %}
#### **상품 동기화**
호스팅사에 등록된 상품 중 톡체크아웃 연동 상품을 불러옵니다. 상품 데이터가 없을 때만 이 단계가 나타납니다.
* 동기화 중에는 "최신 상품 정보를 불러오는 중입니다"가 표시됩니다.
* 30초를 넘기면 실패 화면이 뜨며, 실패 시 버튼이 다시 활성화되어 재시도할 수 있습니다.
* 동기화 중 팝업을 닫아도 백그라운드에서 계속 진행됩니다.
{% endstep %}
{% step %}
#### **상품 선택**
불러온 상품 목록에서 혜택을 줄 상품을 고릅니다.
* 상품 카드에는 체크박스, 이미지, 상품명, 판매가가 표시되고 상품ID 내림차순으로 정렬됩니다.
* 이미 다른 혜택이 적용 중인 상품은 뱃지가 붙고 선택할 수 없습니다.
* 최소 1개 이상 선택하면 **혜택 설정하기** 버튼이 켜집니다.
{% endstep %}
{% step %}
#### **혜택 구성**
선택한 상품에 적용할 카드별 적립률을 입력합니다. 입력 규칙은 전체 혜택과 동일합니다(0.5\~99.9%, 0.1% 단위).
* **혜택 없음** 토글을 켜면 하단 디지털카드 설정이 모두 초기화·OFF 처리됩니다.
* 값이 없는 카드는 ON으로 켤 수 없습니다.
* **혜택 적용하기**를 누르면 "해당 상품에 N개의 혜택을 적용하시겠습니까?" 확인 후 저장됩니다.
{% endstep %}
{% endstepper %}
#### 5-2. '혜택 없음'의 의미
특정 상품을 인증 혜택 계산에서 **완전히 제외**하고 싶을 때 사용합니다. 혜택 없음으로 저장한 상품은 전체 혜택도 적용되지 않습니다. 예를 들어 이미 마진이 낮은 상품에는 어떤 카드 혜택도 얹지 않도록 지정할 수 있습니다.
#### 5-3. 등록된 상품 관리하기
* 상품 이미지, 상품명, 적용된 혜택이 함께 표시되며 등록일시 → 가나다 순으로 정렬됩니다.
* 적용된 혜택은 적립률이 가장 높은 카드 기준으로 **\[카드명] 외 N개** 형태로 노출됩니다.
* **상세보기**에서 카드별 적립률과 적립액을 확인·수정할 수 있습니다.
* **혜택 삭제**를 누르면 "선택한 상품의 개별 혜택을 삭제하시겠습니까? 삭제 후 해당 상품은 전체 혜택 대상으로 돌아갑니다" 확인 후 삭제됩니다.
* 상품별 혜택을 모두 삭제하면 다시 초기 안내 화면으로 돌아갑니다.
{% hint style="info" %}
어드민에서 특정 카드를 미노출로 바꾸면, 그 카드가 적용된 상품에서는 해당 카드 혜택이 즉시 빠집니다.
상품에 적용된 카드가 그 하나뿐이었다면 상품은 목록에서 자동으로 정리됩니다.
{% endhint %}
***
### 6. 혜택은 이렇게 계산됩니다
여러 혜택이 겹치더라도 고객이 받는 혜택은 **항상 1개**입니다. 톡체크아웃이 아래 순서로 자동 계산합니다.
#### 6-1. 우선순위
상품별 혜택이 있으면 전체 혜택보다 먼저 적용되고, 상품별 혜택이 없는 상품에만 전체 혜택이 적용됩니다.
#### 6-2. 여러 카드를 가진 고객이라면
구매자가 조건에 맞는 카드를 여러 장 가지고 있어도, 모든 후보를 포인트 금액으로 환산한 뒤 **예상 적립 포인트가 가장 큰 혜택 1개**만 적용됩니다.
* 정률 혜택은 **실결제 상품금액 × 적립률**로 계산합니다. (배송비 제외)
* 계산은 상품 단위로 이루어집니다.
* 적립 포인트가 동일하게 겹치면, 상품/스토어가 겹칠 때는 상품별 혜택이 우선하고, 카드끼리 겹치면 어드민에 등록된 카드 우선순위를 따릅니다.
* 어드민에서 OFF된 카드는 계산 후보에서 제외됩니다.
> **예시**
>
> 어떤 상품에 톡학생증 3% · 임산부카드 5% 혜택이 걸려 있고, 고객이 두 카드를 모두 보유했다면 \
> → 적립액이 더 큰 임산부카드 5% 혜택 하나만 적용됩니다.
***
### 7. 구매자에게는 이렇게 보입니다
판매자가 혜택을 설정하면, 구매자는 상품을 발견하는 순간부터 적립까지 아래 흐름으로 혜택을 경험합니다.
**➊ 구매 버튼의 적립 뱃지**
톡체크아웃 SDK 버튼(간편구매 버튼)에 **"머니 ##% 적립"** 뱃지가 표시됩니다. \
기본 적립, 디지털카드 적립, 구매확정, 리뷰 적립을 모두 합산한 값이며, 소수점은 내림으로 표기하고 최대 99%까지 노출됩니다. \
버튼 폭이 좁은 경우(가로 76px 등)에는 문구가 축약됩니다.
**➋ 디지털카드 발급 안내**
카드가 없는 고객에게는 발급 페이지가 안내됩니다. \
상품에 적용된 카드가 노출되고, **발급하기**를 누르면 지갑 서비스의 발급 과정을 거쳐 다시 상품 페이지로 돌아옵니다. \
발급 유도 문구(이벤트 메시지)는 어드민에서 운영합니다.
**➌ 주문서에서 혜택 확인**
카드를 보유한 고객이 주문서에 들어오면, 본인 카드와 상품 혜택이 매칭되어 인증 알림 배너가 나타납니다.
* **카드 보유 시**: "\[카드명] 혜택이 적용되어 최대 #,###P 적립됩니다." (여러 카드면 "\[카드명] 외 N개 …")
* **카드 미보유 시**: "\[가장 높은 적립률 카드명] 보유 시 최대 #,###P 적립됩니다." — 발급을 유도합니다.
포인트 적립 상세에는 카카오 기본 적립과 판매자가 등록한 **\[카드명] 적립**이 구분되어 표시됩니다.
**➍ 적립 시점과 이후 확인**
적립 여부는 **결제 시점의 카드 보유**를 기준으로 판단하지만, 실제 포인트는 **구매 결정 시점**에 지급됩니다. 구매 완료 페이지, 구매내역 상세, 리뷰 작성 화면, 구매 결정 화면, 카카오페이 페이포인트 내역에서 "\[카드명] 혜택 적립"으로 구분되어 표시됩니다.
{% hint style="info" %}
결제 시점에 카드가 있었다면 구매 결정 시점에 카드가 없어져도 적립됩니다.
또한 결제 시점과 구매 결정 시점의 가격이 달라져도, **결제 시점 기준 포인트**로 적립됩니다.
{% endhint %}
***
### 8. 적립 · 정산 · 환불 정책
#### 8-1. 적립 시점
인증 고객 혜택 포인트는 결제 완료가 아니라 **구매 결정 시점**에 지급됩니다. 실제 지급은 구매 결정 시점에 확정되고, 정산은 **구매 결정 +1 영업일**에 이루어집니다.
#### 8-2. 환불·취소·회수
| 상황 | 처리 |
| -------------- | ------------------------------- |
| 구매 결정 이전 취소 | 포인트 미지급 |
| 구매 결정 이후 전체 환불 | 지급 포인트 전액 회수 |
| 부분 환불 | 환불된 상품에 해당하는 포인트만 회수 |
| 회수 실패 | 운영 로그를 남기고 실패 상태로 전환(기존 방식에 따름) |
{% hint style="info" %}
세부 정책은 사내 위키의 서비스 정책 문서가 최종 기준입니다.
이 가이드의 정책 요약과 위키 내용이 다를 경우 위키를 따라 주세요.
{% endhint %}
***
### 9. 자주 묻는 질문
#### Q. 전체 혜택과 상품별 혜택을 같은 상품에 함께 적용할 수 있나요?
> 아니요. \
> 상품별 혜택이 있는 상품에는 전체 혜택이 적용되지 않습니다. \
> 상품별 혜택이 항상 우선합니다.
#### Q. 고객이 카드를 여러 장 가지고 있으면 혜택이 중복되나요?
> 중복되지 않습니다. \
> 예상 적립 포인트가 가장 큰 혜택 1개만 적용됩니다.
#### Q. 적립률은 얼마까지 설정할 수 있나요?
> 카드당 0.5%에서 99.9%까지, 0.1% 단위로 설정할 수 있습니다. \
> 다만, 카드별 적립률 합계가 100%를 넘으면 저장이 제한됩니다.
#### Q. 혜택을 저장하면 언제부터 적용되나요?
> 저장 즉시 적용됩니다. \
> 전체 혜택은 저장과 동시에, 상품별 혜택은 혜택 적용하기를 누른 즉시 반영됩니다.
#### Q. 특정 상품만 어떤 혜택도 주고 싶지 않아요.
> 상품별 혜택 설정에서 해당 상품에 **혜택 없음**을 적용하면, 전체 혜택을 포함한 모든 인증 혜택 계산에서 제외됩니다.
#### Q. 포인트는 결제하면 바로 쌓이나요?
> 아니요. \
> 구매 결정 시점에 지급됩니다. \
> 구매 결정 이전에 취소하면 포인트는 지급되지 않습니다.
#### Q. 메뉴에 "관리자에 의해 적용되지 않습니다"라고 떠요.
> 카카오 운영자가 스토어의 인증 혜택 서비스 상태를 운영불가로 설정한 경우입니다. \
> 설정은 저장할 수 있으나 실제 적용은 되지 않으며, 자세한 사유는 고객센터로 문의해 주세요.
***
### 10. 용어 정리
| 용어 | 설명 |
| -------- | --------------------------------------- |
| 디지털카드 | 카카오톡 지갑에서 발급하는 고객 인증 수단 (톡학생증, 임산부카드 등) |
| 전체 혜택 | 스토어의 톡체크아웃 판매 상품 전체에 공통 적용되는 혜택 |
| 상품별 혜택 | 특정 상품에만 적용되는 개별 혜택 (전체 혜택보다 우선) |
| 혜택 없음 | 특정 상품을 모든 인증 혜택 계산에서 제외하는 설정 |
| 인증 알림 배너 | 주문서에서 고객 카드와 혜택이 매칭될 때 표시되는 안내 |
| 구매 결정 | 구매자가 상품 수령을 확정하는 단계이자 인증 혜택 포인트 지급 시점 |
{% hint style="info" %}
설정을 마쳤다면, 실제 주문서에서 뱃지와 적립 배너가 의도한 대로 보이는지 한 번 확인해 보세요.
전략 상품에는 상품별 혜택으로 더 큰 적립을 걸어 두면 전환 효과를 체감하실 수 있습니다.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://kakaobusiness.gitbook.io/main/tool/checkout/benefits/targetbenefits.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
