리워드 시스템
문서 정보
- 작성일: 2026-02-27
- 최종 업데이트: 2026-03-12
- 버전: v1.2.0
리워드는 서비스 활동(콕 시청, 광고 시청, 출석체크 등)으로만 획득할 수 있는 보조 재화입니다. 1 리워드 = 1 캐쉬 비율로 전환하여 결제에 사용할 수 있으며, 만료일이 빠른 리워드부터 먼저 소비되는 FIFO 방식으로 운영됩니다.
목차
리워드란?
리워드는 Spoclip 서비스에서 활동을 통해서만 획득할 수 있는 보조 재화입니다.
| 항목 | 설명 |
|---|---|
| 획득 방법 | 서비스 활동 완료 시 자동 지급 |
| 구매 가능 여부 | 불가 (활동으로만 획득) |
| 사용 방법 | 캐쉬로 전환 후 결제에 사용 |
| 전환 비율 | 1 리워드 = 1 캐쉬 |
| 유효기간 | 적립일로부터 12개월 (환불 복원: 복원일로부터 12개월) |
| 최소 전환 단위 | 1 리워드 |
캐쉬는 직접 구매할 수 있는 주 재화이고, 리워드는 활동으로만 얻는 보조 재화입니다. 리워드는 단일 타입으로 운영되며, 캐쉬처럼 구매/보너스/프로모션 구분이 없습니다.
획득 경로
리워드는 다음 활동을 완료하면 자동으로 적립됩니다.
| 카테고리 | 활동 내용 | 유효기간 | 자동 차감 대상 |
|---|---|---|---|
| KOK_VIEW | 콕 시청 완료 | 12개월 | O |
| AD_VIEW | 광고 시청 | 12개월 | O |
| ATTENDANCE_CHECK | 일일 출석체크 | 12개월 | O |
| ATTENDANCE_WEEKLY_BONUS | 주간 연속 출석 보너스 | 12개월 | O |
| SHARED_KOK_VIEW | 공유 콕 시청 리워드 | 12개월 | O |
| KOK_SHARE_COMMISSION | 콕 공유 수수료 | 12개월 | O |
| MEMBERSHIP_REFUND | 멤버십 환불 리워드 복원 | 12개월 | O |
리워드 적립은 활동 보상(Activity Reward) 시스템에 의해 트리거됩니다. 사용자가 콕 시청, 광고 시청, 출석체크 등의 활동을 완료하면, 활동 보상 시스템이 리워드 적립 명령을 호출합니다.
리워드의 생애주기
리워드는 적립부터 소멸까지 다음과 같은 생애주기를 가집니다.
리워드 아이템 상태
| 상태 | 설명 |
|---|---|
| ACTIVE | 사용 가능한 상태. 잔액이 남아 있고 유효기간 이내 |
| EXHAUSTED | 잔액이 모두 소진된 상태. 사용/전환/자동차감으로 잔액이 0이 됨 |
| EXPIRED | 유효기간이 지나 만료된 상태. 배치 스케줄러가 자동 처리 |
캐쉬 전환
리워드의 가장 대표적인 사용 방법은 캐쉬로 전환하는 것입니다.
전환 규칙
| 항목 | 내용 |
|---|---|
| 전환 비율 | 1 리워드 = 1 캐쉬 (1:1) |
| 최소 전환량 | 1 리워드 |
| 전환된 캐쉬 타입 | 보너스 캐쉬 (유효기간 5년) |
| 이용 조건 | 모든 회원 |
전환 흐름
캐쉬로 전환된 리워드는 다시 리워드로 되돌릴 수 없습니다. 전환 전 신중하게 결정해주세요.
전환 예시
사용자가 보유 리워드 150개 중 100개를 캐쉬로 전환 요청
| 단계 | 리워드 잔액 | 캐쉬 잔액 변화 |
|---|---|---|
| 전환 전 | 150 리워드 | - |
| 전환 실행 | -100 리워드 | +100 캐쉬 (보너스) |
| 전환 후 | 50 리워드 | +100 캐쉬 |
FIFO 소비 방식
리워드를 사용하거나 전환할 때는 FIFO(First In, First Out) 방식으로 차감됩니다. 단, 여기서 "먼저"의 기준은 적립 순서가 아니라 만료일이 빠른 순서입니다.
차감 우선순위
- 만료일이 빠른 리워드 아이템부터 먼저 차감
- 만료일이 같 으면 먼저 생성된 아이템부터 차감
FIFO 예시
사용자가 60 리워드를 사용할 때
| 아이템 | 만료일 | 차감 전 잔액 | 차감량 | 차감 후 잔액 | 상태 변화 |
|---|---|---|---|---|---|
| 아이템 A | 3월 1일 | 30 | 30 | 0 | ACTIVE -> EXHAUSTED |
| 아이템 B | 4월 15일 | 50 | 30 | 20 | ACTIVE (유지) |
| 아이템 C | 6월 30일 | 80 | 0 | 80 | ACTIVE (유지) |
| 합계 | 160 | 60 | 100 |
만료일이 가까운 리워드부터 사용하므로, 사용자의 리워드가 만료로 소멸될 가능성을 최소화합니다.
잔액 조회
사용자는 자신의 리워드 잔액과 만료 예정 리워드를 확인할 수 있습니다.
| 조회 항목 | 설명 |
|---|---|
| 현재 잔액 | 사용 가능한 총 리워드 수량 |
| 30일 내 만료 예정 | 30일 이내에 만료되는 리워드 수량 |
연/월 기준으로 리워드 거래 내역을 조회할 수 있으며, 거래 타입(적립/사용/만료/전환)별로 필터링할 수 있습니다.
멤버십 결제와 리워드 자동 적용
사용자 설정(membership_auto_apply_reward)에 따라 멤버십 결제 시 리워드가 자동으로 차감됩니다.
적용 대상 결제
| 결제 유형 | USE 카테고리 | 설명 |
|---|---|---|
| 첫 구독 | MEMBERSHIP_SUBSCRIBE | 구독 요청 시 적용 |
| 업그레이드 | MEMBERSHIP_UPGRADE | 플랜 변경 요청 시 적용 |
| 갱신 | MEMBERSHIP_RENEWAL | 정기 결제 갱신 시 적용 |
자동 차감 대상 카테고리
아래 활동 보상으로 적립된 리워드만 멤버십 자동 차감 대상입니다.
| 대상 카테고리 | 활동 |
|---|---|
| KOK_VIEW | 콕 시청 완료 |
| AD_VIEW | 광고 시청 |
| ATTENDANCE_CHECK | 일일 출석체크 |
| ATTENDANCE_WEEKLY_BONUS | 주간 연속 출석 보너스 |
| SHARED_KOK_VIEW | 공유 콕 시청 리워드 |
| KOK_SHARE_COMMISSION | 콕 공유 수수료 |
| MEMBERSHIP_REFUND | 멤버십 환불 리워드 복원 |
모든 리워드 카테고리가 멤버십 자동 차감 대상입니다. 환불 복원(MEMBERSHIP_REFUND)으로 재적립된 리워드도 다음 멤버십 결제 시 자동 차감됩니다.
환불 시 리워드 복원
멤버십 환불 시 자동 적용되었던 리워드는 MEMBERSHIP_REFUND 카테고리로 재적립됩니다. 복원된 리워드의 유효기간은 복원일로부터 12개월입니다.
환불 복원 상세는 구독 시스템 — 리워드 자동 적용을 참조하세요.
데이터 구조
리워드 시스템은 4개의 핵심 테이블로 구성됩니다.
거래 타입 요약
| 거래 타입 | 금액 부호 | 생성되는 데이터 | 설명 |
|---|---|---|---|
| EARN | + (양수) | PointTransaction + PointItem | 새 아이템 생성 |
| USE | - (음수) | PointTransaction + PointTransactionDetail | 기존 아이템 FIFO 차감 |
| EXPIRE | - (음수) | PointTransaction + PointTransactionDetail | 만료 아이템 일괄 처리 |
| CONVERT | - (음수) | PointTransaction + PointTransactionDetail + 캐쉬 거래 | 캐쉬 전환 |
FAQ
Q: 리워드를 직접 구매할 수 있나요?
아닙니다. 리워드는 서비스 활동(콕 시청, 광고 시청, 출석체크 등)을 통해서만 획득할 수 있습니다. 직접 구매가 가능한 재화는 캐쉬입니다.
Q: 리워드의 유효기간은 얼마인가요?
모든 카테고리의 리워드는 적립일로부터 12개월 동안 유효합니다. 유효기간이 지나면 배치 스케줄러에 의해 자동으로 만료 처리됩니다.
Q: 리워드를 캐쉬로 전환하려면 조건이 있나요?
모든 회원이 리워드를 캐쉬로 전환할 수 있습니다. 최소 전환 단위는 1 리워드이며, 전환 비율은 1 리워드 = 1 캐쉬입니다.
Q: 전환된 캐쉬의 유효기간은 어떻게 되나요?
리워드에서 전환된 캐쉬는 보너스 캐쉬로 분류되며, 전환 시점으로부터 5년(60개월) 동안 유효합니다.
Q: 사용할 리워드를 직접 선택할 수 있나요?
아닙니다. 리워드 사용/전환 시에는 자동으로 만료일이 가까운 리워드부터 차감됩니다 (FIFO 방식). 이렇게 하면 리워드가 만료로 소멸될 가능성이 줄어듭니다.
Q: 멤버십 결제 시 리워드가 자동 차감되나요?
사용자 설정이 ON이면, 멤버십 결제(첫 구독/업그레이드/갱신) 시 모든 리워드가 자동 차감됩니다. 환불 복원(MEMBERSHIP_REFUND)으로 재적립된 리워드도 자동 차감 대상에 포함됩니다.
Q: 멤버십 환불 시 자동 차감된 리워드는 어떻게 되나요?
환불 시 자동 적용되었던 리워드가 MEMBERSHIP_REFUND 카테고리로 재적립됩니다. 복원된 리워드의 유효기간은 복원일로부터 12개월입니다.
Q: 리워드 잔액이 부족하면 어떻게 되나요?
잔액보다 많은 리워드를 사용하거나 전환하려고 하면 요청이 거부됩니다. 보유한 잔액 범위 내에서만 사용/전환이 가능합니다.
Q: 같은 활동에 대해 리워드가 중복 지급될 수 있나요?
아닙니다. 모든 리워드 적립에는 **멱등성 키(Idempotency Key)**가 적용되어, 동일한 활동에 대해 중복 지급이 방지됩니다. 네트워크 문제 등으로 같은 요청이 여러 번 전달되어도 1회만 처리됩니다.
관련 문서
변경 이력
| 버전 | 날짜 | 변경 내용 |
|---|---|---|
| v1.2.0 | 2026-03-12 | MEMBERSHIP_REFUND 자동 차감 대상 포함 + 미사용 카테고리 정리 - MEMBERSHIP_REFUND를 멤버십 자동 차감 대상에 추가 - 미사용 카테고리(RECORDING, WORKOUT_CONDITION, ADMIN_GRANT) 문서에서 제거 - TL;DR, 획득 경로 다이어그램, FAQ 일괄 업데이트 |
| v1.1.0 | 2026-03-12 | 리워드 자동 적용 확장 및 카테고리 업데이트 - 획득 경로에 출석체크, 주간 보너스, 공유 콕 시청, 콕 공유 수수료, 멤버십 환불 복원 추가 - 획득 경로 테이블에 유효기간 및 자동 차감 대상 여부 추가 - 멤버십 갱신 자동 차감 → 멤버십 결제 자동 적용으로 확장 (첫 구독/업그레이드/갱신) - 환불 시 리워드 복원 (MEMBERSHIP_REFUND) 섹션 추가 - FAQ 업데이트 (환불 복원 Q&A 추가) |
| v1.0.0 | 2026-02-27 | 초기 문서 작성 - 리워드 시스템 개요 및 획득 경로 정리 - 캐쉬 전환 규칙 및 흐름 설명 - FIFO 소비 방식 상세 설명 - 멤버십 갱신 자동 차감 규칙 정리 - 데이터 구조 ER 다이어그램 작성 - FAQ 8문항 작성 |