이 문서에서는 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
가 삭제되었습니다.
setOldSkuPurchaseToken
를setOldPurchaseToken
로 업데이트합니다.setReplaceProrationMode
를setSubscriptionReplacementMode
로 업데이트합니다.setReplaceSkusProrationMode
를setSubscriptionReplacementMode
로 업데이트합니다.
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
가 삭제되었습니다.
setOldSkuPurchaseToken
를setOldPurchaseToken
로 업데이트합니다.setReplaceProrationMode
를setSubscriptionReplacementMode
로 업데이트합니다.setReplaceSkusProrationMode
를setSubscriptionReplacementMode
로 업데이트합니다.
삭제된 개발자 제공 결제 API 처리
BillingClient.Builder.enableAlternativeBilling
, AlternativeBillingListener
, AlternativeChoiceDetails
를 삭제했습니다.
개발자는 리스너 콜백에서 대신 UserChoiceBillingListener
및 UserChoiceDetails
와 함께 BillingClient.Builder.enableUserChoiceBilling()
를 사용해야 합니다.
선택적 변경사항
PBL 7에는 두 가지 새로운 선택적 API가 포함됩니다.
선불 요금제의 대기 중인 구매 지원
정기 결제 및 대기 중인 거래 처리 가이드를 참조하세요.
가상 할부 정기 결제
이러한 변경사항을 앱에 통합하는 방법에 관한 자세한 내용은 할부 정기 결제 통합 가이드를 참고하세요.