KappS 지식 베이스 · FAQ

Google Play 결제 라이브러리 버전 요건

FAQ 수익화 및 결제

1. Google은 Play 결제 라이브러리에 2년 지원 종료 주기를 적용합니다. 모든 메이저 버전은 출시 후 2년간 지원되며, 그 이후에는 Play Console이 해당 버전으로 컴파일된 새 빌드를 더 이상 허용하지 않습니다. 공개된 표(https://developer.android.com/google/play/billing/deprecation-faq)는 다음과 같습니다. 5.x 신규 앱 및 업데이트 최종 기한 2024-08-31(연장 신청 마감 2024-11-01), 6.x 2025-08-31 / 2025-11-01, 7.x 2026-08-31 / 2026-11-01, 8.x 2027-08-31 / 2027-11-01. 실제로는 2026년 8월 31일부터 Play 결제를 사용하는 모든 신규 앱과 앱 업데이트는 결제 라이브러리 8.0.0 이상으로 빌드해야 합니다.

2. 정확한 문구가 중요합니다. Google의 지원 종료 FAQ는 이번 지원 종료가 "새 앱과 업데이트가 구버전 Play Billing Library를 사용하는 것만 막습니다. 지원 종료된 버전의 라이브러리를 사용하는 기존 앱은 예상대로 계속 작동합니다."라고 밝힙니다. 이는 게시 단계의 제한이지 런타임 킬 스위치가 아니므로, 이미 게시된 v7 빌드는 계속 결제를 처리합니다. 잃는 것은 보안 패치나 재빌드를 포함해 새로운 무엇이든 게시할 수 있는 능력이므로, 계속 유지 관리할 앱은 반드시 이관해야 합니다.

3. 연장은 요청 사항이며 자동 유예 기간이 아닙니다. 7.x 계열의 연장 요청 마감 기한은 2026-11-01이고, 요청은 원래 마감 기한 전에 접수해야 합니다. Play Console은 앱이 지원 종료된 버전에 올라가면 앱 페이지의 경고와 정책 상태 페이지의 받은편지함 메시지로 자격 여부를 알려주며, 연장 양식은 해당 경고나 이슈의 상세 페이지에 있습니다(https://developer.android.com/google/play/billing/release-notes).

4. 탐지 함정: Play Console은 라이브러리가 매니페스트에 주입하는 com.google.android.play.billingclient.version 항목에서 라이브러리 버전을 읽습니다. 멀티 모듈 프로젝트의 매니페스트 병합 과정에서 이 항목이 누락될 수 있으며, 최종 병합된 매니페스트에 이 항목이 없으면 Play Console은 어떤 버전을 출시했는지 알 수 없어 경고가 귀하에게 도달하지 않을 수 있습니다. 침묵을 믿지 말고 병합된 매니페스트를 확인하세요.

5. v8에서 깨지는 항목(교체하기 전까지는 모두 컴파일 오류입니다): querySkuDetailsAsync() -> queryProductDetailsAsync(QueryProductDetailsParams, ProductDetailsResponseListener); 인수 없는 enablePendingPurchases() -> enablePendingPurchases(PendingPurchasesParams); queryPurchasesAsync(String skuType, PurchasesResponseListener) 오버로드 -> queryPurchasesAsync(QueryPurchasesParams, PurchasesResponseListener); queryPurchaseHistoryAsync()는 클라이언트 측 대체가 없으므로 구매 내역은 서버 측에서 추적해야 합니다. BillingClient.Builder.enableAlternativeBilling(), AlternativeBillingListener, AlternativeChoiceDetails -> enableUserChoiceBilling(UserChoiceBillingListener), UserChoiceBillingListener, UserChoiceDetails; 그리고 ProductDetailsResponseListener.onProductDetailsResponse()는 이제 조회된 상품과 조회되지 않은 상품을 상품별 상태 코드로 구분하는 QueryProductDetailsResult를 반환합니다. 용어도 바뀌었습니다. 문서에서 "인앱 상품"이라 부르던 것은 이제 "일회성 상품"이며, v8에서는 구독이 이미 지원하던 방식대로 여러 구매 옵션과 혜택을 지원합니다.

6. 실무 체크리스트: 8.0.0이 아니라 8.x 라인의 최신 패치를 고정하세요. 배포 전 라이선스 테스터로 구매, 복원, 대기 중 구매 경로를 다시 테스트하고, 구매 토큰은 계속 서버 측에서 검증하세요. 그리고 이를 일회성이 아닌 연간 유지보수 항목으로 다루세요. 8.x 라인 자체도 2027-08-31에 신규 업로드가 지원 종료되며, 2027-11-01까지 연장이 최후의 안전장치입니다. 각 이관을 마감 기한보다 한 분기 앞서 일정에 넣는 것만이 출시가 막히지 않는 유일한 방법입니다.