모든 글
실전 가이드8분 소요

Google Play 서비스 계정 권한이 주문을 환불할 수 있는 주체를 결정하므로, 작동하는 최소한의 권한만 부여하세요

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

어두운 책상 위 노트북과 휴대전화 옆에 놓인 황동 열쇠. 환불을 좌우하는 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 Play 서비스 계정 권한을 제거하는 방법을 보여준다

키를 보관하고, 교체하고, 폐기하는 방법

두 스토어 모두 표현만 다를 뿐 같은 말을 합니다. 키를 코드 저장소에 넣지 말고, 앱에 포함해 배포하지 마세요. 차이는 문제가 생긴 뒤에 무슨 일이 일어나는가에 있습니다.

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은 저장소에서 키를 제거하는 것만으로는 충분하지 않다고 말합니다. 키 자체가 삭제될 때까지는 키를 복사한 누구든 계속 사용할 수 있기 때문입니다.

출처 및 추가 자료

RefundHalt

App Store와 Google Play 환불 자동 처리

계속 읽기

다음 환불 요청은 이미 오고 있습니다.

이의를 제기하지 못한 환불에 관한 지원 이메일을 하나 더 읽는 시간이면 RefundHalt 설정을 마칠 수 있습니다.