정기 결제 정보

이 주제에서는 갱신 및 만료와 같은 정기 결제 수명 주기 이벤트를 처리하는 방법을 설명합니다. 또한 프로모션을 제공하고 사용자가 자신의 정기 결제를 관리하도록 허용하는 등의 추가 정기 결제 기능도 설명합니다.

앱의 정기 결제 제품을 구성하지 않았다면 제품 생성 및 구성을 참고하세요.

정기 결제 개요

정기 결제는 지정된 기간 동안 사용자가 액세스할 수 있는 일련의 혜택을 나타냅니다. 예를 들어 정기 결제로 사용자는 음악 스트리밍 서비스에 액세스할 수 있습니다.

동일한 앱 내에서 다양한 혜택 또는 한 가지 혜택의 다양한 등급(예: '실버' 등급, '골드' 등급)을 나타내는 여러 개의 정기 결제를 만들 수 있습니다.

기본 요금제와 혜택을 통해 동일한 정기 결제 제품의 여러 구성을 만들 수 있습니다. 예를 들어 앱을 정기 결제한 적이 없는 사용자를 위한 신규 할인 혜택을 만들 수 있습니다. 마찬가지로 이미 정기 결제 중인 사용자를 위한 업그레이드 혜택을 만들 수도 있습니다.

정기 결제 제품, 기본 요금제, 혜택에 관한 자세한 내용은 Play Console 고객센터의 문서를 참고하세요.

선불 요금제 통합

선불 요금제는 만료 시 자동으로 갱신되지 않습니다. 서비스 중단 없이 정기 결제 사용 권한을 연장하려면 사용자가 동일한 정기 결제의 선불 요금제를 충전해야 합니다.

충전의 경우 원래 구매에서와 마찬가지로 결제 흐름을 시작합니다. 구매가 충전이라고 표시할 필요는 없습니다.

선불 요금제 충전은 항상 CHARGE_FULL_PRICE 대체 모드를 사용하므로 이 모드를 명시적으로 설정하지 않아도 됩니다. 사용자에게 전체 결제 기간이 즉시 청구되며 충전에 지정된 기간까지 사용 권한이 연장됩니다.

충전이 완료되면 Purchase 결과 객체의 다음 필드가 최근에 충전된 구매를 반영하도록 업데이트됩니다.

• 주문 ID
• 구매 시간
• 서명
• 구매 토큰
• 확인됨

다음 Purchase 필드에는 항상 원래 구매에 있는 것과 동일한 데이터가 포함됩니다.

• 패키지 이름
• 구매 상태
• 제품
• 자동 갱신

선불 구매 확인

자동 갱신 정기 결제와 마찬가지로 구매 후에는 선불 요금제를 확인해야 합니다. 최초 구매와 충전을 모두 확인해야 합니다. 자세한 내용은 구매 처리를 참고하세요.

선불 요금제의 기간이 짧을 수 있으므로 가능한 한 빨리 구매를 확인하는 것이 중요합니다.

기간이 1주 이상인 선불 요금제는 3일 이내에 확인해야 합니다.

기간이 1주일 미만인 선불 요금제는 요금제 기간의 절반 이내에 확인해야 합니다. 예를 들어 개발자는 1.5일 이내에 3일 선불 요금제를 확인해야 합니다.

할부 정기 결제 통합

할부 정기 결제는 사용자가 전체 정기 결제 요금을 선불로 결제하는 대신 일정 기간에 걸쳐 여러 번에 나누어 정기 결제 요금을 결제하는 정기 결제 유형입니다.

할부 정기 결제에 대한 추가 고려사항:

• 사용 가능 국가: 할부 정기 결제 기능은 브라질, 프랑스, 이탈리아, 스페인에서만 사용할 수 있습니다 (최신 사용 가능 여부는 Console에서 확인하세요).
• 가격 설정: Console에서 할부 정기 결제의 가격을 설정할 때 가격은 월별 결제 금액을 나타냅니다. 이 금액과 설정된 약정 기간을 합산하여 구매 화면에 구독의 총 금액이 생성됩니다.
• 약정 기간: 월별 요금이 청구되는 최초 구독 약정의 총 기간입니다. 예를 들어 기본 요금제에 15개월 약정 기간이 있는 경우 사용자는 이 기간 동안 15회 월별 요금을 결제합니다.
• 갱신: 분할 정기 결제의 맥락에서 '갱신'은 약정 기간(초기 약정 기간 또는 후속 약정 기간)의 종료를 의미합니다. 최초 가입 후 첫 번째 갱신은 전체 초기 약정 기간이 완료되면 이루어집니다. 후속 갱신은 각 후속 약정 기간이 완료된 후에 이루어집니다. 할부 정기 결제의 갱신 유형은 '매월 자동 갱신' 또는 '동일 기간 자동 갱신'일 수 있습니다. '매월 자동 갱신'의 경우 후속 약정이 없으며 요금제는 매월 정기 결제 요금이 갱신을 구성하는 월간 정기 결제처럼 작동합니다.
• 결제 기간: 할부 정기 결제의 맥락에서 기본 요금제에 지정된 대로 개별 결제가 이루어지는 반복 간격을 의미합니다.
• 요금제 변경과 가격 변경 동작 비교: 가격 변경 및 취소의 경우 약속은 확실합니다. 즉, 사용자가 취소하려고 하거나 개발자가 가격을 변경하려는 경우 약정 기간이 끝날 때 변경사항이 적용됩니다. 요금제 변경의 경우 약정이 확실하지 않습니다. 즉, 요금제 변경은 약정 기간이 끝날 때까지 기다릴 필요가 없으며 설정된 대체 모드에 따라 즉시 또는 다음 결제일에 적용됩니다.
• 동일한 정기 결제 요금제 변경: 동일한 정기 결제 제품의 할부 기본 요금제에서 할부 불가 기본 요금제로의 요금제 변경은 허용되지 않습니다.

• 실시간 개발자 알림 (RTDN): 사용자의 취소가 발생하면 약정 기간 동안 결제가 남아 있는 경우 SUBSCRIPTION_CANCELLATION_SCHEDULED RTDN이 즉시 전송됩니다. 취소는 대기 중이며 계약 기간이 종료될 때만 적용됩니다. 그런 다음 사용자가 복원하지 않으면 약정 기간이 끝날 때 SUBSCRIPTION_CANCELED 및 SUBSCRIPTION_EXPIRED RTDN이 전송됩니다.

• 지급 / 수익 실현: 사용자가 월별로 대금을 결제하면 개발자 판매 대금이 지급되며, 이때 다른 모든 정기 결제와 동일한 약관이 적용됩니다. 사용자가 할부 정기 결제를 신청할 때 개발자에게 선불로 지급되지 않습니다.

• 누락된 결제 수금: 사용자가 할부 정기 결제 요금을 지불하지 않으면 Google과 개발자 모두 누락되거나 미납된 요금을 사용자에게 청구하지 않습니다. 단, Google은 일반적인 결제 재시도 관행에 따라 해당하는 유예 기간 또는 계정 보류 기간 동안 주기적으로 결제를 다시 시도할 수 있습니다. Google은 개발자에게 미납된 할부 요금에 대해 책임을 지지 않습니다.

• Play 결제 라이브러리 사용 가능 여부: installmentDetails 필드는 PBL 7 이상에서만 사용할 수 있습니다. PBL 5 이상에서는 할부 구독이 queryProductDetails()를 사용하여 반환되지만 구독에는 요금제의 약정된 결제 횟수와 같은 자세한 할부 정보가 포함되지 않습니다.

딥 링크를 사용하여 사용자가 정기 결제를 관리하도록 허용

사용자가 정기 결제를 관리할 수 있는 링크를 앱의 설정 또는 환경설정 화면에 포함해야 하며 이는 앱의 자연스러운 디자인과 분위기에 통합할 수 있습니다.

만료되지 않은 정기 결제의 경우 앱에서 Google Play 정기 결제 센터로 연결되는 딥 링크를 포함할 수 있습니다. 이는 정기 결제 리소스의 subscriptionState 필드를 사용하여 확인할 수 있습니다. 이를 기반으로 Play 스토어 정기 결제 센터로 딥 링크를 설정할 수 있는 몇 가지 방법이 있습니다.

정기 결제 센터 링크

다음 URL을 사용하여 모든 정기 결제를 표시하는 페이지로 사용자를 안내합니다(그림 1, 2 참고).

https://play.google.com/store/account/subscriptions

이 딥 링크는 사용자가 Play 스토어 정기 결제 센터에서 취소된 정기 결제를 복원하는 데 유용할 수 있습니다.

특정 정기 결제 관리 페이지 링크(권장)

만료되지 않은 정기 결제의 관리 페이지에 직접 연결하려면 구매한 정기 결제와 연결된 패키지 이름과 productId를 표시합니다. 프로그래매틱 방식으로 기존 정기 결제의 productId를 확인하려면 앱의 백엔드를 쿼리하거나 BillingClient.queryPurchasesAsync()를 호출하여 특정 사용자와 연결된 정기 결제 목록을 확인합니다. 각 정기 결제에는 정기 결제 상태 정보의 일부로 상응하는 productId가 포함됩니다. 정기 결제 구매와 연결된 각 SubscriptionPurchaseLineItem 객체에는 사용자가 해당 항목에서 구매한 정기 결제와 연결된 productId 값이 포함됩니다.

다음 URL을 사용하여 사용자를 특정 정기 결제 관리 화면으로 안내합니다. 여기서 'your-sub-product-id'와 'your-app-package'를 각각 productId와 앱 패키지 이름으로 바꿉니다.

https://play.google.com/store/account/subscriptions?sku=your-sub-product-id&package=your-app-package

그러면 사용자는 결제 수단을 관리하고 취소, 정기 결제 재신청, 일시중지와 같은 기능에 액세스할 수 있습니다.

사용자가 정기 결제를 업그레이드, 다운그레이드 또는 변경할 수 있도록 허용

기존 정기 결제 사용자의 요구에 더 잘 부합하도록 정기 결제 요금제를 변경할 수 있는 다양한 옵션을 제공할 수 있습니다.

• '기본' 및 '프리미엄' 정기 결제와 같은 여러 정기 결제 등급을 판매하는 경우 사용자가 다른 정기 결제의 기본 요금제나 혜택을 구매하여 등급을 전환하도록 허용할 수 있습니다.
• 사용자가 월간 요금제에서 연간 요금제로 전환하는 등 현재 결제 기간을 변경하도록 허용할 수 있습니다.
• 사용자가 자동 갱신 요금제와 선불 요금제 간에 전환하도록 허용할 수도 있습니다.

자격요건을 충족하는 사용자에게 할인을 제공하는 정기 결제 혜택을 제공하여 이러한 변경을 유도할 수 있습니다. 예를 들어 월간 요금제에서 연간 요금제로 전환할 때 첫해에 50% 할인을 제공하는 혜택을 만들고 이 혜택을 아직 구매하지 않은 월간 요금제 사용자로 혜택을 제한할 수 있습니다. 혜택 자격 기준에 관한 자세한 내용은 고객센터를 참고하세요.

그림 3은 세 가지 요금제가 있는 앱의 예를 보여줍니다.

앱은 그림 3과 유사한 화면을 표시하여 사용자에게 정기 결제를 변경하는 옵션을 제공할 수 있습니다. 어떠한 경우든 사용자가 현재 정기 결제 요금제와 요금제를 변경할 수 있는 옵션을 명확하게 알 수 있어야 합니다.

사용자가 정기 결제를 업그레이드하거나 다운그레이드, 변경하기로 하는 경우 개발자는 현재 유료 결제 기간의 일할 계산된 금액이 적용되는 방식과 사용 권한이 변경되는 시기를 결정하는 대체 모드를 지정합니다.

대체 모드

다음 표에는 사용 가능한 대체 모드와 사용 예, 결제된 것으로 간주되는 결제 횟수가 나와 있습니다.

업그레이드 또는 다운그레이드 혜택의 다양한 업셀링 및 재가입 적용에 관한 자세한 내용은 혜택 및 프로모션 가이드를 참고하세요.

구매 대체 모드 설정

환경설정 및 비즈니스 로직에 따라 다양한 유형의 정기 결제 전환에 서로 다른 대체 모드를 사용할 수 있습니다. 이 섹션에서는 정기 결제 변경에 관해 대체 모드를 설정하는 방법과 적용되는 제한사항을 설명합니다.

정기 결제 재신청 또는 동일한 정기 결제 내에서 요금제 전환

Google Play Console에서 기본 대체 모드를 지정할 수 있습니다. 이 설정을 사용하면 현재 정기 결제 사용자가 동일한 정기 결제의 다른 기본 요금제나 혜택을 구매하거나 취소 후 정기 결제를 재신청하는 경우 현재 정기 결제 사용자에게 청구할 시점을 선택할 수 있습니다. 사용 가능한 옵션은 CHARGE_FULL_PRICE와 동일한 즉시 청구와 WITHOUT_PRORATION과 동일한 다음 결제 날짜에 청구입니다. 이는 동일한 정기 결제 내에서 기본 요금제를 전환할 때 유일하게 관련된 대체 모드입니다.

예를 들어 사용자가 취소한 후 정기 결제가 종료되기 전에 동일한 요금제의 재가입 혜택을 구현하는 경우 SubscriptionUpdateParams에 값을 표시하지 않고 일반 구매로 새 구매를 처리할 수 있습니다. 시스템은 정기 결제에서 구성한 기본 대체 모드를 사용하며, 이전 구매에서 새 구매로의 요금제 전환을 자동으로 처리합니다.

정기 결제 간에 요금제 전환 또는 기본 대체 모드 재정의

사용자가 정기 결제 제품을 변경(다른 정기 결제 구매)하는 경우 또는 어떤 이유로든 기본 대체 모드를 재정의하려는 경우 런타임 시 구매 흐름 매개변수의 일부로 비례 배분 비율을 지정합니다.

런타임 구매 흐름 구성의 일부로 SubscriptionUpdateParams를 올바르게 제공하려면 다음 제한사항에 유의하세요.

• 업그레이드하거나 다운그레이드하는 경우 또는 선불 요금제, 자동 갱신 요금제 또는 할부 요금제에서 선불 요금제로 동일한 정기 결제 전환을 실행하는 경우 허용되는 유일한 교체 모드는 CHARGE_FULL_PRICE입니다. 다른 대체 모드를 지정하면 구매가 실패하고 사용자에게 오류가 표시됩니다.
• 선불 요금제 또는 자동 갱신 요금제에서 자동 갱신 요금제로 동일한 정기 결제 내에서 요금제를 전환할 때 유효한 비례 배분 모드는 CHARGE_FULL_PRICE와 WITHOUT_PRORATION입니다. 다른 비례 배분 모드를 지정하면 구매가 실패하고 사용자에게 오류가 표시됩니다.
• 동일한 정기 결제 제품 내에서 할부 기본 요금제에서 할부 불가 기본 요금제로 요금제를 전환하는 것은 허용되지 않습니다.

대체 예 및 동작

각 비례 배분 모드의 작동 방식을 이해하려면 다음 시나리오를 생각해 보세요.

샘와이즈는 Country Gardener 앱에서 온라인 콘텐츠를 정기적으로 결제하고 있습니다. 그리고 텍스트 전용 콘텐츠의 Tier 1 버전을 매월 정기 결제하고 있습니다. 이 정기 결제는 월 2달러의 요금이 청구되며 매월 1일에 갱신됩니다.

4월 15일에 샘와이즈는 동영상 업데이트가 포함되고 요금이 연 36달러인 연간 버전의 Tier 2 정기 결제로 업그레이드하기로 했습니다.

정기 결제를 업그레이드할 때 개발자는 비례 배분 모드를 선택합니다. 다음 목록에서는 각 비례 배분 모드가 샘와이즈의 정기 결제에 영향을 주는 방식을 설명합니다.

WITH_TIME_PRORATION

샘와이즈의 Tier 1 정기 결제가 즉시 종료됩니다. 샘와이즈는 한 달(4월 1일~30일) 요금을 결제했는데 정기 결제 기간 중간에 업그레이드했으므로 월간 정기 결제 요금의 절반(1달러)은 새 정기 결제에 적용됩니다. 그러나 새 정기 결제 요금은 연간 36달러이므로 1달러의 잔액은 10일(4월 16일~25일)에 대해서만 결제됩니다. 따라서 4월 26일에 새 정기 결제의 요금으로 36달러가 청구되며, 다음 해부터 매년 4월 26일에 36달러가 청구됩니다.

구매가 성공하는 순간 앱의 PurchasesUpdatedListener를 호출해야 하고 새 구매를 queryPurchasesAsync() 호출의 일부로 가져올 수 있습니다. 백엔드에서 즉시 SUBSCRIPTION_PURCHASED 실시간 개발자 알림을 수신합니다.

CHARGE_PRORATED_PRICE

시간 단위당 Tier 2 정기 결제 요금($36/년 = $3/월)이 시간 단위당 Tier 1 정기 결제 요금($2/월)보다 크므로 이 모드를 사용할 수 있습니다. 샘와이즈의 Tier 1 정기 결제가 즉시 종료됩니다. 샘와이즈는 한 달 전체 요금을 결제했는데 기간의 절반만 사용했으므로 월간 정기 결제 요금의 절반(1달러)은 새 정기 결제에 적용됩니다. 그러나 새 정기 결제 요금은 1년에 36달러이므로 나머지 15일의 요금은 1.50달러입니다. 따라서 새 정기 결제 요금으로 0.50달러의 차액이 청구됩니다. 5월 1일에는 새 정기 결제 등급 요금으로 36달러가 청구되며, 다음 해부터 매년 5월 1일에 36달러가 청구됩니다.

구매가 성공하는 순간 앱의 PurchasesUpdatedListener를 호출해야 하고 새 구매를 queryPurchasesAsync() 호출의 일부로 가져올 수 있습니다. 백엔드에서 즉시 SUBSCRIPTION_PURCHASED 실시간 개발자 알림을 수신합니다.

WITHOUT_PRORATION

샘와이즈의 Tier 1 정기 결제가 추가 비용 없이 Tier 2로 즉시 업그레이드됩니다. 그리고 5월 1일에 새 정기 결제 등급 요금으로 36달러가 청구되며, 다음 해부터 매년 5월 1일에 36달러가 청구됩니다.

구매가 성공하는 순간 앱의 PurchasesUpdatedListener를 호출해야 하고 새 구매를 queryPurchasesAsync() 호출의 일부로 가져올 수 있습니다. 백엔드에서 즉시 SUBSCRIPTION_PURCHASED 실시간 개발자 알림을 수신합니다.

DEFERRED

샘와이즈의 Tier 1 정기 결제는 4월 30일에 만료되기 전까지 계속됩니다. 5월 1일에 Tier 2 정기 결제가 적용되며, 새 정기 결제 등급 요금으로 36달러가 청구됩니다.

구매가 성공하는 순간 앱의 PurchasesUpdatedListener를 호출해야 하고 새 구매를 queryPurchasesAsync() 호출의 일부로 가져올 수 있습니다. 백엔드에서 즉시 SUBSCRIPTION_PURCHASED 실시간 개발자 알림을 수신합니다. 이때 다른 신규 구매를 처리하는 것과 동일한 방식으로 구매를 처리해야 합니다. 특히 새로운 구매를 확인해야 합니다. 새 정기 결제의 startTime은 대체가 적용되는 순간 채워지며 이는 이전 정기 결제가 만료될 때 발생합니다. 이때 새 정기 결제 요금제의 SUBSCRIPTION_RENEWED RTDN을 수신하게 됩니다. ReplacementMode.DEFERRED 동작에 관한 자세한 내용은 지연된 대체 처리를 참고하세요.

CHARGE_FULL_PRICE

샘와이즈의 Tier 1 정기 결제가 즉시 종료됩니다. Tier 2 정기 결제는 오늘 시작되어 36달러가 청구됩니다. 샘와이즈는 한 달 전체 요금을 결제했는데 기간의 절반만 사용했으므로 월간 정기 결제 요금의 절반(1달러)은 새 정기 결제에 적용됩니다. 새 정기 결제 요금이 연간 36달러이므로 일 년의 1/36일이 정기 결제 기간(최대 10일)에 추가됩니다. 따라서 다음번 청구는 오늘부터 1년 10일 후에 이루어지고 요금은 36달러입니다. 그 후에는 샘와이즈에게 다음 해부터 매년 36달러가 청구됩니다.

비례 배분 모드 선택 시 대체 권장사항을 검토하세요.

앱 내에서 정기 결제 변경 트리거

앱은 구매 흐름 시작과 동일한 단계를 사용하여 사용자에게 업그레이드 또는 다운그레이드를 제공할 수 있습니다. 그러나 업그레이드 또는 다운그레이드할 때 다음 예와 같이 현재 정기 결제, 향후(업그레이드 또는 다운그레이드된) 정기 결제 및 사용할 대체 모드에 관한 세부정보를 제공해야 합니다.

val offerToken = productDetails
        .getSubscriptionOfferDetails(selectedOfferIndex)
        .getOfferToken()

val billingParams = BillingFlowParams.newBuilder().setProductDetailsParamsList(
       listOf(
           BillingFlowParams.ProductDetailsParams.newBuilder()
               .setProductDetails(productDetails)
               .setOfferToken(offerToken)
               .build()
       )
       ).setSubscriptionUpdateParams(
           BillingFlowParams.SubscriptionUpdateParams.newBuilder()
               .setOldPurchaseToken("old_purchase_token")
               .setSubscriptionReplacementMode(
                 BillingFlowParams.ReplacementMode.CHARGE_FULL_PRICE
               )
               .build()
       ).build()

billingClient.launchBillingFlow(
    activity,
    billingParams
   )
// ...

String offerToken = productDetails
    .getSubscriptionOfferDetails(selectedOfferIndex)
    .getOfferToken();

BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
    .setProductDetailsParamsList(
        ImmuableList.of(
            ProductDetailsParams.newBuilder()
                // fetched via queryProductDetailsAsync
                .setProductDetails(productDetails)
                // offerToken can be found in
                // ProductDetails=>SubscriptionOfferDetails
                .setOfferToken(offerToken)
                .build()))
    .setSubscriptionUpdateParams(
        SubscriptionUpdateParams.newBuilder()
            // purchaseToken can be found in Purchase#getPurchaseToken
            .setOldPurchaseToken("old_purchase_token")
            .setSubscriptionReplacementMode(ReplacementMode.CHARGE_FULL_PRICE)
            .build())
    .build();

BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams);
// ...

대체 권장사항

다음 표는 다양한 비례 배분 시나리오와 함께 각 시나리오에 권장되는 사항을 보여줍니다.

정기 결제 변경 구매 처리

요금제 변경은 모든 약관 및 목적상 새로운 구매이므로 결제 흐름이 성공적으로 완료된 후 이와 같이 처리 및 확인되어야 합니다. 새 구매를 적절하게 처리하는 것 외에도 대체되는 구매를 폐기해야 합니다.

인앱 동작은 모든 새 구매에서와 동일합니다. 앱은 PurchasesUpdatedListener에서 새로운 구매의 결과를 수신하며, 새로운 구매는 queryPurchasesAsync에서 사용할 수 있습니다.

구매가 기존 구매를 대체하는 경우 Google Play Developer API는 정기 결제 리소스에서 linkedPurchaseToken을 반환합니다. linkedPurchaseToken에서 제공된 토큰을 무효화하여 서비스 액세스 권한을 얻는 데 이전 토큰이 사용되지 않도록 해야 합니다. 구매 업그레이드 및 다운그레이드 처리에 관한 자세한 내용은 업그레이드, 다운그레이드, 재등록을 참고하세요.

새 구매 토큰을 수신할 때는 새 구매 토큰 인증 시와 동일한 인증 프로세스를 따릅니다. Google Play 결제 라이브러리의 BillingClient.acknowledgePurchase() 또는 Google Play Developer API의 Purchases.subscriptions:acknowledge를 사용하여 이러한 구매를 확인해야 합니다.

지연된 대체 처리

지연된 대체 모드를 사용하면 사용자가 새 요금제를 시작하기 전에 기존 요금제의 남은 사용 권한을 소진하도록 할 수 있습니다.

새 구매에 ReplacementMode.DEFERRED를 사용하면 queryPurchasesAsync()는 지연된 대체가 다음 갱신일에 발생할 때까지 이전 제품과 연결된 상태로 유지되는 새 구매 토큰을 구매 흐름 후에 반환하며 이후 새 제품이 반환됩니다.

이전에는 지원 중단된 ProrationMode.DEFERRED를 사용하여 이러한 사용자 환경을 제공할 수 있었지만 ProrationMode.DEFERRED는 Play 결제 라이브러리 6에서 지원 중단되었습니다. 동작이 어떻게 다른지 알아보려면 다음 표를 참고하세요.

이제 ReplacementMode.DEFERRED를 지원 중단된 ProrationMode.DEFERRED 대신 사용해야 합니다. 사용 권한 변경과 관련하여 동일한 동작을 나타내지만 다른 새 구매 동작과 더 일관된 구매를 관리하는 방법을 제공합니다.

고객 관리

실시간 개발자 알림을 사용하면 사용자가 취소하기로 결정한 시점을 실시간으로 감지할 수 있습니다. 사용자가 정기 결제를 취소했지만 정기 결제가 만료되기 전에 사용자에게 푸시 알림 또는 인앱 메시지를 보내 정기 결제를 재신청하도록 요청할 수 있습니다.

사용자가 정기 결제를 취소한 후 개발자는 앱에서 또는 Play 스토어를 통해 사용자를 재확보할 수 있습니다. 다음 표에서는 다양한 정기 결제 시나리오와 함께 관련 사용자 재확보 작업 및 앱 요구사항을 설명합니다.

정기 결제 만료 전 - 앱 내에서

취소되었지만 아직 만료되지 않은 정기 결제의 경우 새 정기 결제 사용자와 동일한 인앱 상품 구매 흐름을 적용함으로써 정기 결제 사용자가 앱 내에서 정기 결제를 복원하도록 할 수 있습니다. UI가 사용자에게 기존 정기 결제가 있다는 점을 반영하는지 확인합니다. 예를 들어 재활성화 버튼을 사용하여 사용자의 현재 만료일 및 반복 가격을 표시할 수 있습니다.

일반적으로 개발자는 다음과 같이 사용자가 이미 정기 결제한 SKU 및 동일한 가격을 사용자에게 제공하려고 합니다.

• 동일한 SKU를 사용하여 새 정기 결제 구매를 시작합니다.
• 새 정기 결제는 이전 정기 결제를 대체하고 동일한 만료일에 갱신됩니다. 이전 정기 결제는 즉시 만료된 것으로 표시됩니다.
• 예를 들어 아킬레스가 Example Music App을 정기 결제하고 있으며, 이 정기 결제는 8월 1일에 만료될 예정이라고 가정해 보겠습니다. 아킬레스는 7월 10일에 1개월 정기 결제를 동일한 월별 가격으로 다시 결제합니다. 그러면 새 정기 결제는 나머지 잔액으로 비례 배분되고, 즉시 활성화되며, 여전히 8월 1일에 갱신됩니다.

새로운 무료 체험판 또는 재가입 할인과 같은 다른 가격을 제공하려는 경우 다음과 같이 사용자에게 다른 SKU를 제공하면 됩니다.

• 대체 모드 WITHOUT_PRORATION을 사용하여 다른 SKU로 업그레이드 또는 다운그레이드를 시작합니다.
• 새 정기 결제는 이전 정기 결제를 대체하고 동일한 만료일에 갱신됩니다. 원래 만료일에 신규 할인 가격을 포함한 새 SKU 가격이 사용자에게 청구됩니다. 난독화된 계정 ID를 사용하여 이전 정기 결제가 생성된 경우 같은 ID를 업그레이드와 다운그레이드를 위해 BillingFlowParams에 전달해야 합니다.
• 예를 들어 아킬레스가 Example Music App을 정기 결제하고 있으며, 이 정기 결제는 8월 1일에 만료될 예정이라고 가정해 보겠습니다. 7월 10일에 그는 연간 정기 결제를 신규 할인 가격으로 다시 결제합니다. 새 정기 결제가 즉시 활성화되며, 8월 1일에 신규 할인 가격이 사용자에게 청구됩니다.
• 재가입 SKU에 무료 체험판 또는 신규 할인 가격을 포함하기로 했다면 Google Play Console에서 사용자가 앱당 하나의 무료 체험판을 받도록 제한하는 옵션인 앱당 하나의 무료 체험판 허용 체크박스를 선택 해제하여 사용자가 자격요건을 충족하도록 합니다.

구매 토큰을 받으면 새 정기 결제에서와 마찬가지로 구매를 처리합니다. 또한 Google Play Developer API는 정기 결제 리소스에서 linkedPurchaseToken을 반환합니다. linkedPurchaseToken에서 제공된 토큰을 무효화하여 서비스 액세스 권한을 얻는 데 이전 토큰이 사용되지 않도록 해야 합니다.

정기 결제 만료 전 - Play 스토어에서

정기 결제가 취소되었지만 아직 활성 상태인 동안 사용자는 정기 결제 재신청(이전의 복원)을 클릭하여 Google Play 정기 결제 센터에서 정기 결제를 복원할 수 있습니다. 이렇게 하면 동일한 정기 결제 및 구매 토큰이 유지됩니다.

정기 결제 복원에 관한 자세한 내용은 복원을 참고하세요.

정기 결제 만료 후 - 앱 내에서

새 정기 결제 사용자와 동일한 인앱 상품 구매 흐름을 적용함으로써 만료된 정기 결제 사용자가 앱 내에서 정기 결제를 재신청하도록 할 수 있습니다. 다음 내용을 참고하세요.

• 사용자에게 할인을 제공하려면 정기 결제에 특별 가격이 적용된 제품 ID(재가입 SKU라고도 함)를 제공하는 것이 좋습니다. 앱 내에서 쿠폰을 제공하거나 이메일과 같이 앱 외부에서 사용자에게 쿠폰을 알릴 수 있습니다.
• 정기 결제 재가입을 시작하려면 Google Play 결제 라이브러리를 사용하여 Android 앱에서 구매 흐름을 시작합니다. 이 흐름은 새 정기 결제와 동일한 프로세스이지만, 사용자에게 제공할 SKU를 결정할 수 있습니다.
• 재가입 SKU에 무료 체험판 또는 신규 할인 가격을 포함하기로 했다면 Google Play Console에서 사용자가 앱당 하나의 무료 체험판을 받도록 제한하는 옵션인 앱당 하나의 무료 체험판 허용 체크박스를 선택 해제하여 사용자가 자격요건을 충족하도록 합니다.
• 사용자가 동일한 SKU로 정기 결제를 재개하면 더 이상 무료 체험판 또는 신규 할인 가격을 사용할 수 없습니다. UI에 이 사항이 반영되었는지 확인합니다.

구매 토큰을 받으면 새 정기 결제에서와 마찬가지로 구매를 처리합니다. 정기 결제 리소스에서 linkedPurchaseToken을 수신하지 않습니다.

정기 결제 만료 후 - Play 스토어에서

옵션이 사용 설정된 경우 사용자는 Google Play 정기 결제 센터에서 정기 결제 재신청을 클릭하여 만료 후 최대 1년 동안 동일한 SKU의 정기 결제를 다시 신청할 수 있습니다. 그러면 새 정기 결제 및 구매 토큰이 생성됩니다.

정기 결제 재신청은 앱 외부 구매로 간주되므로 앱 외부에서 이루어진 구매 처리 권장사항을 따라야 합니다.

정기 결제 프로모션

프로모션 코드를 만들어 기존 정기 결제에 대한 연장된 무료 체험판을 선택된 사용자에게 제공할 수 있습니다. 자세한 내용은 프로모션 코드를 참고하세요.

무료 체험판의 경우 Google Play에서는 무료 체험판을 시작하기 전에 사용자에게 유효한 결제 수단이 있는지 인증합니다. 일부 사용자에게 이 인증은 결제 수단에 대한 보류 또는 청구로 표시될 수 있습니다. 이 보류 또는 청구는 일시적이며 나중에 취소 또는 환불됩니다.

무료 체험판 기간이 종료되면 사용자의 결제 수단으로 정식 정기 결제 금액이 청구됩니다.

사용자가 무료 체험판 기간에 언제든지 정기 결제를 취소하면 정기 결제는 무료 체험판이 끝날 때까지 활성 상태로 유지되며 무료 체험판 사용 기간이 종료되면 요금이 청구되지 않습니다.

취소 또는 환불, 해지

Google Play Developer API를 사용하여 정기 결제를 취소, 환불 또는 해지할 수 있습니다. 이 기능은 Google Play Console에서도 사용할 수 있습니다.

• 취소: 사용자가 Google Play에서 정기 결제를 취소할 수 있습니다. 또한 사용자가 앱 또는 웹사이트에서 취소할 수 있는 옵션을 제공할 수도 있습니다. 앱은 취소에 설명된 대로 이러한 취소를 처리해야 합니다.
• 환불: 개발자가 환불할 때 사용자는 정기 결제를 계속 사용할 수 있습니다. 예를 들어 사용자가 제품에 액세스하지 못하게 하는 기술적 오류가 발생했지만 오류가 해결된 경우 환불을 사용할 수 있습니다. 가장 최근 결제 금액을 초과하여 환불하거나 부분 환불을 처리하려면 Google Play Console을 사용해야 합니다.
• 해지: 개발자가 해지할 때 사용자는 정기 결제 액세스 권한을 즉시 잃게 됩니다. 예를 들어 사용자가 제품에 액세스하지 못하게 하는 기술적 오류가 발생했으며 사용자가 제품을 계속 사용하지 않으려는 경우에 이 기능을 사용할 수 있습니다. 앱은 취소에 설명된 대로 이러한 취소를 처리해야 합니다.

다음 표에서는 취소, 환불 및 해지의 차이점을 보여줍니다.

정기 결제 사용자의 결제 연기

Google Play Developer API의 Purchases.subscriptions:defer를 사용하여 자동 갱신 정기 결제 사용자의 다음 결제일을 연기할 수 있습니다. 연기 기간 동안 사용자는 전체 액세스 권한으로 정기 결제 콘텐츠에 액세스할 수 있지만 요금이 청구되지 않습니다. 정기 결제 갱신일은 새로운 날짜를 반영하여 업데이트됩니다.

선불 요금제의 경우 결제 연기 API를 사용하여 만료 시간을 연기할 수 있습니다.

결제 연기를 통해 다음을 할 수 있습니다.

• 영화 구매 1주일 무료 혜택 제공과 같은 특별 이벤트로 사용자에게 무료 액세스 권한을 부여합니다.
• 서비스 차원으로 고객에게 무료 액세스 권한을 부여합니다.

결제는 API 호출당 최소 하루, 최대 1년까지 연기할 수 있습니다. 결제를 훨씬 더 연기하려면 새 결제일이 도래하기 전에 API를 다시 호출하면 됩니다.

예를 들어 다르시가 Fishing Quarterly 앱의 온라인 콘텐츠를 매월 정기 결제하고 있으며 보통 매월 1일에 1.25파운드가 청구된다고 가정해 보겠습니다. 3월에 다르시는 앱 게시자에 관한 온라인 설문조사에 참여했습니다. 이에 대한 리워드로 게시자는 5월 15일(기존에 예정된 결제일인 4월 1일로부터 6주 후)까지 다음 결제를 연기함으로써 6주간 무료로 콘텐츠를 제공합니다. 4월 또는 5월 초 요금이 청구되지 않지만 다르시는 여전히 콘텐츠에 액세스할 수 있습니다. 5월 15일에는 월 정기 결제 비용으로 정상 요금인 1.25파운드가 청구됩니다. 다르시의 다음 갱신일은 이제 6월 15일입니다.

결제 연기 시 이메일을 통해 또는 앱 내에서 사용자에게 알림을 보내 결제일이 변경되었음을 알릴 수 있습니다.

결제 거부 처리

정기 결제 갱신에 결제 문제가 있는 경우 Google은 정기 결제를 취소하기 전에 한동안 정기 결제를 주기적으로 갱신하려고 합니다. 이 복구 기간은 유예 기간과 그 이후의 계정 보류 기간으로 구성될 수 있습니다. 이 기간 동안 Google은 사용자에게 결제 수단 업데이트를 요청하는 이메일과 알림을 전송합니다.

결제가 거부되면 정기 결제의 유예 기간이 시작됩니다(구성된 경우). 유예 기간 중에도 사용자가 계속해서 정기 결제 사용 권한을 이용할 수 있어야 합니다.

유예 기간이 종료되면 정기 결제의 계정 보류 기간이 시작됩니다. 계정 보류 기간 중에는 사용자가 정기 결제 사용 권한을 이용할 수 없어야 합니다.

Google Play Console에서 각 자동 갱신 기본 요금제의 유예 기간 및 계정 보류 기간의 길이를 지정할 수 있습니다. 길이를 기본값보다 짧게 지정하면 결제 거부에서 복구되는 정기 결제 수가 줄어들 수 있습니다.

결제 거부 과정에서 정기 결제 복구 가능성을 극대화하려면 사용자에게 결제 문제를 알리고 문제 해결을 요청하세요.

유예 기간 및 계정 보류 섹션에 설명된 대로 직접 이 작업을 실행하거나 Google에서 앱 사용자에게 메시지를 표시하도록 인앱 메시지 API를 구현할 수 있습니다.

인앱 메시지

InAppMessageCategoryId.TRANSACTIONAL로 인앱 메시지를 사용 설정한 경우 Google Play에서는 유예 기간과 계정 보류 기간 동안 하루에 한 번씩 사용자에게 메시지를 표시하여 앱을 나가지 않고도 결제 문제를 해결할 기회를 제공합니다.

사용자가 앱을 열 때마다 이 API를 호출하여 메시지를 표시할지 결정하는 것이 좋습니다.

사용자가 정기 결제를 성공적으로 복구하면 구매 토큰과 함께 응답 코드 SUBSCRIPTION_STATUS_UPDATED가 수신됩니다. 그러면 이 구매 토큰을 사용하여 Google Play Developer API를 호출하고 앱에서 정기 결제 상태를 새로고침해야 합니다.

인앱 메시지 통합

사용자에게 인앱 메시지를 표시하려면 BillingClient.showInAppMessages()를 사용합니다.

다음은 인앱 메시지 흐름을 트리거하는 예시입니다.

val inAppMessageParams = InAppMessageParams.newBuilder()
        .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL)
        .build()

billingClient.showInAppMessages(activity,
        inAppMessageParams,
        object : InAppMessageResponseListener() {
            override fun onInAppMessageResponse(inAppMessageResult: InAppMessageResult) {
                if (inAppMessageResult.responseCode == InAppMessageResponseCode.NO_ACTION_NEEDED) {
                    // The flow has finished and there is no action needed from developers.
                } else if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED) {
                    // The subscription status changed. For example, a subscription
                    // has been recovered from a suspend state. Developers should
                    // expect the purchase token to be returned with this response
                    // code and use the purchase token with the Google Play
                    // Developer API.
                }
            }
        })

InAppMessageParams inAppMessageParams = InAppMessageParams.newBuilder()
        .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL)
        .build();

billingClient.showInAppMessages(activity,
        inAppMessageParams,
        new InAppMessageResponseListener() {
            @Override
            public void onInAppMessageResponse(InAppMessageResult inAppMessageResult) {
                if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.NO_ACTION_NEEDED) {
                    // The flow has finished and there is no action needed from developers.
                } else if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED) {
                    // The subscription status changed. For example, a subscription
                    // has been recovered from a suspend state. Developers should
                    // expect the purchase token to be returned with this response
                    // code and use the purchase token with the Google Play
                    // Developer API.
                }
            }
        });

정기 결제 대기 중인 거래 처리

대기 중인 거래는 최초 구매, 충전, 업그레이드 또는 다운그레이드 시 발생할 수 있습니다. 구독 구매는 SUBSCRIPTION_STATE_PENDING 상태로 시작하여 SUBSCRIPTION_STATE_ACTIVE로 전환됩니다. 거래가 만료되거나 사용자가 취소하면 SUBSCRIPTION_STATE_PENDING_PURCHASE_EXPIRED로 이동합니다. 거래가 완료된 후에만 사용자의 사용 권한을 업데이트해야 합니다.

대기 중인 거래가 있는 초기 구매의 정기 결제 상태 변경은 간단합니다. 사용자가 대기 중인 거래를 시작하면 앱은 PENDING 상태의 Purchase를 수신합니다. 거래가 완료되면 앱은 상태가 PURCHASED로 업데이트된 Purchase를 다시 수신합니다. SUBSCRIPTION_PURCHASED 유형의 SubscriptionNotification 메시지가 RTDN 클라이언트로 전송됩니다. 일반적인 절차에 따라 구매를 확인하고 사용자에게 콘텐츠 액세스 권한을 부여한 후 구매를 확인합니다. 거래가 만료되거나 취소되면 SUBSCRIPTION_PENDING_PURCHASE_CANCELED 유형의 SubscriptionNotification 메시지가 RTDN 클라이언트로 전송됩니다. 이 경우 사용자는 콘텐츠에 액세스할 수 없어야 합니다.

대기 중인 거래로 충전, 업그레이드 또는 다운그레이드하면 기존 구독과 새 구독의 상태가 모두 변경됩니다. 사용자가 대기 중인 충전, 업그레이드 또는 다운그레이드 거래를 시작하면 앱은 PendingPurchaseUpdate 객체가 포함된 이전 정기 결제의 Purchase를 수신합니다. 이 시점에서 사용자는 여전히 이전 정기 결제를 소유하고 있으며 아직 새 정기 결제를 받지 못했습니다. PendingPurchaseUpdate 객체에서 getProducts() 및 getPurchaseToken()를 호출하면 새 정기 결제의 제품 ID와 구매 토큰이 반환됩니다. 거래가 완료되면 앱은 새 구독에 설정된 최상위 구매 토큰과 상태가 PURCHASED로 설정된 Purchase를 수신합니다. SUBSCRIPTION_PURCHASED 유형의 SubscriptionNotification 메시지가 RTDN 클라이언트로 전송됩니다. 이때만 기존 구매 토큰을 새 구매 토큰으로 대체하고 사용자의 콘텐츠 액세스 권한을 업데이트해야 합니다. 거래가 만료되거나 취소되면 SUBSCRIPTION_PENDING_PURCHASE_CANCELED 유형의 SubscriptionNotification 메시지가 RTDN 클라이언트로 전송됩니다. 이 경우에도 사용자는 이전 정기 결제의 콘텐츠에 계속 액세스할 수 있어야 합니다.