이제 모든 Google Play 업데이트에 Play Billing Library 8이 필요하며, 환불 추적은 서버로 옮겨갑니다
Play Billing Library 7에 대한 Google의 연장 기한이 2026년 11월 1일에 끝나, 신규 앱과 업데이트에는 버전 8 이상이 필요합니다. 버전 8은 queryPurchaseHistory()를 삭제했기 때문에, 환불되거나 소비된 구매는 서버에서 추적해야 합니다. 무엇이 바뀌었고, 마이그레이션이 늦어지면 어떤 비용이 드는지 정리했습니다.

핵심 요약
- Google의 지원 중단 일정표는 Play Billing Library 7로 신규 앱과 업데이트를 출시할 수 있는 마지막 날을 2026년 8월 31일로 정했고, 연장은 2026년 11월 1일에 끝났습니다. 따라서 이제 모든 Google Play 업데이트에는 Play Billing Library 8 이상이 필요합니다.
- 이미 Play Billing Library 7로 출시된 앱은 계속 작동합니다. Google에 따르면 지원 중단은 신규 앱과 업데이트만 막을 뿐, 기존 설치에는 영향을 주지 않습니다.
- Play Billing Library 8은 queryPurchaseHistory()를 삭제했고, Google이 제시하는 대안은 서버 쪽에 있습니다. 소비된 구매는 자체 백엔드에서 추적하고, 환불되거나 취소된 구매는 Voided Purchases API에서 가져와야 합니다.
- Google Play Voided Purchases API는 최근 30일 이내의 무효화된 구매만 보여주며, 앱당 하루 6,000회, 임의의 30초 동안 30회까지만 조회할 수 있습니다.
- 앱이 3일 안에 구매를 확인하지 않으면 Google Play는 여전히 자동으로 환불하고 사용 권한을 회수합니다. Play Billing Library 8 마이그레이션이 잘못되면 모든 판매에서 이 일이 벌어질 수 있습니다.
- Google Play의 지불 거절 검토는 개발자에게 증거를 요구하는 유일한 Android 환불 절차입니다. PendingRefundReviewNotification을 받은 뒤 24시간 안에 orders.reviewrefund로 답해야 합니다.
- 2026년 8월 3일 이후에 접수된 Google Play 주문의 경우, 지불 거절에서 질 때마다 개발자가 구매 금액(Play 서비스 수수료 제외)과 은행의 지불 거절 수수료를 부담합니다.
Google Play에서 판매하는 모든 Android 앱은 이제 다음 업데이트에 Play Billing Library 8 이상을 탑재해야 합니다. 버전 7의 신규 앱 및 업데이트 기한은 2026년 8월 31일이었고, 마지막 연장도 2026년 11월 1일에 끝났습니다. 날짜는 Google의 지원 중단 FAQ에 있는 표에 나와 있으며, 알림은 Play Console의 정책 상태 페이지에 경고로 표시됩니다.
대부분의 팀에게는 종속 항목 하나를 올리고 메서드 이름 몇 개를 바꾸는 일입니다. 하지만 환불에 관해서는 그 이상입니다. Play Billing Library 8은 앱이 과거 구매를 돌아볼 수 있게 해주던 유일한 클라이언트 호출을 삭제했습니다. 이제부터 사용자가 무엇을 사고, 무엇을 소비하고, 무엇을 환불받았는지 알고 싶다면 서버가 기억해야 합니다.
Play Billing Library 8 기한이 실제로 막는 것
Google은 각 라이브러리 버전에 2년의 수명을 줍니다. 지원 중단은 신규 앱과 업데이트만 막습니다. Google FAQ에 따르면 기존 앱은 계속 작동하고, 더 이상 관리하지 않는 APK는 업데이트할 필요가 없습니다. 그러니 손을 놓은 앱은 오늘 아무 문제도 생기지 않습니다. 문제가 생기는 날은 수정 사항이나 새 가격, 새 페이월을 출시하려는 날입니다.
| 라이브러리 버전 | 신규 앱 및 업데이트 기한 | 연장 기한 |
|---|---|---|
| 6 | 2025년 8월 31일 | 2025년 11월 1일 |
| 7 | 2026년 8월 31일 | 2026년 11월 1일 |
| 8 | 2027년 8월 31일 | 2027년 11월 1일 |
| 9 | 2028년 8월 31일 | 2028년 11월 1일 |
버전 8.0.0은 2025년 6월 30일에 출시되었습니다. 버전 9.0.0은 2026년 5월 19일에 뒤따랐습니다. 지금 마이그레이션한다면 8에서 멈추지 말고 바로 9로 가는 편이 1년을 더 벌어줍니다.
Play Billing Library 8이 환불에 중요한 이유
가장 큰 삭제는 queryPurchaseHistory()입니다. 버전 7에서 지원 중단되었고 버전 8.0.0에서 삭제되었습니다. Google의 마이그레이션 안내는 이 메서드가 하던 일을 세 가지로 나누는데, 그중 기기에 남는 것은 하나뿐입니다.
| queryPurchaseHistory()를 어디에 썼는지 | Google이 지금 권장하는 방법 | 실행 위치 |
|---|---|---|
| 활성 구매와 대기 중인 구매 | queryPurchasesAsync() | 기기 |
| 소비된 일회성 구매 | 자체 기록 | 자체 서버 |
| 환불, 취소 또는 지불 거절된 구매 | Voided Purchases API | 자체 서버 |
| 사용자의 전체 구매 내역 | 자체 기록 | 자체 서버 |
Android에서 소비성 구매를 여전히 복원할 수 있나요?
클라이언트에서는 안 됩니다. queryPurchasesAsync()는 활성 구매만 반환하므로, 소비된 크레딧 팩이나 다 쓴 보석 묶음은 이를 통해 절대 돌아오지 않습니다. 사용자가 앱을 다시 설치하고 코인이 어디 갔냐고 묻는다면, 답은 구매 시점에 남겨 둔 장부에서 나와야 합니다. 구매 내역을 무료 백업처럼 기대던 앱은 그 백업을 잃었습니다.
이제 환불은 어떻게 알 수 있나요?
서버 쪽 경로가 두 가지 있습니다. 실시간 개발자 알림은 VoidedPurchaseNotification을 보내며, 여기에는 구매 토큰, 주문 ID, 상품 유형, 그리고 환불 유형이 담깁니다. 환불 유형은 전액 환불 아니면 수량 기반 부분 환불입니다. Voided Purchases API를 쓰면 같은 이벤트를 기간별로 가져올 수 있어, 놓친 것을 메우는 안전장치가 됩니다.
이 조회 API에는 엄격한 한계가 있습니다. 최근 30일 이내의 무효화된 구매만 보여줍니다. 앱마다 하루 6,000회, 임의의 30초 동안 30회까지만 조회할 수 있습니다. 게다가 회수 옵션 없이 개발자가 처리한 환불은 아예 반환되지 않습니다. 서버가 5주 동안 멈추면 다시는 가져올 수 없는 환불 기록을 잃게 됩니다.

개발자가 여전히 의견을 낼 수 있는 환불
환불 추적을 서버로 옮긴다고 환불에 대한 통제권이 늘어나지는 않습니다. Google Play 환불은 거의 전부 개발자 없이 결정됩니다. 셀프 서비스 환불, 고객 지원 환불, 취소, 그리고 확인되지 않은 구매의 자동 환불이 그렇습니다. 개발자는 무효화된 구매 알림을 통해 사후에야 알게 됩니다.
예외는 지불 거절 검토입니다. 구매자가 개발자의 의견이 필요한 지불 거절을 제기하면 Google은 PendingRefundReviewNotification을 보냅니다. Google에 따르면 24시간 안에 orders.reviewrefund를 호출해 환불 의견과 사용 증거로 답해야 합니다. 그 증거는 새 라이브러리가 보관을 강요하는 바로 그 서버 기록에서 나옵니다. 복원을 위해 장부를 관리하는 팀이라면 답하는 데 필요한 것을 이미 갖추고 있습니다.
마이그레이션 지연이 치르는 금전적 비용
직접적인 위험은 3일 규칙입니다. 앱이 3일 안에 구매를 확인하지 않으면 Google Play는 자동으로 환불하고 사용 권한을 회수합니다. 대기 중인 구매는 상태가 PENDING에서 PURCHASED로 바뀐 시점부터 시간이 흐릅니다. 마이그레이션 중에 연결 로직, 새 queryProductDetailsAsync() 리스너, 대기 중인 구매 설정 중 하나라도 망가지면, 판매는 계속되는데 확인만 멈출 수 있습니다. 그 공백 동안의 모든 주문은 전액 환불되고, 사용자는 이미 돈을 낸 만큼 받아 간 상태입니다.
바로 여기서 손해가 납니다. 환불된 이미지 크레딧 팩도 생성할 때마다 GPU 시간은 이미 썼습니다. 환불된 AI 요금제도 유료 API 호출은 이미 실행됐습니다. 환불된 저장 공간 요금제도 비용을 내는 디스크는 이미 채워졌습니다. 환불된 후원금도 크리에이터 정산으로 이미 나갔습니다. 환불은 매출을 구매자에게 돌려주고, 이런 청구서는 개발자에게 남깁니다.
지불 거절 비용도 커졌습니다. Google 고객센터에 따르면 2026년 8월 3일 이후에 접수된 주문의 경우, 개발자가 구매 금액(Play 서비스 수수료 제외)에 더해 은행의 지불 거절 수수료까지 부담합니다. Google은 자사 서비스 수수료만 계속 부담합니다. 실제 사용 데이터로 24시간 안에 지불 거절 검토에 답하지 못하는 앱은 매번 그 금액 전부를 냅니다.
매출을 지키는 마이그레이션 체크리스트
- 종속 항목을 Play Billing Library 8 또는 9로 올리고
queryPurchaseHistory(),querySkuDetailsAsync(), 인수 없는enablePendingPurchases()를 제거합니다. queryProductDetailsAsync()리스너를 업데이트합니다. 버전 8부터는 가져오지 못한 상품도 상태 코드와 함께 반환합니다.enableAutoServiceReconnection()을 켜서 결제 연결이 끊겨도 구매 처리가 멈추지 않게 합니다.onResume()에서queryPurchasesAsync()를 호출해, 앱이 닫혀 있는 동안 완료된 구매도 3일 안에 확인되도록 합니다.- 모든 구매 토큰, 주문 ID, 소비 내역을 서버에 기록하고 자체 계정 ID와 연결합니다.
- 실시간 개발자 알림을 구독하고
VoidedPurchaseNotification과PendingRefundReviewNotification을 모두 처리합니다. - 안전망으로 Voided Purchases API 동기화를 매일 실행하되, 30일 기간과 하루 6,000회 조회 한도 안에서 여유 있게 운영합니다.
RefundHalt는 Google Play의 무효화된 구매 알림과 지불 거절 검토 알림을 수신하고, 24시간 안에 실제 사용 데이터로 orders.reviewrefund를 통해 각 검토에 답하며, 앱이 더 이상 기기에 요청할 수 없는 환불 내역을 보관합니다.
자주 묻는 질문
- 지금 Play Billing Library 8을 꼭 써야 하나요?
- 네. Google Play 결제로 판매하는 신규 앱이나 업데이트라면 필요합니다. Google의 지원 중단 일정표는 버전 7의 기한을 2026년 8월 31일로 정했고, 연장은 2026년 11월 1일에 끝났습니다. 버전 8이나 더 새로운 버전 9를 사용할 수 있습니다.
- 기존 앱이 아직 Play Billing Library 7을 쓰면 작동이 멈추나요?
- 아니요. Google에 따르면 기존 앱은 계속 작동하고, 더 이상 관리하지 않는 APK는 업데이트할 필요가 없습니다. 지원 중단은 지원되지 않는 버전을 쓰는 신규 앱이나 업데이트의 게시만 막습니다.
- Play Billing Library 8에서 queryPurchaseHistoryAsync는 무엇으로 대체되었나요?
- 기기에서 같은 일을 하는 것은 없습니다. Google은 활성 구매와 대기 중인 구매에는 queryPurchasesAsync()를 쓰고, 소비된 구매는 자체 서버에서 추적하며, 취소되거나 환불된 구매에는 Voided Purchases API를 쓰라고 안내합니다.
- Google Play Voided Purchases API는 얼마나 과거까지 조회할 수 있나요?
- 30일입니다. Google에 따르면 이 API는 최근 30일 동안 발생한 무효화된 구매만 보여줄 수 있으며, 앱당 하루 6,000회, 임의의 30초 동안 30회로 조회를 제한합니다.
- 앱이 구매를 확인하지 않으면 Google Play가 환불하나요?
- 네. 구매가 3일 안에 확인되지 않으면 사용자는 자동으로 환불을 받고 Google Play는 해당 구매를 취소합니다. 대기 중인 구매는 상태가 PENDING에서 PURCHASED로 바뀐 시점부터 3일이 시작됩니다.
출처 및 추가 자료
- Android Developers: Play Billing Library deprecation FAQ
- Android Developers: Play Billing Library release notes
- Android Developers: Migrate to Play Billing Library 8
- Android Developers: Query purchase history alternatives
- Android Developers: Integrate the Google Play Billing Library into your app
- Android Developers: Real-time developer notifications reference
- Google Play Developer API: Voided Purchases API
- Play Console Help: Chargeback cost sharing for orders after August 3, 2026
RefundHalt
App Store와 Google Play 환불 자동 처리
계속 읽기
브라질이 아이들에게 여전히 루트박스를 파는 게임을 점검하기 시작했고, 그 청구서는 루트박스 환불로 날아옵니다
브라질 법무부가 연령 확인 없이 루트박스를 판매하는 게임 6종을 모니터링해 달라고 데이터 보호 당국에 요청했습니다. 법이 무엇을 요구하는지, Apple과 Google이 이미 무엇을 요구하는지, 그리고 상자가 이미 열린 상태에서 루트박스 환불을 어떻게 산정하고 처리할지 정리합니다.
실수로 인한 인앱 결제는 이길 수 없는 환불입니다. 해결책은 구매 화면에 있습니다
실수로 인한 인앱 결제는 두 스토어 모두에서 환불로 돌아오고, 어떤 사용 데이터도 그 탭이 의도된 것이었음을 증명하지 못합니다. Apple과 Google이 이를 어떻게 분류하는지, 각 건이 컴퓨팅 비용과 정산금에서 얼마의 손실을 내는지, 그리고 결제가 발생하기 전에 막는 구매 화면 설계를 알아봅니다.