Google Play 서비스 계정 권한이 주문을 환불할 수 있는 주체를 결정하므로, 작동하는 최소한의 권한만 부여하세요
Play Console 권한 하나만 있으면 서비스 계정이 모든 주문을 환불하고 모든 구독을 취소할 수 있습니다. 환불 도구에 실제로 필요한 Google Play 서비스 계정 권한, 유출된 키가 각 스토어에서 할 수 있는 일, 그리고 키의 범위를 제한하고 교체하고 폐기하는 방법을 정리했습니다.

핵심 요약
- Google Play의 Manage orders and subscriptions(주문 및 구독 관리) 권한을 가진 사람은 주문을 조회하고, 주문을 환불하고, 구독을 취소할 수 있습니다. 따라서 이 권한을 가진 서비스 계정은 구매자에게 돈을 돌려줄 수 있습니다.
- Google의 Play Developer API 가이드에 따르면 Google Play Billing API에는 두 가지 Play Console 권한이 필요합니다. View financial data, orders, and cancellation survey responses와 Manage orders and subscriptions입니다.
- Google Play Developer API의 orders.refund 메서드는 최대 3년 이내의 모든 일회성 구매 또는 구독 주문을 환불할 수 있으며, revoke를 true로 설정하면 구매자의 이용 권한이 즉시 종료됩니다.
- Google Cloud 서비스 계정 키는 기본적으로 만료되지 않습니다. Google은 코드 저장소에 커밋된 키는 IAM에서 삭제해야 하며, 저장소에서 제거하는 것만으로는 충분하지 않다고 말합니다.
- Apple의 In-App Purchase key로는 환불을 발행할 수 없지만, App Store Server API는 호출할 수 있습니다. 여기에는 구독 갱신일을 최대 90일 연장하는 엔드포인트도 포함되며, Apple은 이 연장을 되돌릴 수 없다고 밝힙니다.
- App Store Connect에서 In-App Purchase key를 생성할 수 있는 것은 Account Holder 또는 Admin뿐이며, 개인 키는 한 번만 다운로드할 수 있고, 폐기된 키는 복원할 수 없습니다.
서비스 계정 하나에 Play Console 권한 두 개를 주면, 그 계정은 앱의 모든 주문을 환불할 수 있습니다. 이것은 설정 실수가 아닙니다. Google이 Google Play Developer API를 정확히 그렇게 설계했습니다. 그래서 환불 도구 뒤에 있는 JSON 키는 은행 로그인 정보만큼 신중하게 다뤄야 합니다.
대부분의 팀은 마감에 쫓기며 한 번에 설정하고, 첫 API 호출이 성공할 때까지 이것저것 체크합니다. 이 가이드는 반대로 접근합니다. 환불과 지불 거절(chargeback) 처리에 실제로 필요한 Google Play 서비스 계정 권한, 각 스토어가 도난당한 키로 무엇을 허용하는지, 그리고 피해 범위를 작게 유지하는 방법을 설명합니다.
Google Play 서비스 계정 권한으로 실제로 할 수 있는 일
서비스 계정은 로봇 사용자입니다. Google Cloud에서 만든 다음, Play Console의 Users and permissions(사용자 및 권한)에서 그 이메일 주소를 초대합니다. 동료를 초대하는 방식과 똑같습니다. 그때부터 이 계정은 권한이 허용하는 모든 일을 API를 통해, 시간에 상관없이, 2단계 인증 없이 수행할 수 있습니다.
결제 API에 필요한 두 가지 권한
Google의 Play Developer API 가이드는 명확합니다. Google Play Billing API를 사용하려면 두 가지 권한을 부여해야 합니다. View financial data, orders, and cancellation survey responses(재무 데이터, 주문, 취소 설문 응답 보기)와 Manage orders and subscriptions(주문 및 구독 관리)입니다. 앞의 권한은 계정이 주문을 읽고 Purchases API를 사용할 수 있게 합니다. 돈을 건드리는 것은 뒤의 권한입니다.
| Play Console 권한 | Google이 설명하는 허용 범위 | 구매자에게 돈을 돌려줄 수 있는가 |
|---|---|---|
| View financial data, orders, and cancellation survey responses | 재무 보고서, 판매 보고서, 주문 보기, Purchases API 접근, 취소 설문 응답 다운로드 | 아니요 |
| Manage orders and subscriptions | 주문 보기, 주문 환불, 구독 취소 | 예 |
| Admin(모든 권한) | 다른 모든 권한과 더불어 사용자 초대 및 권한 변경 | 예, 그리고 스스로 더 많은 권한을 부여할 수 있음 |
환불 권한이 있는 키로 할 수 있는 일
Google Play Developer API의 orders.refund 메서드는 사용자의 구독 또는 인앱 구매 주문을 환불합니다. Google은 3년이 지난 주문은 환불할 수 없다고 말합니다. 즉, 그보다 최근의 주문은 모두 환불할 수 있다는 뜻입니다. revoke를 true로 설정하면 구매자의 이용 권한이 즉시 종료됩니다. 구독의 경우 전액 환불과 함께 purchases.subscriptionsv2.revoke를 호출하면 같은 결과가 나옵니다.
실제로 쓰려고 할 때는 이것들이 올바른 도구입니다. Google의 사기 방지 가이드도 검사를 통과하지 못한 구매는 시간 초과로 두지 말고 환불하고 취소하라고 권합니다. 문제는 앱 하나에만 필요한 키가 계정의 모든 앱에 대해 이런 일을 할 수 있다는 점입니다.
유출된 키로 인한 금전적 손실
얼마나 공을 들일지 결정하기 전에 계산부터 해보세요. Google Play에서 Manage orders and subscriptions를 가진 키는 호출 한 번에 주문 하나씩 환불할 수 있고, 환불할 때마다 판매 대금이 구매자에게 돌아갑니다. 스크립트는 지치지 않습니다. 상한선은 지난 3년간의 주문 내역 전체입니다.
환불로도 돌아오지 않는 비용
환불은 판매를 되돌립니다. 하지만 그 서비스를 제공하는 데 이미 쓴 돈은 되돌리지 못합니다. 환불이 고객의 선택이든 공격자의 소행이든, 그 지출은 장부에 그대로 남습니다.
- 이미 사용한 컴퓨팅: 구매자가 받은 모든 생성, 렌더링, 모델 응답 뒤에 있는 GPU와 서버 시간.
- 이미 비용을 낸 API 호출: 모델 제공업체, 지도, 음성, 데이터 업체의 요청당 요금.
- 계속 비용이 나가는 스토리지: 해당 계정들이 여전히 서버에 보관 중인 파일과 기록.
- 이미 지급한 정산금: 해당 구매와 연결된 크리에이터, 제휴사, 판매자 정산금은 환불과 함께 돌아오지 않습니다.
Apple 쪽은 양상이 다릅니다
Apple의 App Store Server API에는 환불을 발행하는 엔드포인트가 없습니다. 환불은 Apple이 결정합니다. 하지만 같은 In-App Purchase key로 구독자의 갱신일을 최대 90일 연장할 수 있습니다. 고객당 365일 동안 두 번까지 가능하며, 한 번의 일괄 요청으로 특정 제품의 모든 활성 구독자에게 적용할 수도 있습니다. Apple은 연장을 되돌릴 수 없다고 밝힙니다. 그 기간 동안 구독자는 요금을 내지 않고도 앱을 계속 사용하므로, 컴퓨팅, 스토리지, API 비용은 매출 없이 계속 쌓입니다.
| 도난당한 키로 할 수 있는 일 | Manage orders and subscriptions를 가진 Google Play 서비스 계정 | Apple In-App Purchase key |
|---|---|---|
| 주문 환불 | 예, 최대 3년 이내의 주문 | 아니요, 환불은 Apple만 가능 |
| 구매자 이용 권한 종료 | 예, 환불 시 revoke | 아니요 |
| 구독 취소 또는 연장 | 취소 가능 | 갱신일을 최대 90일 연장, 되돌릴 수 없음 |
| 구매 데이터 읽기 | 예, 보기 권한이 있으면 가능 | 예, 거래 및 환불 내역 |
| 환불 검토에 응답 | 예, orders.reviewrefund | 예, Send Consumption Information |
| 앱 하나로 범위 제한 | 예, 앱 권한으로 가능 | 아니요, 키는 팀의 모든 앱에서 작동 |
Google Play 서비스 계정 권한의 범위를 제한하는 방법
Play Console은 계정 권한과 앱 권한을 구분합니다. 앱 권한은 선택한 앱에만 적용됩니다. 이 설정 하나가 이 목록의 다른 어떤 항목보다 안전에 크게 기여합니다.
계정 전체가 아닌 앱 하나에 부여하기
각 서비스 계정은 담당하는 앱에 대한 앱 권한으로 초대하세요. 게임 하나를 위한 환불 도구에 명상 앱의 환불 권한은 필요 없습니다. 함정이 하나 있습니다. View financial data, orders, and cancellation survey responses는 계정 수준에만 존재하며, 앱 수준의 대응 권한 이름은 View financial data(재무 데이터 보기)입니다. 범위를 제한할 때는 앱 수준 권한을 선택하세요.
읽기와 환불을 분리하기
모든 작업에 Manage orders and subscriptions가 필요한 것은 아닙니다. 주문을 읽기만 하는 분석 작업은 보기 권한만 있는 계정으로 실행할 수 있습니다. 환불이 가능한 키는 실제로 orders.refund, orders.reviewrefund 또는 revoke 엔드포인트를 호출하는 서비스 하나에만 두세요.
로봇에게 Admin을 주지 마세요
Admin은 모든 권한을 부여하며, Google은 사용자 초대와 권한 관리도 그 권한에 포함된다고 명시합니다. 유출된 Admin 키는 스스로 접근 범위를 넓히거나 새로운 사람을 초대할 수 있습니다. 어떤 환불 워크플로에도 Admin은 필요하지 않습니다.
업체에 연결 방식을 확인하세요
어떤 도구는 JSON 키를 업로드하라고 요구합니다. 다른 도구는 초대할 수 있도록 자체 서비스 계정 이메일을 제공하므로, 여러분의 키가 통제 범위를 벗어날 일이 없고 Users and permissions에서 클릭 한 번으로 접근 권한을 제거할 수 있습니다. 업체가 환불 권한을 요구한다면 어떤 권한을, 어떤 앱에, 왜 필요한지 물어보세요.

키를 보관하고, 교체하고, 폐기하는 방법
두 스토어 모두 표현만 다를 뿐 같은 말을 합니다. 키를 코드 저장소에 넣지 말고, 앱에 포함해 배포하지 마세요. 차이는 문제가 생긴 뒤에 무슨 일이 일어나는가에 있습니다.
Google Cloud 키는 저절로 만료되지 않습니다
Google Cloud 가이드는 서비스 계정 키에 기본적으로 만료 시간이 없다고 지적합니다. 키를 정기적으로 교체하고 더 이상 쓰지 않는 키는 사용 중지하라고 권장합니다. 키가 저장소에 들어갔다면 Google은 가능한 한 빨리 IAM에서 삭제하라고 말합니다. 저장소에서 삭제하는 것만으로는 충분하지 않기 때문입니다. Service Account Key Exposure Response 제약 조건을 DISABLE_KEY로 설정하면 Google Cloud가 감지한 유출 키를 자동으로 사용 중지할 수도 있지만, 모든 유출을 잡아낸다고 보장하지는 않습니다.
Apple 키는 한 번만 다운로드되고, 폐기는 영구적입니다
In-App Purchase key는 Account Holder 또는 Admin만 생성할 수 있습니다. Apple은 공개 키 부분을 보관하고, 여러분은 개인 키 .p8 파일을 한 번만 다운로드하며, Apple은 사본을 보관하지 않습니다. 키가 유출되었다고 의심되면 Apple은 App Store Connect의 Users and Access, Integrations, In-App Purchase에서 즉시 폐기하라고 안내합니다. 폐기된 키는 복원할 수 없고, 폐기하면 그 키로 서명한 프로모션 오퍼도 더 이상 사용할 수 없으므로 폐기 전이나 직후에 해당 오퍼를 업데이트하세요.
| 작업 | Google Play 서비스 계정 | Apple In-App Purchase key |
|---|---|---|
| 생성할 수 있는 사람 | Google Cloud에서 만든 뒤 Play Console Users and permissions에서 초대 | Account Holder 또는 Admin |
| 비밀 키를 다시 다운로드할 수 있는가 | 새 키를 생성해야 함 | 아니요, 다운로드는 한 번뿐 |
| 기본 만료 기간 | 없음 | 없음, 폐기할 때까지 유효 |
| 접근을 빠르게 차단하는 방법 | IAM에서 키를 삭제하거나 Play Console에서 계정 제거 | App Store Connect에서 키 폐기 |
| 접근 차단의 부작용 | 해당 계정을 사용하는 모든 도구가 API를 호출하지 못함 | 해당 키로 서명한 프로모션 오퍼를 사용할 수 없음 |
간단한 체크리스트
- 작업마다 서비스 계정 하나를 두고, 담당하는 앱에만 앱 권한으로 초대합니다.
- Manage orders and subscriptions는 실제로 환불, 취소, 검토 응답을 수행하는 계정에만 부여합니다.
- 어떤 로봇 계정에도 Admin을 주지 않습니다.
- 키는 시크릿 관리 도구에 보관하고, 저장소, 빌드 로그, 모바일 앱에는 절대 넣지 않습니다.
- 모든 키와 생성자, 사용 중인 서비스를 문서로 정리해 두어, 폐기 때문에 환불 응답이 끊기지 않게 합니다.
- 팀원이 떠나거나 업체와의 계약을 끝낼 때마다 Play Console Users and permissions와 App Store Connect 키를 점검합니다.
자주 묻는 질문
- 환불과 지불 거절 처리를 위해 서비스 계정에 어떤 Play Console 권한이 필요한가요?
- 주문 환불, 구독 취소, 주문 처리를 위해 Manage orders and subscriptions가 필요하며, 주문 보기 권한도 함께 필요합니다. Google의 Play Developer API 가이드는 Google Play Billing API에 필요한 두 가지 권한으로 View financial data, orders, and cancellation survey responses와 Manage orders and subscriptions를 제시합니다.
- Google Play 서비스 계정이 주문을 환불할 수 있나요?
- 예, Manage orders and subscriptions 권한이 있다면 가능합니다. Google 도움말 페이지에 따르면 이 권한으로 주문 보기, 주문 환불, 구독 취소를 할 수 있으며, orders.refund API 메서드는 최대 3년 이내의 모든 주문을 환불합니다.
- 제 App Store In-App Purchase key를 가진 사람이 고객에게 환불해 줄 수 있나요?
- 아니요. App Store Server API에는 환불 엔드포인트가 없습니다. 환불은 Apple이 결정하기 때문입니다. 그래도 도난당한 키로 거래 및 환불 내역을 읽고, 소비 정보를 전송하고, 구독 갱신일을 최대 90일까지 연장할 수 있으며, Apple은 이 연장을 되돌릴 수 없다고 밝힙니다.
- Google Play 서비스 계정 키는 만료되나요?
- 기본적으로는 만료되지 않습니다. Google Cloud 가이드에 따르면 직접 생성해 다운로드한 키는 별도로 설정하지 않는 한 만료 시간이 없으며, 키를 정기적으로 교체하고 더 이상 쓰지 않는 키는 사용 중지하라고 권장합니다.
- 서비스 계정 JSON 키를 GitHub에 커밋했다면 어떻게 해야 하나요?
- 즉시 Google Cloud IAM에서 해당 키를 삭제하고 새 키를 만드세요. Google은 저장소에서 키를 제거하는 것만으로는 충분하지 않다고 말합니다. 키 자체가 삭제될 때까지는 키를 복사한 누구든 계속 사용할 수 있기 때문입니다.
출처 및 추가 자료
- Play Console Help: Add developer account users and manage permissions
- Google Play Developer API: Getting started (service accounts and required permissions)
- Google Play Developer API: orders.refund reference
- Android Developers: Fight fraud and abuse
- Google Cloud: Best practices for managing service account keys
- Apple Developer: Creating API keys to authorize API requests
- App Store Connect Help: Generate keys for in-app purchases
- Apple Developer: Extending the renewal date for auto-renewable subscriptions
RefundHalt
App Store와 Google Play 환불 자동 처리
계속 읽기
브라질이 아이들에게 여전히 루트박스를 파는 게임을 점검하기 시작했고, 그 청구서는 루트박스 환불로 날아옵니다
브라질 법무부가 연령 확인 없이 루트박스를 판매하는 게임 6종을 모니터링해 달라고 데이터 보호 당국에 요청했습니다. 법이 무엇을 요구하는지, Apple과 Google이 이미 무엇을 요구하는지, 그리고 상자가 이미 열린 상태에서 루트박스 환불을 어떻게 산정하고 처리할지 정리합니다.
실수로 인한 인앱 결제는 이길 수 없는 환불입니다. 해결책은 구매 화면에 있습니다
실수로 인한 인앱 결제는 두 스토어 모두에서 환불로 돌아오고, 어떤 사용 데이터도 그 탭이 의도된 것이었음을 증명하지 못합니다. Apple과 Google이 이를 어떻게 분류하는지, 각 건이 컴퓨팅 비용과 정산금에서 얼마의 손실을 내는지, 그리고 결제가 발생하기 전에 막는 구매 화면 설계를 알아봅니다.