환불 정책 및 블랙리스트
문서 정보
- 작성일: 2026-04-14
- 버전: v2.0.0
단건결제 환불은 캐시 회수 부족분을 원화 debt로 누적하고, 정기결제 환불은 부당환불 strike를 누적합니다. debt가 10만원 이상이거나 strike가 라이프타임 3회 이상이면 블랙리스트로 전환됩니다. 블랙리스트 효과는 양쪽 모두 동일합니다 — API 전역 차단 + 강제 로그아웃 + MyKok soft delete + 30일 유예 후 hard delete.
환불 절차
인앱결제 환불은 사용자가 Apple 또는 Google에 직접 요청합니다. 서버는 이 결정에 개입할 수 없습니다.
Apple/Google이 환불을 승인하면 사용자는 이미 돈을 돌려받습니다. 서버는 Webhook으로 "환불이 됐다"는 통보만 받을 뿐, 환불 자체를 막을 수 없 습니다. 따라서 블랙리스트는 예방이 아닌 사후 추적 + 미래 이용 차단 목적입니다.
환불 처리 방식 (FIFO)
서버는 환불이 발생하면 FIFO(First In, First Out) 방식으로 캐시를 회수합니다.
FIFO란?
캐시는 충전된 순서대로 소비됩니다. 만료일이 가장 빠른 캐시부터 차감됩니다. 인앱결제로 충전한 캐시는 충전 후 60개월 뒤 만료이므로, 일반적으로 기존 캐시보다 나중에 소비됩니다.
예시: 기존 캐시 캐시 5,000 (만료 2031-01) + 인앱결제 캐시 10,000 (만료 2031-04) 보유 시, 캐시를 소비하면 기존 캐시부터 먼저 차감됩니다.
환불 처리 순서
- 인앱결제로 충전된 캐시 아이템을 비활성화하여 남은 잔량 회수
- 원래 지급한 캐시보다 회수량이 적다면 (부족분 발생) → 다른 캐시에서 FIFO 차감 시도
- 다른 캐시에서도 보충 불가능하다면 → 부족분을 원화로 누적 (부채)
3가지 환불 결과
| 결과 | 조건 | 블랙리스트 누적 |
|---|---|---|
| 정상 회수 | 인앱결제 캐시가 아직 사용되지 않았거나 FIFO 덕분에 원본 캐시가 그대로임 | 없음 |
| FIFO 차감 | 인앱결제 캐시가 일부 소비됐지만 다른 캐시 잔액으로 부족분 보충 가능 | 없음 |
| 부채 누적 | 인앱결제 캐시가 소비됐고 다른 캐시도 부족하여 보충 불가 | 누적됨 |
정상 회수 (FIFO 보호 효과)
인앱결제 캐시는 가장 나중에 만료되므로, FIFO 소비 순서상 마지막에 차감됩니다. 사용자가 일반적인 패턴으로 캐시를 사용했다면, 기존 캐시가 먼저 줄어들고 인앱결제 캐시는 그대로 남아있을 가능성이 높습니다.
이 경우 환불 시 인앱결제 캐시만 회수하면 전액 복구가 가능합니다.
예시:
- 기존 캐시 캐시 20,000 + 인앱결제 캐시 10,000 보유
- 캐시 캐시 4,000 사용 → 기존 캐시에서만 차감
- 인앱결제 환불 → 인앱결제 캐시 캐시 10,000 전액 회수 가능
FIFO 차감 환불
인앱결제 캐시가 일부 소비된 상태에서 환불이 발생하면, 부족분을 다른 캐시 잔액에서 보충합니다.
예시:
- 인앱결제 캐시 5,000 충전 (캐시 5,000 남음)
- 캐시 캐시 4,000 사용 → 인앱결제 캐시 캐시 1,000만 남음
- 다른 캐시 잔액 캐시 10,000 보유
- 인앱결제 환불 시: 인앱결제 캐시 캐시 1,000 회수 + 다른 캐시에서 캐시 4,000 추가 차감 = 캐시 5,000 전액 회수
이 경우 캐시를 실제로 사용했음에도 그 금액을 다른 잔액에서 보충하여 환불이 처리됩니다. 부채 누적은 없지만 다른 캐시 잔액이 줄어듭니다.
부채 누적 및 블랙리스트
부채 누적 조건
인앱결제 캐시를 모두 소비했고, 다른 캐시 잔액도 부족하여 환불 금액을 전액 회수할 수 없는 경우 부족분이 원화로 환산되어 부채로 누적됩니다.
부채 계산 공식: 부족 캐시량 × (상품 원화 가격 / 캐시 지급량)
예시: 캐시 5,000 상품(₩5,000) 구매 후 전부 사용, 다른 잔액 없음 → 환불 시 회수 불가 캐시 5,000 → 부채 ₩5,000 누적
블랙리스트 전환
누적 부채가 ₩100,000 이상이 되면 해당 전화번호가 블랙리스트에 등록됩니다.
| 누적 부채 | 상태 |
|---|---|
| ₩0 ~ ₩99,999 | 정상 (부채 추적 중) |
| ₩100,000 이상 | 블랙리스트 전환 |
블랙리스트는 전화번호를 기준으로 관리됩니다. 계정을 탈퇴하고 재가입하더라도 동일한 전화번호로 인증하면 블랙리스트가 유지됩니다.
블랙리스트 효과
블랙리스트 사용자는 3가지 레이어에서 차단됩니다.
| 차단 레이어 | 설명 |
|---|---|
| 로그인 차단 | 신규 로그인 시도 시 403 오류 반환, 토큰 발급 불가 |
| 전체 API 차단 | 기존 로그인 세션으로 모든 API 요청 차단, 앱 사용 불가 |
| 인앱결제 차단 | 스토어 결제 성공해도 서버에서 캐시 미지급 |
블랙리스트 전환 시 해당 사용자의 모든 기기에서 자동으로 로그아웃됩니다. 재로그인 시도 시 즉시 차단됩니다.
환불 가능 여부 판정
정기결제 환불: strike 누적 방식
정기결제(IAP 구독) 환불은 캐시 회수가 아닌 부당환불 횟수(strike) 누적 방식으로 처리합니다. 구독은 "기간 혜택"이라 소비분의 원화 환산이 애매하므로, 부당환불 판정 횟수를 직접 카운트합니다.
부당환불 자동 판정
UnjustRefundDetectorService가 기존 RefundEligibilityService(Pass 도메인)를 재사용하여 환불이 부당한지 자동 판정합니다.
| 판정 코드 | 판정 조건 | strike |
|---|---|---|
UNJUST_OUT_OF_WINDOW | 결제일로부터 7일 초과 후 환불 | +1 |
UNJUST_BENEFIT_CONSUMED | Subscription.refundable = false 상태에서 환불 (혜택 소비 후) | +1 |
| 해당 없음 (정당 환불) | 위 두 조건 모두 미해당 | 없음 |
두 조건 중 하나라도 해당하면 unjust: true로 판정하고 strike를 1 증가시킵니다. 정당한 환불(규정 준수)은 strike를 증가시키지 않습니다.
strike 누적 및 블랙리스트 전환
| 누적 strike | 상태 |
|---|---|
| 0 ~ 2회 | 정상 (strike 추적 중) |
| 3회 이상 | 블랙리스트 전환 |
strike는 라이프타임 누적입니다. 계정 탈퇴 후 재가입해도 동일 전화번호로 인증하면 누적 횟수가 유지됩니다.
통합 블랙리스트 효과
단건결제 debt 기반이든 정기결제 strike 기반이든, 블랙리스트 전환 시 동일한 효과가 적용됩니다.
전환 조건 (OR 결합):
isBlacklisted = (accumulatedDebt >= ₩100,000) OR (unjustRefundCount >= 3)
전환 즉시 적용 효과
| 레이어 | 처리 내용 |
|---|---|
| 로그인 차단 | 신규 로그인 시 403 반환, 토큰 발급 불가 |
| 전체 API 차단 | 기존 세션의 모든 API 요청 차단 |
| 인앱결제 차단 | 스토어 결제 성공해도 서버에서 캐시/구독 미처리 |
| 강제 로그아웃 | 모든 기기 토큰 삭제 |
| Subscription 종료 | 활성 구독 CANCELED 전환, expiresAt=now |
| MyKok soft delete | MyKok.deletedAt=now (즉시 접근 불가, DB에는 유지) |
30일 유예 후 hard delete
블랙리스트 전환 시 scheduledHardDeleteAt = now + 30일이 설정됩니다. BlacklistHardDeleteScheduler가 매일 KST 03:00에 실행되어 유예 기간이 지난 대상을 처리합니다.
30일 유예 기간 내에 이의제기를 승인받지 못하면 MyKok 데이터가 영구 삭제됩니다. 이의제기는 hard delete 실행 전에만 가능합니다.
이의제기 프로세스
블랙리스트 처리에 이의가 있는 사용자는 CS를 통해 어드민 검토를 요청할 수 있습니다.
어드민 API: POST /admins/iap-blacklist/:uuid/appeal
어드민이 이의제기를 승인하면 다음 효과가 즉시 적용됩니다.
| 항목 | 처리 내용 |
|---|---|
| 블랙리스트 해제 | isBlacklisted=false, scheduledHardDeleteAt=null |
| strike 감면 | unjustRefundCount = max(0, current - 1) (완전 리셋이 아닌 -1) |
| MyKok 복원 | MyKok.deletedAt=null (soft delete 복원) |
| 구독/Entitlement | 복원하지 않음 — 사용자가 재구독해야 함 |
hard delete(isDataHardDeleted=true) 이후에는 MyKok 데이터가 이미 삭제되어 복원 불가능합니다. 이의제기는 반드시 블랙리스트 전환 후 30일 이내에 처리해야 합니다.
관련 문서
- 인앱결제 시스템 개요 — 전체 결제 흐름과 RevenueCat 역할
- 인앱 정기결제 — 정기결제 개요, 웹훅 이벤트 라우팅
- CS 자주 묻는 질문 — 환불·블랙리스트 관련 CS 대응 가이드
- 시나리오 가이드 — 환불 시나리오 상세
변경 이력
| 버전 | 날짜 | 변경 내용 |
|---|---|---|
| v2.0.0 | 2026-04-20 | 정기결제 strike 및 통합 블랙리스트 정책 추가 - TL;DR 업데이트: 단건/정기 통합 설명 - 정기결제 환불 strike 누적 방식 섹션 신규 - 통합 블랙리스트 효과 섹션 신규 (MyKok soft delete + 30일 hard delete) - 이의제기 프로세스 섹션 신규 |
| v1.0.0 | 2026-04-14 | 초기 문서 작성 — 단건결제 FIFO 환불 + debt 기반 블랙리스트 |