KappS 지식 베이스 · 블로그

Google Play 구독 기본 요금제 및 혜택

블로그 튜토리얼

Google Play 구독자가 실제로 지불하는 금액을 결정하는 두 가지 질문이 있고, 그 답은 서로 다른 두 곳에 있습니다. 기본 요금제는 "어떤 결제 주기로, 어떤 가격에, 자동 갱신인지 선불인지?"를 답합니다. 혜택은 "누가 더 저렴하게 시작할 자격이 있고, 얼마 동안인가?"를 답합니다. 구독 혜택을 잘못 모델링하면 무료 체험을 요청하는 모든 마케팅 요구가 완전히 새로운 구독 상품이 되어버립니다. 그러면 카탈로그가 파편화되고, 한 번이라도 구매가 발생하면 삭제할 수 없는 상품들 사이로 리포팅이 쪼개지며, 클라이언트에는 아무도 손대기 두려워하는 구매 로직이 남습니다.

이 튜토리얼은 Play Console과 결제 라이브러리가 실제로 요구하는 순서를 따릅니다. 상품을 생성하고, 기본 요금제를 구성하고, 자격 조건이 있는 혜택을 추가하고, 클라이언트에서 혜택 토큰을 읽고, 올바른 교체 모드로 요금제 변경을 처리한 다음, 서버에서 이용 권한을 검증합니다. 이 과정에서 팀이 반복적으로 걸려 넘어지는 세 가지가 있습니다. 클라이언트가 명시적으로 전달해야 하는 혜택 토큰, 업그레이드 시 선택하는 비례 배분 모드, 무료 체험이 실제인지 판단하는 서버 검증입니다. 마지막 섹션에서는 출시 후에야 나타나는 함정을 다룹니다. 지역별 가격 격차, 절대 표시될 수 없는 혜택, 그리고 조용히 두 번째 기본 요금제가 되어버리는 가격 변경입니다.


1. 3계층 모델: 상품, 기본 요금제, 오퍼

Google Play 구독은 세 개의 레이어로 구성되며, 각 레이어의 수명은 완전히 다릅니다. 바로 이 점이 오늘의 결정을 2년 후에도 변경할 수 있는지를 결정합니다.

  • Product — 상품 ID로 식별되는 카탈로그 항목입니다. ID cannot be changed는 생성 후 변경할 수 없으며, 누구든 구매한 상품은 cannot be deleted 삭제할 수 없고 비활성화만 가능합니다. 이번 분기에 진행하는 프로모션이 아니라 상품의 본질을 기준으로 첫날부터 이름을 정하세요. "first_month_half_price"는 일시적인 아이디어에 붙은 영구 ID가 됩니다.
  • 기본 요금제 — 실제로 경제성을 결정하는 계층입니다. 결제 기간(주간, 월간, 3개월, 6개월, 연간), 갱신 유형(자동 갱신 또는 선불), 국가별 가격, 그리고 유예 기간과 계정 보류 동작이 포함됩니다. 하나의 상품에 여러 기본 요금제를 둘 수 있으며, 바로 이 방식으로 두 번째 상품 없이 월간과 연간을 나란히 판매합니다.
  • 오퍼 — 하나의 기본 요금제에 붙는 가격 조건: 무료 체험, 도입 가격, 재참여 유도 할인. 각 오퍼에는 자격 조건이 있으며, 자격을 갖춘 사용자에게만 노출됩니다.

꼭 기억해 둘 기술적 결과가 하나 있습니다. 클라이언트가 구매에 사용하는 offerToken은 특정 "기본 요금제 + 혜택" 조합에 대한 자격 증명입니다. 상품에 기본 요금제가 둘 이상이거나 혜택이 하나라도 있으면 토큰을 반드시 명시적으로 전달해야 하며, 기본값은 없습니다. 5장에서 이 규칙이 단순 상식이 아니라 실제 크래시를 설명하는 대목이 시작됩니다.

2. 1단계 — 구독 상품 만들기

Play Console에서 Play로 수익화 → 제품 → 구독으로 이동해 구독을 생성하세요. 이 단계는 네 가지 일을 하며, 각각은 되돌릴 수 없거나 나중에 큰 비용이 됩니다.

  1. 제품 ID — 소문자, 숫자, 밑줄로 구성되며 앱 내에서 고유하고 변경 불가이며, 삭제 후에도 재사용할 수 없습니다. 이름을 바꾸려면 새 제품을 만들어야 하므로 새 ID와 새 구매 경로가 생깁니다.
  2. 이름 — 콘솔에서 해당 행을 식별하기 위한 항목입니다. 구매자가 구매 화면에서 보는 내용은 Play가 기본 플랜과 오퍼를 바탕으로 생성합니다.
  3. 설명 및 혜택 — 구독에 포함되는 내용. 이 텍스트는 일부 스토어 화면에 표시되며, 고객 지원에서 다시 인용하는 내용이기도 합니다.
  4. 저장 — 초안이 저장되었습니다. 상품은 기본 요금제가 하나 이상 존재하고 활성화되어야만 구매 가능해집니다.

가장 흔한 구조적 실수는 월간과 연간을 별도 상품으로 만드는 것입니다. 그러면 구매 흐름 두 개, 상태 두 세트, 취소 경로 두 개를 유지해야 합니다. 반면 Play는 두 가지를 하나의 상품 아래 기본 요금제로 두도록 설계되었습니다. 나중에 옮기기는 고통스러우니 처음부터 제대로 하세요.

3. 2단계 — 기본 요금제 구성

기본 요금제는 구독의 수익 구조가 결정되는 곳입니다. 모든 상품에는 최소 하나가 필요하며, 대부분은 두 개(월간 및 연간)가 필요합니다.

먼저 갱신 유형을 선택하세요. 자동 갱신 기본 요금제는 각 기간이 끝날 때 다시 청구되며, 대부분의 콘텐츠 및 유틸리티 구독에 필요한 방식입니다. 선불 기본 요금제는 정해진 한 기간을 미리 판매하고, 기간이 끝나면 사용자가 다시 충전해야 합니다. 저가 시장과 반복 청구를 원하지 않는 사용자에게 적합합니다. 두 방식은 섞을 수 없습니다. 선불 요금제에는 갱신 주기도, 유예 기간 개념도 없으며, 무료 체험을 제공할 수 없습니다. 무료 체험이 성장 계획의 일부라면 기본 요금제는 자동 갱신 방식이어야 합니다.

그다음 기간과 가격을 설정하세요. 기간은 청구 주기를 정하며, 가격은 국가 및 지역별로 입력합니다. 이는 지원 문의의 가장 확실한 원인입니다. Play에서는 일부 국가에만 가격을 책정할 수 있으며, 가격이 없는 국가에서는 구매가 불가능합니다. 해당 국가의 구매자는 "해당 국가에서 판매하지 않는 상품입니다"라는 메시지를 보게 되는데, 구매자에게는 버그처럼 보이고 콘솔에서는 아무것도 아닌 것처럼 보입니다. 출시 전에 모든 타깃 마켓을 채우고 표시 가격이 현지 세금 표시 규정을 충족하는지 확인하세요.

마지막으로 수명 주기 설정 — 결제가 성공할 때가 아니라 실패할 때 무슨 일이 일어나는지를 결정합니다:

  • 유예 기간 — 결제 실패 후에도 사용자가 이용 권한을 유지하는 기간으로, 결제 수단을 수정할 시간을 벌어 줍니다.
  • 계정 보류 — 유예 기간이 끝나도 미납 상태이면 이용 권한은 정지되지만 구독 기록은 유지되어, 나중에 결제하면 복원됩니다.
  • 재구독 — 취소한 사용자가 구매 절차를 다시 거치지 않고 같은 요금제로 돌아올 수 있습니다.

여기서 기본값이 항상 정답은 아닙니다. 유틸리티 앱은 보통 유예 기간과 계정 보류를 원하고, 콘텐츠 앱은 더 빠른 다운그레이드를 선호할 수 있습니다. 어느 쪽을 선택하든 서버 측 매핑이 일치해야 합니다. 구독 상태 API가 유예 기간과 계정 보류를 구분하기 때문입니다. 둘을 모두 "유효"로 처리하면 그 정보를 잃게 됩니다.

4. 3단계 — 혜택과 자격 요건 추가하기

오퍼는 전환을 이끄는 핵심 수단이자 가장 자주 잘못 설정되는 계층입니다. 모든 오퍼에는 세 가지가 필요합니다. 오퍼 ID, 하나 이상의 단계, 그리고 자격 조건입니다.

단계는 프로모션의 시간 흐름을 결정합니다. 단계는 무료 체험(가격 0, 일수 지정) 또는 할인 가격(지정 금액으로 일정 기간) 중 하나입니다. 단계는 중첩할 수 있습니다. 예를 들어 "7일 무료, 이후 첫 달 50% 할인"처럼 구성할 수 있죠. 다만 단계 순서는 사용자가 실제로 결제하는 순서이므로, 이를 뒤집으면 먼저 결제하고 나중에 무료로 제공하는 셈이 되어 고객 문의와 심사 질문을 동시에 불러옵니다.

자격 요건은 누가 오퍼를 볼 수 있는지를 결정하는 스위치입니다. Play는 세 가지 조건을 제시합니다:

  • 신규 구독자 — 이 상품을 한 번도 구독한 적이 없음. 무료 체험의 일반적인 조건입니다.
  • 업그레이드 — 현재 업그레이드 대상으로 해당하는 다른 구독을 보유 중입니다.
  • 재참여 유도 — 이전에 구독했다가 취소하거나 만료된 이용자. 일괄 쿠폰보다 훨씬 정교하며, 신규 이용자가 보는 가격을 오염시키지 않습니다.

오퍼 태그는 단순한 장식이 아닙니다. 구매와 함께 전달되며, 나중에 자체 리포팅과 서버 로직에서 체험판 전환과 정가 구매를 구분할 수 있는 유일하게 깔끔한 방법입니다. 이를 건너뛰면 석 달 뒤에는 체험판 사용자가 실제로 유지됐는지조차 답할 수 없게 됩니다.

오퍼는 신규 구매에만 영향을 줍니다. 오퍼를 수정하거나 비활성화해도 이미 해당 오퍼에 속한 구독자의 결제에는 변화가 없습니다. 반대로 기존 구독자에게 새 가격을 적용하려면 또 다른 오퍼가 아니라 가격 변경 절차가 필요합니다.

두 가지 경계를 기록해 둘 만합니다. 각 기본 요금제는 제한된 수의 오퍼만 담을 수 있으므로 프로모션은 끝없이 만들기보다 재사용해야 합니다. 그리고 기본 요금제 자체가 비활성이면 그 아래 모든 오퍼는 판매할 수 없습니다. 오퍼가 "표시되지 않을" 때는 기본 요금제 상태를 먼저, 자격 요건을 두 번째로, 클라이언트 코드를 마지막으로 확인하세요.

5. 4단계 — 클라이언트에서 올바른 오퍼 토큰 읽기

상품 상세 정보는 단일 가격이 아니라 list를 반환합니다. 구독을 조회하면 subscriptionOfferDetails가 반환되며, 각 항목은 하나의 '기본 플랜 + 오퍼' 조합으로 basePlanId, offerId(비어 있을 수 있으며 기본 플랜의 정가 경로를 의미), offerToken을 포함합니다.

구매란 해당 목록의 항목 하나를 결제 흐름에 명시적으로 넘기는 것입니다. 구매용 ProductDetailsParams를 만들고 선택한 offerToken을 설정하세요. 규칙은 간단하고, 어기면 즉시 대가를 치르게 됩니다.

  • 기본 요금제 하나와 오퍼 없음 — 토큰은 생략할 수 있지만 라이브러리 버전 전반에서 명시적으로 전달하는 편이 더 안전합니다.
  • 기본 요금제가 여러 개이거나 프로모션이 있는 경우 — 토큰을 누락하면 결제가 실패합니다. 이것이 바로 "월간은 되는데 연간은 오류가 난다"는 전형적인 문제의 근본 원인입니다.
  • UI에 표시되는 가격은 선택한 항목에서 가져와야 하며, 목록의 첫 번째 요소에서 가져오면 안 됩니다. $4.99을 표시하면서 $49.99을 청구하는 것이 이 글에서 가장 값비싼 버그입니다.

목록 순서를 신뢰하지 말고 선택 규칙을 명시하세요. 인식 가능한 basePlanId로 기본 요금제를 찾은 다음, 반환된 목록에 실제로 포함된 것 중 우선순위가 가장 높은 혜택을 선택하고, 이용 가능한 혜택이 없으면 기본 요금제의 정가 항목으로 대체하세요. 자격 판정은 Play의 몫입니다. 받은 목록은 이미 '이 사용자가 지금 구매할 수 있는 항목'이므로, 자격 규칙을 직접 다시 구현해 추측하지 마세요.

테스트 중에는 라이선스 테스트 계정을 사용하고, 자격 요건은 테스터에게도 적용된다는 점을 기억하세요. 이미 구독한 계정에는 신규 구독자 오퍼가 표시되지 않습니다. 이는 정상 동작이며 코드 오류가 아닙니다. 체험판 렌더링을 확인하려면 새 계정이 가장 빠른 방법입니다.

6. 5단계 — 업그레이드, 다운그레이드 및 교체 모드

사용자를 월간에서 연간으로, 또는 기본 등급에서 프리미엄 등급으로 옮기는 것은 두 번째 구매가 아니라 교체입니다. 이 교체가 어떻게 작동하는지는 교체 모드에 따라 결정되며, 잘못 선택하면 사용자에게 이중 청구하거나 한 기간 동안 수익을 놓치게 됩니다.

  • 시간 비례 정산 — 즉시 적용되며 기존 구독의 잔여 가치를 새 구독에 대입해, 사용자가 지금 차액을 결제합니다.
  • 비례 배분 가격 청구 — 즉시 적용되며 비례 배분된 금액을 한 번에 청구합니다. 주로 다운그레이드 시 사용자가 먼저 이용하고 나중에 정산하는 일을 막기 위해 씁니다.
  • 정가 전액 청구 — 새 요금제 정가가 즉시 적용되고 남은 기간에 대한 차감은 없습니다. 분할 정산 비용보다 걸린 금액이 적을 때만 합리적입니다.
  • 일할 계산 없음 — 즉시 적용되며, 새 구독은 다음 주기부터 청구되고 이전 기간의 남은 부분은 그대로 소멸합니다. 사용자에게 가장 친절하고 수익에는 가장 불리하며, 다운그레이드에 합리적인 기본값입니다.

Billing Library 8에서는 진입점이 setSubscriptionReplacementMode로 통합되었으며, 이전 라이브러리 버전의 메서드 이름은 지원 종료되었습니다. 코드에서 여전히 이를 호출한다면 컴파일 오류가 오히려 선물입니다. 배포 도중 의미가 다르다는 사실을 발견하는 것보다 훨씬 저렴하니까요.

선불 기본 요금제는 교체 대상이 아닙니다. 갱신 주기가 없고 자체 일정에 따라 만료되기 때문입니다. "월간을 연간으로 전환" 안내가 있다면 선불 이용자는 반드시 제외해야 합니다. 그렇지 않으면 절대 완료될 수 없는 버튼을 보여주게 됩니다.

순서 규칙이 하나 있습니다. 교체 요청은 실패하거나 적용되거나 둘 중 하나이며, 일부만 적용되는 일은 없습니다. 따라서 요청을 보내기 전에 클라이언트에서 로컬 권한을 부여하지 말고, 서버가 새 구매 자격 증명을 보유할 때까지 기다렸다가 잠금을 해제하세요.

7. 6단계 — 서버에서 검증하고 확인 응답하기

클라이언트가 돌려주는 것은 "사용자가 구매했다고 합니다"뿐입니다. 권한 부여는 서버 측에서 결정됩니다. 구매 토큰으로 구독 조회(purchases.subscriptionsv2)를 호출해 권위 있는 상태와 만료일을 가져오고, 이를 자체 권한 부여 테이블에 기록하세요.

상태 필드는 사용자가 어느 세그먼트에 속하는지 알려줍니다. 활성, 유예 기간, 보류, 일시중지, 취소, 만료, 대기 중입니다. 이는 권한 부여 분기와 직접 대응합니다. 유예 기간은 보통 액세스를 유지하고, 계정 보류는 보통 액세스를 축소하며, 일시중지는 데이터를 유지하면서 서비스를 중단해야 합니다. 이 매핑을 "유효 또는 무효"로 하드코딩하면 Play가 제공하는 바로 그 구분을 버리게 됩니다.

그다음 놓치기 쉬운 두 가지 작업이 있습니다. 3일 이내에 구매를 확인하지 않으면 자동으로 환불됩니다. 클라이언트를 신뢰하기보다 서버에서 처리하는 편이 더 안정적입니다. 그리고 실시간 개발자 알림을 연결해 갱신, 취소, 유예 기간 진입, 복구, 가격 변경 확인이 전달되도록 하세요. 알림은 확인하라는 신호일 뿐 최종 상태가 아닙니다. 이후 전체 구독 정보를 조회하고, 메시지 ID로 중복을 제거하며, 멱등하게 처리하세요.

이 세 계층을 제대로 갖추면 순환이 완성됩니다. 클라이언트가 요청하고, 서버가 판정하며, 알림이 시의적절하게 유지합니다.

8. 출시 후에만 나타나는 함정

이러한 문제는 테스트에서는 거의 나타나지 않으며 실제 트래픽과 함께 한꺼번에 발생합니다.

  • 지역별 가격 공백 — 신규 시장이 추가되었는데 가격표가 채워지지 않아 해당 지역 구매자에게 "이용 불가"로 표시됩니다. 콘솔 표를 믿는 것보다 해당 지역 계정으로 구매 화면을 한 번 직접 확인하는 편이 낫습니다.
  • 가격을 잘못된 방식으로 변경 — 기존 기본 플랜을 수정하면 가격 변경 절차가 시작되며, 기존 구독자가 확인해야 새 가격이 적용됩니다. "기존 사용자는 기존 가격을 유지하고 신규 사용자는 새 가격을 지불한다"는 것이 목표라면, 일반적인 해법은 기존 플랜을 수정하는 것이 아니라 새 기본 플랜을 만들고 판매 항목을 바꾸는 것입니다. 가격을 건드리기 전에 어떤 결과를 원하는지 먼저 정하세요.
  • 활성 구독자가 있는 오퍼 비활성화 — 비활성화는 신규 구매만 차단하며, 기존 구독자는 기간이 끝날 때까지 해당 오퍼를 유지합니다. 버그는 아니지만, 미리 준비해 두어야 할 상담 스크립트입니다.
  • 모든 프로모션을 새 상품으로 만드는 것 — 결국 삭제할 수 없는 상품, 파편화된 리포트, 아무도 리팩터링하지 않을 클라이언트 로직만 남습니다.
  • 오퍼 태그 누락 — 태그가 없으면 체험판 전환과 직접 구매를 구분할 수 없어, 어떤 프로모션이 실제로 리텐션을 이끌었는지 알 수 없습니다.
  • 테스터에게는 보이고 사용자에게는 보이지 않음 — 자격 요건은 테스트 계정에도 적용됩니다. 깨끗한 계정으로 검증하는 것이 가장 빠른 디버깅 방법입니다.

9. KappS의 위치

구독 구성은 제품 결정이지만, 수년간 컴플라이언스를 유지해야 하는 계정 위에서 작동합니다. 결제 프로필, 세금 정보, 개발자 인증 상태가 그것입니다. 이 중 하나라도 문제가 생기면 가장 좋지 않은 시점에 수익 체인이 끊어집니다. KappS는 컴플라이언스 자료를 준비하고 제출하며 계정과 퍼블리싱 상태를 건강하게 유지하여, 이러한 전제 조건이 더 이상 변수가 되지 않도록 합니다.

  • 계정과 결제 정보의 일관성 — 개발자 신원, 결제 프로필, 실제 수취인이 일치해야 정산이 정보 불일치로 지연되지 않습니다.
  • 세금 및 지역 설정 검토 — W-8BEN/W-9, 원천징수율, 타깃 시장을 출시 전에 점검하세요. 정산이 부족하게 들어온 뒤가 아니라.
  • 설정에 대한 제2의 검토 — 기본 요금제, 혜택 적용 자격, 클라이언트 측 토큰 처리 방식이며, 특히 다중 상품·다중 지역·다중 언어 포트폴리오에서 중요합니다.

저희는 플랫폼 규칙을 우회하는 어떤 서비스도 제공하지 않습니다. 가격과 체험은 실제여야 하고, 자격 요건은 Play의 정의를 따라야 하며, 모든 결제는 서버 측 검증을 통과해야 합니다. 이것은 규칙인 동시에, 이 일이 계속 유지되는 유일한 방식입니다.

출처(Google 문서): Play Console 고객센터 — 구독, 기본 요금제, 혜택 및 자격 요건, 선불 요금제 생성 및 구성, Android Developers — Play Billing 연동, 구독 교체 모드, 서버 측 검증, 실시간 개발자 알림.

개발자 계정을 대규모로 운영하시나요? 운영 업무를 저희가 처리합니다.

클릭하여 파일 선택 · 우클릭 → 붙여넣기, 또는 Ctrl/⌘+V로 스크린샷 붙여넣기

파일을 이 상자로 끌어다 놓아도 됩니다.

입력하신 이메일로 답변드립니다. 고객님의 정보는 KappS에만 보관됩니다.

✔ 제출 완료

메시지를 접수했습니다. 24시간 이내에 답변드리겠습니다.


← 수정으로 돌아가기