정기 결제 판매

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

이 주제를 읽기 전에 앱에서 제품을 판매하고 관리하는 방법에 관한 일반적인 안내를 제공하는 앱에 Google Play 결제 라이브러리 통합을 꼭 먼저 읽어보세요.

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

정기 결제 개요

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

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

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

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

정기 결제 수명 주기 처리

구매한 정기 결제는 전체 수명 주기 동안 다양한 상태 변경을 거칠 수 있으며 앱은 각 변경에 응답해야 합니다. 정기 결제의 상태를 확인하기 위해 앱은 Google Play 결제 라이브러리의 BillingClient.queryPurchasesAsync() 또는 Google Play Developer API의 Purchases.subscriptionsv2:get을 사용하여 쿼리할 수 있습니다.

앱이 보안 백엔드 서버에 정기 결제 상태를 저장하면 실시간 개발자 알림을 사용하여 상태가 동기화된 상태로 유지되도록 상태 변경을 수신 대기해야 합니다. 갱신 및 취소와 같이 정기 결제 상태에 영향을 주는 이벤트에 대해 SubscriptionNotification이 전송됩니다.

앱은 다음 섹션에 설명된 상태 변경을 처리해야 합니다.

신규 정기 결제

신규 구매 처리를 위한 권장사항을 따르세요. 정기 결제를 구매하면 BillingClient.queryPurchasesAsync()에서 정기 결제를 반환하고 알림 유형이 SUBSCRIPTION_PURCHASED인 SubscriptionNotification이 전송됩니다. 이 알림을 받으면 Google Play Developer API를 쿼리하여 최신 정기 결제 상태를 가져와야 합니다. 정기 결제 리소스는 다음 예시와 유사합니다. 구매를 확인할 때까지 리소스에는 ACKNOWLEDGEMENT_STATE_PENDING이라는 acknowledgementState가 있습니다.

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  "startTime": "2022-04-22T18:39:58.270Z",
  "regionCode": "US",
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  "latestOrderId": "GPA.3333-4137-0319-36762",
  "acknowledgementState": "ACKNOWLEDGEMENT_STATE_PENDING", // need to acknowledge new purchases
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": next_renewal_date,
      "autoRenewingPlan": {
        "autoRenewEnabled": true
      }
    }
  ],
}

갱신

정기 결제가 성공적으로 갱신되면 그 정기 결제는 BillingClient.queryPurchasesAsync()에 의해 계속 반환됩니다.

또한 정기 결제가 갱신될 때 SUBSCRIPTION_RENEWED 알림이 전송됩니다. 앱은 사용자에게 여전히 정기 결제 콘텐츠 사용 자격이 있는지 확인한 후 Google Play Developer API에서 반환된 정기 결제 리소스에 제공된 새로운 expiryTime으로 정기 결제 상태를 업데이트해야 합니다. 정기 결제 리소스는 다음과 유사합니다.

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  "startTime": "2022-04-22T18:39:58.270Z",
  "regionCode": "US",
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  "latestOrderId": "GPA.3333-4137-0319-36762",
  "acknowledgementState": "ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED",
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": next_renewal_date,
      "autoRenewingPlan": {
        "autoRenewEnabled": true
      }
    }
  ]
}

만료

정기 결제가 만료되면 그 정기 결제는 BillingClient.queryPurchasesAsync()에서 더 이상 반환되지 않으며 사용자는 정기 결제에 액세스할 수 없게 됩니다.

유형이 SUBSCRIPTION_EXPIRED인 SubscriptionNotification도 정기 결제가 만료될 때 전송됩니다. 이 알림을 받으면 Google Play Developer API를 쿼리하여 최신 정기 결제 상태를 가져와야 합니다. 정기 결제 리소스는 다음과 유사합니다.

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_EXPIRED",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": expiration_time_in_past,
      ...
    }
  ],
}

취소

사용자는 Play 스토어에서 정기 결제를 자발적으로 취소하거나 계정 보류 상태에서 복구하지 않음으로써 정기 결제가 자동으로 취소되도록 할 수도 있습니다. 사용자가 정기 결제를 취소하더라도 현재 결제 주기가 끝날 때까지는 계속 콘텐츠에 액세스할 수 있습니다. 결제 주기가 끝나면 액세스가 취소됩니다.

정기 결제가 취소되었지만 아직 만료되지 않았다면 BillingClient.queryPurchasesAsync()에서 반환됩니다. 정기 결제가 취소되면 SUBSCRIPTION_CANCELED 알림이 트리거됩니다. 이 알림을 받으면 Google Play Developer API에서 반환된 정기 결제 리소스에 "SUBSCRIPTION_STATE_CANCELED"로 설정된 subscriptionState가 포함되며 expiryTime에는 사용자가 정기 결제에 액세스할 수 없게 되는 날짜가 포함됩니다. expiryTime이 기한이 지난 과거 상태이면 사용자는 즉시 액세스 자격을 잃게 됩니다. 만료 상태가 아니면 만료 시까지 사용자가 액세스 자격을 유지하게 됩니다. 정기 결제 리소스는 다음과 유사합니다.

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_CANCELED",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": expiration_time,
      ...
    }
  ],
}

앱은 Google Play Developer API에서 반환된 정기 결제 리소스의 cancelReason을 보고 정기 결제가 취소된 이유(예: 고객 취소나 결제 문제)를 확인할 수 있습니다. 사용자가 정기 결제를 취소했다면 cancelSurveyResult 필드를 통해 사용자가 정기 결제를 취소한 이유를 확인할 수 있습니다.

앱에서 사용자에게 정기 결제가 취소되었음을 알리는 메시지(예: '_somedate에 정기 결제가 만료됩니다.')를 표시할 수 있습니다. 또한 Google Play 스토어로 딥 링크를 설정하여 사용자가 정기 결제를 복원하도록 할 수도 있습니다.

이 메시지를 표시한다면 메시지를 영구적으로 닫을 수 있는 기능도 사용자에게 제공해야 합니다.

특히 결제 방법이 업데이트되지 않아 정기 결제가 취소된 경우와 달리 수동으로 정기 결제를 취소한 사용자라면 취소 메시지가 달갑지 않을 수 있습니다. 따라서 정기 결제를 수동으로 취소한 사용자에게는 메시지를 보내지 않는 것이 좋습니다.

해지

앱에서 Purchases.subscriptions:revoke를 사용하여 정기 결제를 해지하거나 구매 지불을 거절하는 등 다양한 이유로 사용자가 정기 결제를 해지할 수 있습니다. 이 상황에서 앱은 즉시 사용자의 액세스 자격을 해지해야 합니다. 해지된 정기 결제는 BillingClient.queryPurchasesAsync()에서 더 이상 반환되지 않습니다. 이 경우 유형이 SUBSCRIPTION_REVOKED인 SubscriptionNotification도 전송됩니다. 이 알림을 받으면 Google Play Developer API에서 반환된 정기 결제 리소스에 "SUBSCRIPTION_STATE_EXPIRED"로 설정된 subscriptionState가 포함되며 expiryTime에는 사용자가 정기 결제에 액세스할 수 없게 되는 날짜가 포함됩니다. 정기 결제 리소스는 다음과 유사합니다.

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_EXPIRED",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": expiration_time,
      ...
    }
  ],
}

계정 보류

계정 보류는 사용자의 결제 수단으로 결제하는 데 실패한 후 결제 문제가 해결되지 않은 상태로 관련된 유예 기간이 종료되는 경우 시작되는 정기 결제 상태입니다. 정기 결제가 계정 보류 상태로 전환되면 콘텐츠 또는 서비스에 대한 액세스를 차단해야 합니다. 계정 보류 기간은 최대 30일 동안 지속됩니다.

계정 보류 중에는 정기 결제가 BillingClient.queryPurchasesAsync()에 의해 반환되지 않습니다.

계정 보류 중에는 필요에 따라 정기 결제의 취소, 복원 또는 재구매를 처리해야 합니다.

사용자가 계정 보류 상태로 전환되면 실시간 개발자 알림을 활용하여 정기 결제에 대한 액세스가 정지된 이유를 사용자에게 알려야 합니다. 앱에서 결제 수단을 수정하고 정기 결제에 대한 액세스 권한을 다시 얻는 방법에 관한 안내가 포함된 메시지를 제공해야 합니다. 사용자가 결제 수단을 수정할 수 있도록 메시지에 Google Play 정기 결제 설정 링크를 포함해야 합니다. 예를 들어 다음과 같은 메시지를 사용할 수 있습니다.

"There is a problem with your subscription. Click here to go to the
Google Play subscription settings to fix your payment method."

사용자가 앱 외부의 정기 결제 콘텐츠에 액세스할 수 있는 경우, 사용자에게 푸시 알림이나 이메일을 보내 정기 결제가 더 이상 활성 상태가 아님을 알릴 수 있습니다.

고객이 결제 문제를 해결했다면 정기 결제가 복원되었을 때 이를 사용자에게 알리는 메시지를 앱에 표시할 수 있습니다. 예를 들어 다음과 같은 메시지를 사용할 수 있습니다.

"Your form of payment was updated, and your subscription has
been recovered."

실시간 개발자 알림을 사용하면 정기 결제가 계정 보류 상태가 될 때 SUBSCRIPTION_ON_HOLD 유형의 SubscriptionNotification을 수신합니다. 보안 백엔드 서버에서 Google Play Developer API를 호출하여 새 정기 결제 정보를 받을 수 있습니다. 계정 보류 중에는 정기 결제 리소스의 expiryTime이 기한이 지난 타임스탬프로 설정됩니다.

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_ON_HOLD",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": timestamp_in_past,
      ...
    }
  ],
}

사용자가 결제 수단을 수정하면 정기 결제가 활성 상태로 돌아갑니다. 그리고 나서 정기 결제한 콘텐츠에 대한 액세스 권한을 복원해야 합니다.

앱이 queryPurchasesAsync()만 사용하여 사용자에게 정기 결제 자격이 있는지 확인한다면 앱은 계정 보류에서 복구되는 정기 결제를 자동으로 처리해야 합니다.

앱이 정기 결제 상태를 서버와 동기화하는 경우 정기 결제가 복구되고 사용자가 다시 액세스 권한을 얻어야 할 때 알림을 받을 수 있도록 유형이 SUBSCRIPTION_RECOVERED인 SubscriptionNotification을 수신 대기해야 합니다. 이 알림을 받은 후 정기 결제를 쿼리하면 이제 expiryTime이 미래의 타임스탬프로 설정됩니다.

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": next_renewal_date,
      ...
    }
  ],
}

계정 보류 기간이 종료되기 전에 사용자가 결제 수단을 수정하지 않으면 SUBSCRIPTION_CANCELED 실시간 개발자 알림을 받게 됩니다. 취소 처리에 관한 안내는 정기 결제 취소를 참고하세요. 이러한 방식으로 취소된 정기 결제를 쿼리하면 반환된 expiryTime이 기한이 지난 타임스탬프로 설정됩니다.

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_CANCELED",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": timestamp_in_past,
      ...
    }
  ],
}

계정 보류 액세스 및 복구

정기 결제가 계정 보류 상태로 전환되었다가 사용자가 결제 수단을 수정할 때 다시 복구되는 타임라인은 아래와 같습니다.

이전 예와 마찬가지로 이 타임라인은 계정 보류 상태로 전환되기 전에 유예 기간이 시작된 정기 결제를 나타냅니다.

다음 내용을 참고하세요.

• 유예 기간 동안 사용자는 정기 결제 혜택을 계속 이용할 수 있어야 합니다.
• 정기 결제를 계정 보류 상태로 전환하기 전에 Google은 최대 24시간 동안 결제 수단에 요금을 청구하려고 추가로 시도합니다. 이 기간 동안 사용자는 정기 결제 혜택을 그대로 유지합니다. 재시도 기간이 지나면 정기 결제가 계정 보류 상태로 전환되고 사용자는 정기 결제의 혜택을 누릴 수 없게 됩니다.
• 유예 기간 동안 정기 결제가 복구되는 경우 갱신일은 초기화되지 않습니다.
• 계정 보류 상태에서 정기 결제가 복구되면 갱신일이 초기화됩니다.

유예 기간

유예 기간이 사용 설정된 경우 결제 주기가 끝날 때 결제 문제가 있다면 정기 결제는 유예 기간으로 전환됩니다. 이 기간에 Google Play가 정기 결제를 갱신하려고 시도하는 동안 사용자는 여전히 정기 결제 콘텐츠에 액세스할 수 있어야 합니다. Google Play Console의 인앱 상품 설정에서 유예 기간을 지정할 수 있습니다.

앱이 queryPurchasesAsync()만 사용하여 사용자에게 정기 결제 자격이 있는지 확인한다면 queryPurchasesAsync()가 만료일 전에 취소된 구매를 계속 반환하므로 앱은 유예 기간을 자동으로 처리해야 합니다.

앱이 정기 결제 상태를 백엔드와 동기화하면 사용자가 유예 기간이 될 때 알림을 받을 수 있도록 유형이 SUBSCRIPTION_IN_GRACE_PERIOD인 SubscriptionNotification을 수신 대기해야 합니다. 사용자가 유예 기간 상태에 있는 동안 정기 결제 리소스에는 autoRenewEnabled = true가 포함됩니다.

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_IN_GRACE_PERIOD",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": timestamp_in_future,
      "autoRenewingPlan": {
        "autoRenewEnabled": true
      }
    }
  ],
}

사용자가 유예 기간 상태로 전환될 때 사용자에게 결제 수단을 수정하는 방법을 알리는 메시지를 앱에 표시해야 합니다. 메시지를 표시하지 않으면 유예 기간이 종료되었을 때 사용자가 정기 결제 액세스 권한을 잃게 됩니다. 사용자가 정기 결제를 관리하는 데 도움이 되도록 이 메시지를 Google Play 스토어로 딥 링크 설정할 수 있습니다.

사용자가 결제 수단을 수정하는 즉시 정기 결제가 갱신되고 갱신에 설명된 대로 앱에서 갱신을 처리할 수 있습니다.

사용자가 유예 기간에 결제 수단을 수정하지 않으면 정기 결제가 계정 보류 상태가 됩니다.

계정 보류 없이 유예 기간 액세스 및 복구

다음 예는 유예 기간이 시작된 후 사용자가 결제 수단을 수정하면 복구되는 정기 결제의 타임라인을 보여줍니다. 이 예에서는 정기 결제가 계정 보류를 지원하지 않으므로 유예 기간이 끝나면 사용자는 정기 결제 혜택을 잃게 됩니다.

다음 내용을 참고하세요.

• 유예 기간 동안 사용자는 정기 결제 혜택을 계속 이용할 수 있어야 합니다.
• 유예 기간 동안 정기 결제가 복구되는 경우 갱신일은 초기화되지 않습니다.

일시중지된 정기 결제

사용자에게 정기 결제 일시중지 기능을 제공하여 자발적 앱 제거를 방지할 수 있습니다. 일시중지 기능을 사용하도록 설정하면 사용자가 반복 주기에 따라 일주일에서 최대 3개월까지 정기 결제를 일시중지하도록 선택할 수 있게 됩니다. 일시중지 옵션을 사용 설정하면 정기 결제 센터와 취소 흐름 모두에 이 옵션이 표시됩니다. 연간 정기 결제는 일시중지할 수 없으며, 1주일 및 3개월의 일시중지 한도는 언제든지 변경될 수 있습니다.

사용자가 정기 결제를 일시중지할 수 있게 하려면 다음 단계를 따르세요.

1. Google Play Console에 로그인합니다.
2. 앱을 선택한 후 앱 정보 > 인앱 상품 > 정기 결제로 이동합니다.
3. 정기 결제 설정 섹션을 펼칩니다.
4. 일시중지 허용을 선택합니다.

정기 결제 일시중지는 현재 결제 기간이 종료되어야만 적용됩니다. 정기 결제가 일시중지된 동안에는 사용자가 정기 결제 콘텐츠에 액세스할 수 없습니다. 일시중지 기간이 끝나면 정기 결제가 재개되고 Google에서 정기 결제 갱신을 시도합니다. 재개가 완료되면 정기 결제가 다시 활성화됩니다. 결제 문제로 인해 정기 결제가 재개되지 않으면 사용자는 그림 1과 같이 계정 보류 상태로 전환됩니다.

또한 사용자는 그림 2와 같이 일시중지 기간에 언제든지 수동으로 정기 결제를 재개하도록 선택할 수 있습니다. 사용자가 정기 결제를 수동으로 재개하면 결제일이 수동 재개 날짜로 변경됩니다.

사용자의 정기 결제가 일시중지되면 그 정기 결제는 queryPurchasesAsync()에 의해 반환되지 않습니다. 정기 결제가 재개되면 그 정기 결제는 queryPurchasesAsync()에 의해 반환됩니다.

앱이 정기 결제 상태를 보안 백엔드 서버와 동기화하면 실시간 개발자 알림을 수신하여 상태를 유지해야 합니다. 이러한 알림을 통해 앱의 사용자에게 정기 결제가 일시중지되었으며 정기 결제 콘텐츠에 대한 액세스 권한이 없음을 알릴 수 있습니다. 또한 Google Play로 연결되는 딥 링크를 사용하여 정기 결제를 수동으로 재개하는 방법을 사용자에게 제공해야 합니다.

사용자가 정기 결제 일시중지를 시작하면 유형이 SUBSCRIPTION_PAUSE_SCHEDULE_CHANGED인 SubscriptionNotification이 전송됩니다. 이 시점에 사용자는 정기 결제에 계속 액세스할 수 있어야 하며 정기 결제 리소스에는 autoRenewing = true, paymentState = 1(결제 수신)과 향후 expiryTime와 autoResumeTimeMillis에 사용될 값이 포함됩니다.

일시중지가 적용되면 유형이 SUBSCRIPTION_PAUSED인 SubscriptionNotification이 전송됩니다. 이 시점에 사용자는 정기 결제에 관한 액세스 권한을 상실하며 정기 결제 리소스에는 autoRenewing = true, paymentState = 0(보류 중)과 향후 autoResumeTimeMillis에 사용할 값 및 expiryTime의 과거 값이 포함됩니다.

일시중지 기간이 끝날 때 정기 결제가 자동으로 재개되거나 사용자가 수동으로 정기 결제를 재개하면 유형이 SUBSCRIPTION_RENEWED인 SubscriptionNotification이 전송됩니다. 이 경우 갱신에 설명된 대로 처리해야 합니다.

정기 결제 재개를 시도하는 동안 결제 실패가 발생하면 유형이 SUBSCRIPTION_ON_HOLD인 SubscriptionNotification이 전송됩니다. 이 경우 계정 보류 섹션에 설명된 대로 처리해야 합니다.

복원

취소된 정기 결제는 만료일까지 Play 스토어 앱에 계속 표시됩니다. 사용자는 Google Play 스토어 앱의 정기 결제 섹션에서 정기 결제 재신청(이전의 복원)을 클릭하여, 취소된 정기 결제를 만료 전에 복원할 수 있습니다. 또한 사용자가 '정기 결제 재신청' 옵션으로 적절하게 구성하여 만료 후에 자동 갱신 기본 요금제로 정기 결제를 재신청하도록 허용할 수 있습니다.

만료 전 복원

앱이 queryPurchasesAsync()만 사용하여 사용자에게 정기 결제 자격이 있는지 확인한다면 queryPurchasesAsync()가 만료일 전에 취소된 구매를 계속 반환하므로 앱은 복원을 자동으로 처리해야 합니다. 복원된 정기 결제는 취소되지 않았던 것처럼 계속 갱신됩니다.

앱이 정기 결제 상태를 백엔드와 동기화하면 유형이 SUBSCRIPTION_RESTARTED인 SubscriptionNotification을 수신 대기해야 합니다. 알림을 수신하면 앱은 알림에 응답하고, 정기 결제가 이제 갱신되도록 설정되었음을 기록하며, 앱에 복원 메시지 표시를 중지할 수 있습니다. 정기 결제 리소스는 다음과 유사합니다.

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": next_renewal_date
      ...
    }
  ],
}

만료 후 정기 결제 재신청

만료 후 정기 결제 재신청을 허용하도록 정기 결제 제품이 구성된 경우 사용자가 Play 스토어 앱에서 구매를 시작할 수 있습니다. 이 경우 Google Play에서는 새 구매 토큰을 발행하고 백엔드에서는 SUBSCRIPTION_PURCHASED 실시간 개발자 알림을 수신합니다. 이 구매 유형의 구매 상태에는 linkedPurchaseToken도, 이 경우의 원래 구매와 연결된 난독화된 계정 식별자도 포함되지 않습니다. 완전히 만료되었기 때문입니다.

만료 후 정기 결제 재신청을 위해서는 사용자가 앱을 열어야 하며 개발자는 이러한 유형의 구매를 다른 앱 외부 구매와 동일한 방식으로 처리합니다.

업그레이드, 다운그레이드, 재가입

사용자가 업그레이드 또는 다운그레이드하거나 정기 결제 만료 전에 앱에서 재가입할 때 이전 정기 결제는 무효화되고 새 정기 결제가 새 구매 토큰과 함께 생성됩니다.

또한 Google Play Developer API에서 반환된 정기 결제 리소스에는 사용자가 업그레이드 또는 다운그레이드하거나 정기 결제를 재신청한 이전 구매를 나타내는 linkedPurchaseToken이 포함됩니다. linkedPurchaseToken을 사용하면 이전 정기 결제를 조회하고 기존 사용자 계정을 식별하여 새 구매를 동일한 계정과 연결할 수 있습니다.

앱에서 업그레이드, 다운그레이드, 재가입 옵션을 제공하기 전에 기존의 정기 결제를 확인해야 합니다. 이전 정기 결제가 확인 대기 중인 경우 요금제 변경 또는 재가입이 차단됩니다.

요금제 변경 또는 재가입 후에는 새로운 정기 결제 구매도 확인해야 합니다. 구매 취소를 방지하려면 Google Play Developer API를 사용하여 구매를 확인하는 것이 좋습니다. 정기 결제 리소스는 다음과 유사합니다.

{
  "kind": "androidpublisher#subscriptionPurchaseV2",
  ...
  "subscriptionState": "SUBSCRIPTION_STATE_ACTIVE",
  "linkedPurchaseToken": old_purchase_token,
  ...
  "lineItems": [
    {
      "productId": "sub_variant_plan01",
      "expiryTime": next_renewal_date,
      "autoRenewingPlan": {
        "autoRenewEnabled": true
      }
    }
  ],
}

선불 요금제 통합

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

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

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

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

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

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

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

선불 구매 확인

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

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

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

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

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

개발자는 고객이 정기 결제를 쉽게 관리할 수 있도록 해야 합니다. 사용자가 정기 결제를 관리할 수 있는 링크를 앱의 설정 또는 환경설정 화면에 포함해야 합니다. 이 링크의 예는 그림 4에 나와 있습니다.

사용자가 앱의 만료되지 않은 정기 결제를 보유하고 있는지 확인하는 로직을 이 링크의 클릭 핸들러에 추가합니다. 여기에서 expiryTime가 미래 시점이거나 autoRenewing이 true로 설정됩니다.

각 정기 결제의 productId는 Play Console에서 생성 시에 할당한 제품 ID와 일치합니다. 프로그래매틱 방식으로 기존 정기 결제의 productId를 확인하려면 앱의 백엔드에 대해 특정 사용자와 관련된 정기 결제 목록을 쿼리합니다.

사용자에게 만료되지 않은 정기 결제가 있다면 'your-sub-product-id' 및 'your-app-package'를 정기 결제 ID 및 앱 패키지 정보로 바꿈으로써 다음과 유사한 URL로 사용자를 안내할 수 있습니다.

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

사용자에게 앱 내에 만료되지 않은 정기 결제가 없다면 다음 URL을 사용하여 그림 5 및 6과 같이 다른 정기 결제를 모두 보여주는 페이지로 사용자를 안내합니다.

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

Classy Taxi 샘플 앱에서 정기 결제 링크 로직의 코드 예를 확인할 수 있습니다.

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

기본 등급 및 프리미엄 등급과 같은 다양한 정기 결제 등급을 사용자에게 제공할 수 있습니다. 그림 7은 두 개의 정기 결제 등급을 제공하는 화면을 보여줍니다.

사용자가 정기 결제를 업그레이드하거나 다운그레이드하려면 그림 7과 유사한 화면에 액세스할 수 있어야 합니다. 정기 결제 업그레이드 또는 다운그레이드 시 변경사항이 정기 결제 사용자에게 영향을 주는 방식을 결정하는 비례 배분 모드를 설정할 수 있습니다.

다음 표에는 사용 가능한 비례 배분 모드가 나와 있습니다.

사용자가 정기 결제 사용 권한을 변경하는 경우 런타임에 비례 배분 비율을 지정해야 합니다. 사용 권한 변경의 경우 Google Play Console을 통해 기본 비례 배분 모드를 지정할 수 없습니다.

사용자가 정기 결제 사용 권한을 변경하지 않으면 Play Console을 통해 구성된 기본 비례 배분 모드를 사용할 수 있습니다. SubscriptionUpdateParams에 비례 배분 모드를 지정하여 이 동작을 재정의할 수도 있습니다. 다음 제한사항을 참고하세요.

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

비례 배분 예

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

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

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

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

IMMEDIATE_WITH_TIME_PRORATION

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

IMMEDIATE_AND_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달러가 청구됩니다.

IMMEDIATE_WITHOUT_PRORATION

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

DEFERRED

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

IMMEDIATE_AND_CHARGE_FULL_PRICE

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

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

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

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
            .setOldSkuPurchaseToken("old_purchase_token")
            .setReplaceSkusProrationMode(ProrationMode.IMMEDIATE_AND_CHARGE_FULL_PRICE)
            .build())
    .build();

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

// process purchase results from PurchasesUpdatedListener registered with BillingClient
public void onPurchaseUpdated(BillingResult billingResult, @Nullable List<Purchase> purchases) {
  // check BillingResult
  // process returned Purchase list, e.g. grant entitlement
}

즉시 대체 비례 배분 모드의 경우 앱은 PurchasesUpdatedListener에서 새 구매를 수신합니다. 또한 구매는 BillingClient.queryPurchasesAsync()에서도 사용할 수 있습니다. 구매 토큰을 수신할 때는 새 구매 토큰 인증 시와 동일한 인증 프로세스를 따릅니다. Google Play 결제 라이브러리의 BillingClient.acknowledgePurchase() 또는 Google Play Developer API의 Purchases.subscriptions:acknowledge를 사용하여 이러한 구매를 확인해야 합니다.

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

지연된 대체 모드의 경우 앱은 원래 정기 결제 요금제 구매 및 업그레이드 또는 다운그레이드 성공 여부 상태와 함께 PurchasesUpdatedListener 호출을 수신합니다. 대체가 적용될 때까지 BillingClient.queryPurchasesAsync()는 원래 정기 결제 요금제의 구매를 계속 반환합니다. 새 요금제가 적용되면 queryPurchasesAsync()는 새로운 정기 결제의 구매 데이터를 반환하고 SUBSCRIPTION_RENEWED 알림이 보안 백엔드 서버로 전송됩니다. 대체가 지연된 경우 이 알림을 수신 대기하고 Purchases.subscriptions:acknowledge를 사용하여 구매를 확인하는 것이 좋습니다. 정기 결제 리소스의 linkedPurchaseToken을 사용하면 정기 결제 백엔드에서(해당하는 경우) 새 자격으로 업데이트해야 할 사용자를 결정할 수 있습니다. 사용자가 요금제 변경이 적용된 후 3일 이내에 앱을 열지 않을 수 있으므로 앱은 사용자가 앱을 열고 BillingClient.acknowledgePurchase()를 통해 확인하는 것에 의존해서는 안 됩니다.

무료 체험판 또는 신규 할인 가격 혜택으로 업그레이드

무료 체험판 자격요건 설정은 사용자가 업그레이드 또는 다운그레이드할 때 적용됩니다. Google Play Console에서 무료 체험판 자격요건 설정을 조정할 수 있습니다.

다음 내용을 참고하세요.

• 사용자가 앱에서 사용 가능한 모든 정기 결제와 관련하여 하나의 무료 체험판만 받을 수 있다면 사용자가 변경하려는 요금제에는 무료 체험판 또는 신규 할인 가격 혜택이 적용될 수 없습니다.
• 정기 결제 제품당 하나의 무료 체험판을 제공한다면 사용자가 변경하려는 요금제에는 무료 체험판 또는 신규 할인 가격이 적용될 수 있습니다.

다음 표에서는 새 요금제와 이전 요금제에 모두 무료 체험판이 포함되어 있으며 사용자가 무료 체험판 기간에 업그레이드할 때 각 비례 배분 모드의 동작을 설명합니다.

기본적으로 앱당 하나의 무료 체험판이 적용되는 경우 무료 체험판 전환이 작동하는 방식을 이해하려면 다음 시나리오를 생각해 보세요.

마리아는 Country Gardener 앱에서 온라인 콘텐츠를 정기적으로 결제하고 있습니다. 그리고 현재 텍스트 전용 콘텐츠의 Tier 1 버전을 매월 정기 결제하고 있습니다. 이 정기 결제 요금은 월 10달러이며, 마리아는 4월 1일에 정기 결제를 시작했습니다. 마리아는 정기 결제를 처음 시작한 사용자로 30일 무료 체험판 혜택을 누리고 있으며 이는 첫 번째 결제가 5월 1일로 예정되어 있음을 의미합니다.

4월 15일에 마리아는 동영상 업데이트가 포함되며 요금이 월 20달러인 Tier 2 정기 결제로 업그레이드하기로 했습니다. 이 두 번째 정기 결제에도 30일 무료 체험판 혜택이 있습니다.

다음 목록은 각 비례 배분 모드의 무료 체험판 전환 방식을 설명합니다.

• IMMEDIATE_WITH_TIME_PRORATION - 마리아는 Tier 2로 즉시 업그레이드됩니다. 마리아가 정기 결제 기간 중간에 업그레이드했으므로 월간 정기 결제 요금의 절반(월 10달러의 요금에서 15일분)은 새 정기 결제에 적용됩니다. 그러나 새 정기 결제 요금은 월 20달러이므로 15일의 잔액으로는 7.5일분만 결제할 수 있습니다. 마리아는 Tier 2에 대한 또 다른 무료 체험판을 사용할 수 없으므로 4월 22일부터 매월 20달러가 청구됩니다.
• IMMEDIATE_AND_CHARGE_PRORATED_PRICE - 시간 단위당 Tier 2 정기 결제 가격($20/월)이 시간 단위당 Tier 1 정기 결제 가격($10/월)보다 크므로 이 모드를 사용할 수 있습니다. 마리아의 Tier 1 정기 결제가 Tier 2로 즉시 업그레이드되며, 마리아는 무료 체험판 혜택을 잃게 됩니다. 마리아의 다음 결제일이 5월 1일이었으므로 4월 하반기의 요금으로 10달러가 오늘 청구되며, 이후 5월 1일부터 매월 20달러가 청구됩니다.
• IMMEDIATE_WITHOUT_PRORATION - 마리아의 Tier 1 정기 결제가 Tier 2로 즉시 업그레이드됩니다. 마리아는 4월 30일까지 무료 체험판 혜택을 유지하며 이제 Tier 2 콘텐츠에 액세스할 수 있습니다. 5월 1일부터 매월 20달러가 청구됩니다.
• DEFERRED - 마리아의 Tier 1 정기 결제는 다음 결제일인 5월 1일이 될 때까지 계속됩니다. 5월 1일에 Tier 2 정기 결제가 적용되며, 매월 1일에 마리아에게 20달러가 청구됩니다.
• IMMEDIATE_AND_CHARGE_FULL_PRICE - 마리아의 Tier 1 정기 결제가 Tier 2로 즉시 업그레이드되며, 마리아는 무료 체험판 혜택을 잃게 됩니다. 오늘 마리아에게 20달러가 청구됩니다. 마리아에게 무료 체험판 기간이 15일 남았으므로 다음 청구일은 지금으로부터 1개월에 15일을 더한 7월 1일이 됩니다. 7월 1일부터 매월 20달러가 청구됩니다.

다음 목록은 개발자가 정기 결제당 하나의 무료 체험판을 허용하는 경우의 전환 동작을 설명합니다.

• IMMEDIATE_WITH_TIME_PRORATION - 마리아는 Tier 2로 즉시 업그레이드됩니다. 마리아가 정기 결제 기간 중간에 업그레이드했으므로 월간 정기 결제 요금의 절반(월 10달러의 요금에서 15일분)은 새 정기 결제에 적용됩니다. 그러나 새 정기 결제 요금은 월 20달러이므로 15일의 잔액으로는 7.5일분만 결제할 수 있습니다. 마리아는 Tier 2에 대한 또 다른 무료 체험판을 사용할 수 있으므로 37.5일 동안에는 요금이 청구되지 않습니다. 5월 22일부터 매월 20달러가 청구됩니다.
• IMMEDIATE_AND_CHARGE_PRORATED_PRICE - 시간 단위당 Tier 2 정기 결제 가격($20/월)이 시간 단위당 Tier 1 정기 결제 가격($10/월)보다 크므로 이 모드를 사용할 수 있습니다. 마리아의 Tier 1 정기 결제가 Tier 2로 즉시 업그레이드되며, 마리아는 무료 체험판 혜택을 잃게 됩니다. 마리아의 다음 결제일이 5월 1일이었으므로 4월 하반기의 요금으로 10달러가 오늘 청구되며, 이후 5월 1일부터 매월 20달러가 청구됩니다.
• IMMEDIATE_WITHOUT_PRORATION - 마리아의 Tier 1 정기 결제가 Tier 2로 즉시 업그레이드됩니다. 마리아는 4월 30일까지 무료 체험판을 계속 이용할 수 있으며 이제 Tier 2에 액세스할 수 있습니다.
• DEFERRED - 마리아의 Tier 1 정기 결제는 다음 결제일인 5월 1일이 될 때까지 계속됩니다. 5월 1일에 Tier 2 정기 결제가 적용되며, 매월 1일에 마리아에게 20달러가 청구됩니다.
• IMMEDIATE_AND_CHARGE_FULL_PRICE - 마리아의 Tier 1 정기 결제가 Tier 2로 즉시 업그레이드되며, 마리아는 무료 체험판 혜택을 잃게 됩니다. 오늘 마리아에게 20달러가 청구됩니다. 마리아에게 무료 체험판 기간이 15일 남았으므로 다음 청구일은 지금으로부터 1개월에 15일을 더한 7월 1일이 됩니다. 7월 1일부터 매월 20달러가 청구됩니다.

비례 배분 권장사항

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

고객 관리

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

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

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

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

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

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

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

• 비례 배분 모드 IMMEDIATE_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일입니다.

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

정기 결제 가격 변경

정기 결제 기본 요금제 및 혜택의 가격을 변경할 수 있습니다. 예를 들어 연간 가격 조정이 필요한 디지털 제품이 있거나, 제품의 혜택 세트를 변경하고 이러한 가격 변경사항을 반영하려는 경우가 있을 수 있습니다.

Play Console을 사용하여 정기 결제 가격을 변경하는 방법에 관한 자세한 내용은 Play Console 고객센터의 문서를 참고하세요.

신규 구매의 가격 변경 관리

기본 요금제 또는 혜택의 가격을 변경하면 추가 조치를 취하지 않아도 모든 신규 구매에 관해 몇 시간 이내에 새 가격이 적용됩니다. 신규 구매는 다음 중 하나일 수 있습니다.

• 사용자가 현재 앱에서 정기 결제를 소유하고 있지 않습니다.
• 기존 자동 갱신 요금제를 이미 구매한 사용자가 더 긴 결제 기간이나 더 높은 서비스 등급과 같은 다른 요금제를 이제 구매합니다.
• 선불 요금제 사용자가 잔액 충전을 구매합니다.

신규 구매는 다른 구매와 마찬가지로 처리해야 합니다.

기존 자동 갱신 정기 결제 요금제 구매의 가격 변경 관리

자동 갱신 기본 요금제의 가격은 언제든지 변경할 수 있습니다. 기존 정기 결제 사용자는 기본적으로 영향을 받지 않습니다. 이러한 정기 결제 사용자는 기존 가격 사용자 집단에 배치되며 갱신 시 원래 기본 요금제 가격을 계속 지불하게 됩니다. 언제든지 사용자 집단을 종료하고 이러한 사용자를 현재 기본 요금제 가격으로 이전할 수 있습니다.

마찬가지로 특별 이벤트 및 개별 가격 책정 단계의 가격 변경은 기존 정기 결제 사용자에게 영향을 미치지 않습니다. 이러한 정기 결제 사용자는 정기 결제 상품 구매 시 표시된 가격을 계속 지불하게 됩니다.

기존 가격 사용자 집단 사용에 관한 자세한 내용은 Play Console 고객센터를 참고하세요.

Google Play Developer API로 정기 결제 가격 변경

프로그래매틱 방식으로 정기 결제 기본 요금제 가격을 변경하려면 monetization.subscriptions.patch 메서드를 사용하세요. 이 메서드는 변경되는 정기 결제 제품 구성과 함께 Subscription 객체를 수신합니다. 정기 결제의 basePlans 컬렉션에 있는 올바른 기본 요금제 아래의 RegionalBasePlanConfig 객체에서 새 가격을 설정합니다. 이는 대규모 카탈로그가 있고 짧은 기간 내에 모든 제품을 업데이트해야 하거나, 변경사항이 발생할 때 Google Play 결제 정기 결제 제품을 자동으로 변경하는 제품 카탈로그 관리 시스템이 있는 경우 매우 유용할 수 있습니다.

Play Console에서 기본 요금제 가격을 변경하려면 Play Console 고객센터를 참고하세요.

기존 가격 사용자 집단 종료

기존 가격 사용자 집단을 종료하면 이전 자동 갱신 기본 요금제 가격을 지불하는 사용자가 현재 기본 요금제 가격으로 전환됩니다. Play Console에서 기존 가격을 종료하려면 Play Console 고객센터를 참고하세요.

Google Play Developer API로 기존 가격 사용자 집단 종료

기존 가격 사용자 집단을 프로그래매틱 방식으로 종료하려면 monetization.subscriptions.basePlans.migratePrices 메서드를 사용하세요. 이 메서드는 이전 정기 결제 가격을 수신하는 정기 결제 사용자를 지정된 지역의 현재 기본 요금제 가격으로 이전합니다. 이 메서드는 제공된 타임스탬프보다 오래된 이전 가격을 현재 수신하고 있는 사용자에게 가격 변경 알림이 전송되도록 트리거합니다. 새로운 가격에 동의하지 않는 정기 결제 사용자는 다음 갱신 시 정기 결제가 종료됩니다.

가격 변경이 적용되는 시점

기존 가격 사용자 집단을 종료하면 이러한 사용자를 현재 기본 요금제 가격으로 전환하는 프로세스가 시작됩니다. 가격 인상과 가격 인하의 경우 모두 Play에서는 이러한 사용자에게 예정된 가격 변경을 알립니다.

가격 인하

현재 기본 요금제 가격이 더 낮으면 Play에서는 이메일을 통해 사용자에게 알리며 사용자는 다음 갱신일에 먼저 더 낮은 기본 요금제 가격을 지불합니다.

가격 인상

현재 기본 요금제 가격이 더 높은 경우 Play에서는 이메일과 푸시 알림을 통해 사용자에게 알리며 37일의 사전 알림 기간(대기 기간 7일 + 사용자에게 알림이 제공되는 30일) 후 첫 갱신일에 더 높은 요금이 청구됩니다.

사용자는 새로운 가격이 처음 청구되기 전에 Play 스토어의 사전 알림 기간에 더 높은 가격에 동의해야 합니다. 그러지 않으면 Play에서 자동으로 사용자의 정기 결제를 취소합니다. Play에서는 첫 번째 청구일 1일 전과 30일 전에 이메일과 푸시 알림을 통해 사용자에게 알립니다.

사용자에게 가격 변경 알리기

기본 요금제의 가격을 변경하거나 기존 사용자 집단 가격을 종료할 때마다 기존 정기 결제 사용자에게 알려야 합니다. 가격 인상의 경우 사용자에게 사전 알림을 제공하고 가격 인상에 동의해야 한다고 알려야 합니다.

정기 결제 가격을 인상할 경우 Google Play에서 직접 알림을 시작하기 전에 기존 사용자 집단을 종료한 후 최소 7일 동안 기존 정기 결제 사용자에게 가격 변경에 관해 알릴 수 있습니다. 이 기간 동안 원래 가격으로 다시 변경하여 대기 중인 가격 인상을 효과적으로 취소할 수 있습니다. Play에서 알림을 보내기 전에 영향을 받는 사용자에게 알릴 수도 있습니다.

앱 내에서 영향을 받는 사용자에게 알리고 사용자가 새로운 가격을 쉽게 수락할 수 있도록 Play 스토어 정기 결제 화면으로 연결되는 딥 링크를 제공하는 것이 좋습니다.

사용자는 Play 스토어 정기 결제 화면에서 가격 인상을 검토할 수 있습니다. 여기에는 그림 13과 같은 대화상자가 표시됩니다.

예

예 1(월간 정기 결제): 3월 3일에 SuperStreamz는 기존 가격 사용자 집단을 종료하고 프리미엄 동영상 스트리밍 정기 결제인 SuperStreamz Pro의 가격을 인상합니다. 1달러를 내던 기존 가격 사용자 집단의 사용자를 현재 2달러를 내는 기본 요금제 가격의 사용자 집단으로 이동합니다. 가격 변경 시행일은 4월 9일(3월 3일로부터 37일 후)입니다.

• 윤아는 기존 정기 결제 사용자이며 다음 갱신일이 3월 5일입니다. 시행일 후 첫 번째 갱신일이 5월 5일이므로 3월 5일과 4월 5일에는 이전 가격(1달러)으로 갱신됩니다. 5월 5일에 다시 갱신할 때 새로운 가격(2달러)이 청구됩니다. Google Play에서는 새로운 가격이 적용되는 첫 번째 갱신일로부터 30일 전인 4월 5일에 가격 변경에 관해 윤아에게 알리기 시작합니다.

• 정우는 기존 정기 결제 사용자이며 다음 갱신일이 3월 29일입니다. 가격 변경이 아직 시행되지 않았으므로 3월 29일에는 이전 가격(1달러)으로 갱신됩니다. 4월 29일에 다시 갱신할 때 새로운 가격(2달러)이 청구됩니다. 새 가격이 적용되는 첫 번째 갱신일로부터 30일 전인 3월 30일에 가격 변경 알림을 받기 시작합니다.

예 2(3개월 정기 결제): 3월 3일에 FindMyLove는 기존 가격 사용자 집단을 종료하고 FindMyLove Premium의 3개월 수수료를 1달러에서 기본 요금제 2달러로 인상합니다. 가격 변경 시행일은 4월 9일(3월 3일로부터 37일 후)입니다.

• 윤아는 기존 정기 결제 사용자이며 다음 갱신일이 3월 5일입니다. 가격 변경이 아직 시행되지 않았으므로 윤아는 이전 가격(1달러)으로 갱신됩니다. 6월 5일에 다시 갱신할 때 새로운 가격(2달러)이 청구됩니다. 새로운 가격이 적용되는 첫 번째 갱신일로부터 30일 전인 5월 6일에 가격 변경 관련 알림을 받기 시작합니다.

• 정우는 기존 정기 결제 사용자이며 다음 갱신일이 4월 11일입니다. 갱신일이 시행일 후이므로 새 가격(2달러)으로 갱신됩니다. 새 가격이 적용되는 첫 번째 갱신일로부터 30일 전인 3월 12일에 가격 변경 관련 알림을 받기 시작합니다.

예 3(주간 정기 결제): 3월 3일 CutePetsNews가 Weekly Dog Alerts 주간 요금을 1달러에서 2달러로 인상하기 위해 기존 가격 사용자 집단을 종료합니다. 가격 변경 시행일은 4월 9일입니다.

• 윤아는 기존 정기 결제 사용자이며 다음 주간 갱신일이 3월 6일입니다. 3월 6일과 3월 13일, 3월 20일, 3월 27일, 4월 3일에는 이전 가격으로 갱신됩니다(가격 변경이 아직 시행되지 않았으므로 1달러). 4월 10일에 다시 갱신할 때 새로운 가격(2달러)이 청구됩니다. 새로운 가격이 적용되는 첫 번째 갱신일로부터 30일 전인 3월 11일에 가격 변경 관련 알림을 받기 시작합니다.

예 4(월간 정기 결제, 여러 가격 변경): 이 예에서는 여러 건의 가격 변경이 처리되는 방식을 보여줍니다.

3월 3일에 SuperStreamz는 프리미엄 동영상 스트리밍 구독인 SuperStreamz Pro의 가격 이전을 트리거하여 가격을 월 1달러에서 2달러로 인상했습니다. 3월 10일에 개발자가 2차 가격 이전을 트리거하여 가격을 월 3달러로 인상했습니다.

첫 번째 가격 변경 시행일은 4월 9일(3월 3일로부터 37일 후)입니다. 두 번째 가격 변경 시행일은 4월 16일(3월 10일로부터 37일 후)입니다.

• 윤아의 다음 갱신일은 3월 5일입니다. 시행일 후 첫 번째 갱신일이 5월 5일이므로 3월 5일과 4월 5일에는 이전 가격(1달러)으로 갱신됩니다. 5월 5일에 다시 갱신할 때 새로운 가격(2달러)이 청구됩니다. 7일 고정 기간 내에 가격 변동이 발생했으므로 두 번째 가격 변경에 관한 알림만 받습니다. 새로운 가격이 적용되는 첫 번째 갱신일로부터 30일 전인 4월 5일에 가격 변경 관련 알림을 받기 시작합니다.

가격 변경에 관한 사용자 확인 처리

사용자가 정기 결제 가격 인상을 수락하면 유형이 SUBSCRIPTION_PRICE_CHANGED_CONFIRMED인 SubscriptionNotification을 수신합니다. 결정 가격이 인하되거나 가격 인상이 갱신되면 유형이 SUBSCRIPTION_RENEWED인 SubscriptionNotification을 수신합니다. 이 알림은 다른 갱신과 동일하게 처리해야 합니다.

가격 인상이 거부되는 경우 처리

사용자가 더 높은 가격으로 갱신해야 하기 전에 가격 인상을 수락하지 않은 경우 자동으로 정기 결제가 취소되며 개발자는 유형이 SUBSCRIPTION_CANCELED인 SubscriptionNotification을 수신합니다. 이 이벤트는 취소에 설명된 대로 처리하면 됩니다.

실수로 인한 가격 변경

실수로 정기 결제 가격을 변경했다면 즉시 변경을 취소하세요. 7일 이내에 가격을 되돌린다면, 실수로 인한 가격 변경 관련 알림이 기존 정기 결제 사용자에게 표시되지 않습니다. 신규 정기 결제 사용자에게는 첫 번째 가격 변경과 변경을 취소한 사이의 시간 동안 실수로 인한 변경 가격이 표시될 수 있습니다.

연이은 두 번의 가격 변경 처리

7일 이내에 정기 결제 가격을 두 번 변경하면 영향을 받는 사용자는 최신 가격 변경에만 동의하면 됩니다. 예를 들어 가격 인상으로 기존 가격 사용자 집단을 종료한 후 다시 가격을 변경하면 자격이 있는 사용자는 더 이상 첫 번째 가격 변경에 응답할 필요가 없습니다. 이제 두 번째 가격 변경만 적용되기 때문입니다.

한 번에 하나의 가격 변경만 실행해야 합니다. 테스트 목적으로 사용자 가격을 변경하면 안 됩니다.

결제 거부 처리

결제 주기가 끝날 때 결제 문제가 있는 경우 Google은 정기 결제를 취소하기 전에 한동안 정기 결제를 주기적으로 갱신하려고 합니다. 갱신 재시도는 최대 30일에 지정된 유예 기간을 합한 기간 만큼 지속될 수 있습니다. 또한 이 기간 동안 Google은 사용자에게 결제 수단 업데이트를 요청하는 이메일과 알림도 전송합니다.

결제가 거부되면 먼저 정기 결제에 유예 기간이 적용됩니다(사용 설정된 경우). 유예 기간 중에도 사용자는 계속해서 정기 결제 항목을 이용할 수 있어야 합니다.

유예 기간이 종료되면 정기 결제는 최대 30일 동안 계정 보류 상태가 됩니다. 계정 보류 기간에는 정기 결제 항목에 대한 액세스를 차단할 수 있습니다.

결제 거부 과정에서 정기 결제 복구 가능성을 극대화하기 위해 사용자에게 결제 문제를 알리고 문제 해결을 요청할 수 있습니다.

유예 기간 및 계정 보류 섹션에 설명된 대로 직접 이 작업을 실행하거나 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.
                }
            }
        });