버전 5 또는 6에서 Google Play 결제 라이브러리 7로 이전

이 문서에서는 Google Play 결제 라이브러리 5 또는 6에서 Google Play 결제 라이브러리 7로 이전하는 방법과 새로운 선택적 정기 결제 기능과 통합하는 방법을 설명합니다.

버전 7.0.0의 전체 변경사항 목록은 출시 노트를 참고하세요.

개요

Google Play 결제 라이브러리 7에서는 기존 정기 결제 기능의 결제 처리가 개선됩니다. 이러한 선택적 개선사항은 할부 요금제로 결제하는 기능과 선불 정기 결제의 대기 중인 구매를 지원합니다.

이전 버전과 호환되는 Play 결제 라이브러리 업그레이드

모든 새로운 Google Play 결제 라이브러리 7 API는 선택사항이며 개발자는 업데이트하기 위해 API 변경사항을 구현할 필요가 없습니다.

이전하려면 출시 노트 및 이 이전 가이드의 뒷부분에 설명된 대로 API 참조를 업데이트하고 앱에서 특정 API를 삭제해야 합니다.

PBL 5에서 PBL 7로 업그레이드

다음 섹션에서는 PBL 5에서 PBL 7로 업그레이드하는 방법을 설명합니다.

Google Play 결제 라이브러리 업데이트

앱의 build.gradle 파일에서 Play 결제 라이브러리 종속 항목 버전을 업데이트합니다.

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

그런 다음 다음 섹션에 설명된 대로 API 참조를 업데이트합니다.

사용자의 정기 결제 구매 변경

Play 결제 라이브러리 5 및 이전 버전에서는 업그레이드나 다운그레이드와 같은 사용자의 정기 결제 구매 변경사항을 적용하는 용도로 ProrationMode를 사용했습니다. 이 API는 삭제되고 ReplacementMode로 대체되었습니다.

정기 결제 가격 변경 처리

이전에 지원 중단된 launchPriceConfirmationFlow API를 삭제했습니다. 대안을 확인하려면 가격 변경 가이드를 참고하세요.

정기 결제 관련 API 변경사항 처리

이전에 지원 중단된 API인 setOldSkuPurchaseToken, setReplaceProrationMode, setReplaceSkusProrationMode가 삭제되었습니다.

Play 결제 라이브러리 오류 처리

새 NETWORK_ERROR 코드는 사용자 기기와 Google Play 시스템 간의 네트워크 연결에 문제가 있음을 나타냅니다.

SERVICE_TIMEOUT 및 SERVICE_UNAVAILABLE 코드도 업데이트되었습니다.

자세한 내용은 BillingResult 응답 코드 처리를 참고하세요.

대기 중인 거래 처리

Play 결제 라이브러리는 더 이상 대기 중인 구매에 대해 주문 ID를 생성하지 않습니다. 대기 중인 구매의 주문 ID는 구매가 PURCHASED 상태로 변경된 후에 생성됩니다. 통합에서 거래가 완전히 완료된 후에만 주문 ID를 사용해야 합니다. 레코드에서는 계속해서 구매 토큰을 사용할 수 있습니다.

대기 중인 구매 처리에 관한 자세한 내용은 Play 결제 라이브러리 통합 가이드 및 구매 수명 주기 관리 가이드를 참고하세요.

삭제된 개발자 제공 결제 API 처리

BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener, AlternativeChoiceDetails를 삭제했습니다. 개발자는 리스너 콜백에서 UserChoiceBillingListener 및 UserChoiceDetails 대신 BillingClient.Builder.enableUserChoiceBilling()를 사용해야 합니다.

이 업데이트는 동작 변경사항 없이 지원 중단된 API의 이름을 변경하는 것입니다.

선택적 변경사항

PBL 7에는 두 가지 새로운 선택적 API가 포함되어 있습니다.

선불 요금제의 대기 중인 구매 지원

정기 결제 및 대기 중인 거래 처리 가이드를 참고하세요.

가상 할부 정기 결제

할부 정기 결제 통합 가이드를 참고하세요.

PBL 6에서 PBL 7로 업그레이드

다음 섹션에서는 PBL 6에서 PBL 7로 업그레이드하는 방법을 설명합니다.

Google Play 결제 라이브러리 업데이트

앱의 build.gradle 파일에서 Play 결제 라이브러리 종속 항목 버전을 업데이트합니다.

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

그런 다음 다음 섹션에 설명된 대로 API 참조를 업데이트합니다.

정기 결제 관련 API 변경사항 처리

이전에 지원 중단된 API인 setOldSkuPurchaseToken, setReplaceProrationMode, setReplaceSkusProrationMode가 삭제되었습니다.

삭제된 개발자 제공 결제 API 처리

BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener, AlternativeChoiceDetails를 삭제했습니다. 개발자는 리스너 콜백에서 UserChoiceBillingListener 및 UserChoiceDetails 대신 BillingClient.Builder.enableUserChoiceBilling()를 사용해야 합니다.

선택적 변경사항

PBL 7에는 두 가지 새로운 선택적 API가 포함되어 있습니다.

선불 요금제의 대기 중인 구매 지원

정기 결제 및 대기 중인 거래 처리 가이드를 참고하세요.

가상 할부 정기 결제

이러한 변경사항을 앱에 통합하는 방법에 관한 자세한 내용은 할부 정기 결제 통합 가이드를 참고하세요.