버전 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가 포함됩니다.

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

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

가상 할부 정기 결제

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