> For the complete documentation index, see [llms.txt](https://developers-apps-in-toss.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers-apps-in-toss.toss.im/guide/marketing/promotion.md).
# 프로모션
### 프로모션이란
앱인토스의 프로모션은 사용자의 특정 행동을 기준으로 토스 포인트를 지급하는 이벤트예요. 예를 들어 가입하기, 첫 이용 완료하기 같은 행동을 기준으로 혜택을 줄 수 있어요.
프로모션은 비즈 월렛에 충전한 예산으로 운영해요. 혜택 탭에 노출할지 여부도 콘솔에서 직접 설정할 수 있어요.
프로모션 허용 유형
* 회원가입·접속 보상 (예: 신규 가입 시 2,000포인트 지급)
* 거래·구매 유도형 (조건과 안내가 명확해야 해요. 예: 5,000원 이상 결제 시 500포인트 지급)
* 단, 한 번 지급한 토스 포인트는 회수할 수 없어요. 프로모션 조건과 지급 기준을 충분히 검토한 뒤 신중하게 운영해 주세요.
* 이벤트 참여형 (설문·퀴즈·간단한 미션. 단, 시간이나 노동을 많이 요구할 수 없어요.)
* 친구 초대형 (초대한 사람과 초대받은 사람 모두 보상. 어뷰징 방지 로직 필수)
* 게임이 아닌 앱의 확률형·랜덤 보상
* 프로모션 기간은 1주일 이내로만 운영할 수 있어요.
* 새로운 사용자를 유입하기 위한 홍보 목적으로만 쓸 수 있어요.
* 게임이 아닌 앱으로 등록했더라도, 게임물로 분류되면 확률형 프로모션을 진행할 수 없어요.
프로모션 불가 유형
* 게임 앱의 확률형·랜덤 보상 (룰렛, 뽑기 등)
* 게임 결과 기반 보상 (점수, 승패, 등수 기반)
* 재화 환전형 리워드 (기프티콘·상품권을 토스 포인트로 전환)
* 현금 보장형·유사 수신 행위 (투자성·사행성 성격)
* 1인당 5,000포인트를 넘는 지급 (추첨형은 별도로 검토)
{% hint style="info" %}
**참고해 주세요**
프로모션 기능은 별도의 서버 없이도 쓸 수 있어요.
게임이 아닌 미니앱은 서버로 프로모션 포인트를 지급하는 방식(Server-to-Server)도 쓸 수 있어요. 요청 위·변조 방지처럼 무결성이 중요하다면, 서버로 지급하는 방식을 이용해 주세요.
프로모션 기능은 별도의 서버 없이도 사용할 수 있어요.
서버로 프로모션을 지급하려면 토스 로그인을 구현해야 해요. [토스 로그인 가이드](/guide/authentication/intro.md)를 참고해 주세요.
{% endhint %}
프로모션으로 토스 포인트가 지급되면, 사용자 화면 위쪽에 토스트(toast) 알림이 떠요.
* **{{미니앱 이름}}에서 {{금액}}원을 지급했어요** 형식으로 잠깐 떴다가 자동으로 사라져요.
* 토스 앱 알림 메뉴(홈 화면의 종 버튼)에서도 확인할 수 있어요.
* 단, 사용자의 알림 설정에 따라 알림 메뉴에서 보이지 않을 수 있어요.
* 혜택 탭의 토스 포인트 메뉴에서 적립 내역도 확인할 수 있어요.
* 토스 앱에서 혜택 → 토스 포인트 → 포인트 금액 → 미니앱 이름 순으로 눌러 적립 내역을 확인할 수 있어요.
***
### 프로모션의 좋은 점
* 비즈니스 월렛을 미리 충전하고 예산과 종료일을 설정해서, 예산을 넘겨 쓸 걱정 없이 운영할 수 있어요.
* 토스 혜택 탭에 노출되면 많은 트래픽과 함께 더 많은 사용자가 들어올 수 있어요.
* 가입하기, 첫 플레이 진행하기처럼 사용자의 행동을 간단하게 유도할 수 있어요.
* 일간·주간 미션으로 사용자가 다시 방문할 이유를 만들어, 리텐션을 높일 수 있어요.
* 포인트 지급과 결과 조회를 API로 처리할 수 있어요.
* 테스트용 코드인 `TEST_{promotionCode}`를 쓰면, 실제 포인트를 차감하지 않고 검증할 수 있어요.
{% hint style="info" %}
**참고해 주세요**
* 앱인토스의 여러 프로모션을 모아 보여주는 '새로운 서비스 써보고' 탭은, 내부 노출 로직에 따라 일부 사용자에게만 보일 수 있어요.
* 사행성 콘텐츠, 자사 앱 설치 유도, 법령 위반 가능성이 있는 콘텐츠로는 프로모션을 진행할 수 없어요.
* 1인 1회 제한, 일일 제한, 쿨다운, 중복 지급 방지 로직은 꼭 적용해 주세요.
* 지급이 지연되면, PENDING 상태 안내와 결과를 확인할 수 있는 경로를 제공해 주세요.
* 프로모션을 시작하려면 사전 검수가 필요해요. 검수에는 영업일 기준 약 2\~3일이 걸려요.
{% endhint %}
***
### 콘솔에서 프로모션 등록하기
프로모션을 시작하려면 아래 항목을 먼저 준비해 주세요. 이미 준비가 끝났다면 바로 5번(프로모션 등록)으로 넘어가도 돼요.
* 사업자 정보 등록과 정산 정보 검토 (사업자 검토 영업일 기준 1\~2일, 정산 검토 2\~3일 소요)
* 대표관리자의 프로모션 기능 약관 동의와 비즈니스 월렛 약관 동의
* 프로모션 예산을 비즈니스 월렛에 충전 (최소 30만 원, 최대 3,000만 원)
#### 1. 사업자 정보 등록하기
프로모션은 사업자(개인 또는 법인) 계정에서만 쓸 수 있어요. 사업자 등록이 되어 있지 않으면, 콘솔에 '먼저 사업자 정보를 등록해 주세요' 화면이 보여요. '등록하기'를 눌러 사업자 정보를 등록해 주세요.
* 사업자 정보 검토는 **영업일 기준 약 1\~2일** 걸릴 수 있어요.
* 자세한 절차는 [사업자 등록 가이드](https://developers-apps-in-toss.toss.im/guide/operation/register-business)를 확인해 주세요.
#### 2. 정산 정보 등록하기
사업자 등록이 끝나면 '다음으로 정산 정보를 등록해 주세요' 화면으로 바뀌어요. '등록하기' 버튼을 눌러 파트너 정보 메뉴에서 정산 정보를 등록하고, 검토를 요청해 주세요.
* 정산 정보 검토는 **영업일 기준 평균 2\~3일** 걸려요.
* 정산 정보를 등록하기 전에는 검토를 요청할 수 없어요. 사업자 등록 상태를 먼저 확인해 주세요.
{% hint style="info" %}
**정산 정보 등록 시 주의사항**
* 예금주명은 통장 사본과 **정확히 똑같이** 입력해 주세요.
* 업태·업종은 숫자 코드가 아니라 **텍스트**로 입력해 검색해 주세요. 예) '소프트웨어 개발업'은 '소프트웨어'로 검색
{% endhint %}
#### 3. 비즈니스 월렛 충전하기
정산 정보 검토가 끝나면, 프로모션 약관에 동의해 주세요.
그 이후 **프로모션 메뉴 우측 상단 위젯**이나 워크스페이스의 '비즈니스 월렛' 메뉴에서 예산을 충전할 수 있어요.
* 충전할 수 있는 금액: **최소 50,000원 \~ 최대 30,000,000원**
* 지금 쓸 수 있는 결제 수단: 신용카드(인증 결제, 비인증 결제)
* 인증 결제: 카드사별 결제 제한 없음
* 비인증 결제: 하나카드 하루 100만 원 제한, 나머지 카드사 제한 없음 (비인증 결제는 카드 번호를 직접 입력하는 방식이에요.)
충전이 끝나면 상태가 '충전'으로 바뀌고, 충전한 금액이 반영돼요.
자동 충전도 함께 설정할 수 있어요. (예: 10만원 남으면 50만원씩 충전)
**정산 및 운영 원칙**
* 프로모션 예산은 비즈니스 월렛에서 충전한 뒤 설정해요. 예산이 다 소진되면 프로모션이 끝나요.
* 프로모션을 중단하면, 남은 예산은 비즈 월렛으로 반환돼요. (잔액이 있는 경우)
* 중복 참여·어뷰징 방지 로직은 꼭 적용해야 해요.
* 클레임이 생기면, 참여 기록을 확인한 뒤 파트너사에서 처리해야 해요.
#### 4. 프로모션 등록하기
**혜택 탭에 노출하는 경우**
**혜택 탭에 노출하지 않는 경우**
* **프로모션 이름:** 사용자가 어떤 조건을 채우면 포인트를 받는지 구체적으로 입력해 주세요. 예) 서비스 로그인 시 10포인트 지급, 튜토리얼 완료 시 20포인트 지급
* **프로모션 종료일:** 원하는 종료일을 설정해 주세요. 예산이 다 소진되면 예정일보다 먼저 끝날 수 있어요.
* **혜택 탭 노출 여부**
* 노출: 토스 앱에서 혜택 → 새로운 서비스 써보고 메뉴에 함께 노출돼요.
* 미노출: 미니앱으로 직접 접속하는 사용자에게만 프로모션을 제공해요.
* 주의: 미노출로 등록한 뒤 나중에 노출하려면 **새 프로모션을 등록**해야 해요. (수정으로는 바꿀 수 없어요.)
* **미션 이름** (혜택 탭 노출 시 필수): 미션 이름은 '\~하기'로 끝나야 해요. 예) 튜토리얼 하기, 로그인 하기, 리뷰 남기기
* **지급 방식** (혜택 탭 노출 시 필수)
* 고정 금액: 정해진 금액을 지급해요.
* 최대 금액: 1인당 최대로 지급할 수 있는 금액이에요. 이 범위 안에서 랜덤으로 지급해요. 예) 최대 100원 → 1회 참여 시 0\~100원 중 지급
* **이동 URL** (혜택 탭 노출 시 필수)
* 형식: `intoss://{{appName}}/ScreenName`
* 혜택 탭에서 이 URL로 들어와요.
* **예산 정보**
* 예산은 비즈 월렛 잔액보다 크게 설정할 수 없어요.
* 진행 중에 예산을 늘리려면, 비즈 월렛을 충전한 뒤 프로모션 수정에서 늘릴 수 있어요.
* **1인 하루 최대 지급 금액** (필수): 한 명이 하루에 받을 수 있는 최대 금액을 직접 설정해 주세요.
* 같은 사용자에게 이 금액을 넘겨 지급하지 않아요.
* 어뷰징을 막고 예산을 안정적으로 관리하는 데 도움이 돼요.
* 특히 어뷰징이 걱정된다면 꼭 설정해 주세요. 클라이언트에서 포인트 지급을 요청하는 경우에도 적용하시길 권장해요.
프로모션 사전 점검 체크리스트
아래 항목을 모두 충족해야 프로모션을 진행할 수 있어요.
□ 지급하는 포인트가 **1인당 5,000포인트 이하**인가요?\
□ 지급 조건, 지급 시점, 지급 제한을 명확히 안내했나요?\
□ 참여 방식이 단순하고, 시간이나 노동을 많이 요구하지 않나요?\
□ (게임의 경우) 룰렛·뽑기 등 확률형 요소와 결합되지 않았나요?\
□ 지급하는 포인트가 게임 결과나 등수를 기준으로 정해지지 않나요?\
□ 사용자가 가진 재화를 토스 포인트로 교환·전환해 주는 형태는 아닌가요?\
□ 프로모션이 일찍 끝나거나 중단될 수 있다는 점을 미리 안내했나요?\
□ 중복 참여 방지 로직을 적용했나요?\
□ 사행성이 있거나 과장된 프로모션은 아닌가요?
프로모션 정보를 입력한 뒤 \[검토 요청하기]를 눌러 주세요. 검토는 **영업일 기준 2\~3일** 걸려요.
***
### 개발 연동하기
게임·비게임 미니앱에서 토스 포인트를 지급하는 [SDK 함수와 서버 API 연동 방법](https://developers-apps-in-toss.toss.im/documentation/common/growth/promotion#undefined-5)을 확인할 수 있어요.
프로모션을 안내할 때는 아래 정보를 꼭 알려주세요.
* 지급 시점 (예: 즉시 지급, 다음 날 18시 지급 등)
* 지급 조건 (예: 최초 결제, 5,000원 이상 결제 등)
* 지급 제한 (탈퇴·환불·부정 참여 시 지급 불가)
* "이 프로모션은 사전 고지 없이 중단될 수 있어요" 문구 포함
* 랜덤 지급 불가 (고정 지급만 허용)
***
### 테스트 진행하기
검토가 끝나면 '테스트하기'로 테스트를 진행해 주세요. 테스트할 때는 실제 포인트가 차감되지 않아요.
* 테스트 프로모션 코드는 실제 코드 앞에 `TEST_`가 붙어요.
* 테스트할 때는 포인트가 차감되지 않고, 실제 지급도 되지 않아요.
* 포인트 지급 API를 호출할 때 `resultType`이 `SUCCESS`로 응답되는지 확인해 주세요.
* 검토가 끝난 뒤 포인트 지급 API 테스트를 최소 1번 완료해야, 프로모션을 시작할 수 있어요.
***
### 프로모션 시작 및 운영하기
'시작하기' 버튼을 눌러 프로모션을 시작해 보세요.
* 예산 열은 `실제 소진 금액 / 총 예산` 형태로 표시돼, 예산이 얼마나 소진됐는지 확인할 수 있어요.
* 프로모션 수정은 주로 예산을 늘릴 때 써요.
* 프로모션이 끝나면 남은 예산은 비즈 월렛으로 환급돼요.
* 예산이 다 소진되면 혜택 탭에 더 이상 노출되지 않아요. 예산을 주기적으로 관리해 주세요.
캠페인 이름을 누르면 프로모션 상세 정보를 확인하고, 수정·종료·일시정지를 할 수 있어요.
* **수정하기:** 주로 예산을 늘릴 때 써요. 예산을 늘리려면 캠페인 상세 → 프로모션 수정 버튼 → 늘릴 금액 입력 → 저장 순으로 진행해 주세요. 예산 외 설정을 바꾸려면 내부 정책상 제한이 있을 수 있으니, 검토 가이드라인을 먼저 확인해 주세요.
* **종료하기:** 프로모션이 끝나면 남은 예산은 자동으로 비즈 월렛으로 환급돼요. 환급 금액은 종료 후 바로 반영될 때가 많지만, 시스템 처리 때문에 조금 늦어질 수 있어요. 예산을 자주 확인해서, 예산 소진으로 프로모션이 자동 종료되지 않게 해주세요.
***
### 성과 확인하기
프로모션을 시작하면, 그 프로모션의 성과를 대시보드에서 확인할 수 있어요. 대시보드는 프로모션이 얼마나 효과적이었는지 한눈에 보여주고, 다음 캠페인 전략을 개선하는 데 도움을 줘요.
**혜택 탭에 노출하지 않은 프로모션은 성과 대시보드에 표시되지 않아요.**
#### **기간 설정 및 조회 조건**
성과 데이터는 여러 기준으로 조회할 수 있어요. 분석 목적에 맞게 조건을 바꿔가며 살펴보면 좋아요.
* **일별·주별·월별** 단위로 데이터를 조회할 수 있어요.
* **운영체제(OS)별**로 나눠서 성과를 확인할 수 있어요.
* 지금 미니앱에서 운영 중인 전체 프로모션과 개별 프로모션을 구분해서 조회할 수 있어요.
프로모션 성과 대시보드에서는 사용자가 프로모션에 참여하는 흐름을 단계별로 확인할 수 있어요. 이 흐름을 보면 **최종 전환율**을 알 수 있고, 어느 단계에서 사용자가 많이 이탈하는지도 파악할 수 있어요.
1. **혜택 탭 진입:** 토스 앱의 혜택 탭에 이 프로모션이 노출되고, 이를 본 사용자 수예요.
2. **프로모션 클릭:** 혜택 탭에서 프로모션을 실제로 눌러 상세 화면으로 들어온 사용자 수예요. 혜택 탭 진입 대비 클릭 수를 보면, 프로모션 제목이나 썸네일이 사용자의 관심을 얼마나 끌었는지 알 수 있어요.
3. **포인트 획득:** 프로모션 조건을 채우고 토스 포인트를 실제로 받은 사용자 수예요. 조건이 어렵거나 과정이 복잡하면, 이 단계에서 많이 이탈할 수 있어요.
프로모션으로 유입된 사용자를 성격에 따라 나눠서 성과를 확인할 수 있어요.
* **신규 사용자:** 프로모션을 계기로 미니앱에 처음 들어온 사용자예요.
* **기존 사용자:** 예전에 미니앱을 이용한 적이 있는 사용자예요.
프로모션이 실제 매출에 얼마나 기여했는지도 확인할 수 있어요. 다만 기여 매출은 워크스페이스(사업자 번호) 단위로만 조회할 수 있고, 미니앱별로는 조회할 수 없어요.
* **총 기여 매출:** 프로모션으로 유입된 사용자들이 발생시킨 전체 매출이에요.
* **결제자 기준 1인당 평균 매출:** 프로모션으로 유입된 사용자 중 **실제로 결제한 사용자만**을 기준으로 계산한 평균 매출이에요.
* **전체 사용자 기준 1인당 평균 매출:** 결제 여부와 관계없이 **프로모션으로 유입된 전체 사용자**를 기준으로 계산한 평균 매출이에요.
***
### 자주 묻는 질문
모든 프로모션에 1인당 5천 포인트 제한이 있나요?
네, 맞아요. 가입/거래/이벤트/친구 초대 등 **모든 프로모션 유형은 원칙적으로 1인당 최대 5천 포인트 미만까지만 지급** 가능해요.
추첨이나 랜덤 지급 이벤트는 가능한가요?
(게임 앱의 경우) 불가해요. 확률형·룰렛·랜덤 뽑기 방식은 **사행행위로 해석될 위험**이 있어 허용되지 않아요.
**고정형 지급**만 허용돼요. (예: "첫 가입 시 500 포인트 지급")
게임 내 점수/승패/등수에 따라 포인트를 지급할 수 있나요?
불가해요. 관련 법령에 따라 게임 결과와 현금성 보상을 직접 연결하는 것은 **사행성 유도 행위**로 금지되어 있어요.
게임 앱의 경우 **게임 결과와 무관한 조건**(가입, 로그인, 튜토리얼 완료 등)으로만 프로모션 운영이 가능해요.
기프티콘·상품권을 토스 포인트로 교환해줄 수 있나요?
불가해요. 유저가 보유한 재화를 환전해 주는 리워드는 자금 세탁 등의 우려로 진행이 불가해요.
토스 포인트 지급은 반드시 앱 내 특정 행동(가입, 결제, 이벤트 참여 등)을 기반으로 운영되어야 해요.
포인트 지급 시점은 어떻게 정해야 하나요?
실제 지급되는 시점은 자체적으로 판단하시되, 반드시 **유저에게 프로모션 참여 전 사전 고지**해야 해요.
예: "이벤트 참여 후 즉시 지급" / "익일 18시까지 지급돼요" 등
프로모션을 도중에 중단할 수 있나요?
예산 초과 등의 사유 외에는 중단을 권장하지 않아요. 특히, 특정 행동을 달성해야 포인트를 지급받는 경우 유저가 종료 사실을 인지하지 못했을 수 있어요.
프로모션 진행 시 **"본 프로모션은 사전 고지 없이 중단될 수 있습니다"** 문구를 반드시 포함해 주세요.
친구 초대 보상은 어떻게 설계해야 하나요?
초대한 사람과 초대받은 사람 모두에게 동일한 보상 제공이 가능해야 해요.**중복 참여·어뷰징 방지 로직**이 필수로 적용되어야 해요.보상 한도는 1인당 최대 5천 포인트가 동일하게 적용돼요.
포인트 대신 현금을 지급해도 되나요?
불가해요. 현금 지급 또는 "입금 시 +N% 보장" 형태는 **유사수신행위·사행성 행위**로 법 위반 소지가 있어요.
반드시 **토스 포인트** 형태로만 지급해야 해요.
---
# 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://developers-apps-in-toss.toss.im/guide/marketing/promotion.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.