2026년 Google Play 결제 테스트 구매: 라이선스 테스터를 위한 단계별 튜토리얼
Google Play 라이선스 테스트는 유료 앱이 살 수 있는 가장 저렴한 보험이지만, 대부분의 팀이 건너뛰는 단계입니다. 유료 사용자가 단 한 명이라도 등록정보에 도달하기 전에 Play Billing으로 실제 테스트 구매를 실행하고, 백엔드가 실제 구매 토큰을 수신하는 모습을 확인하며, 카드가 거절될 때 정확히 무슨 일이 일어나는지 비용 없이 지켜볼 수 있습니다. 이 튜토리얼은 개발자들이 자주 혼동하는 세 가지, 즉 라이선스 테스터(Play Console 목록), 테스트 인스트루먼트(해당 테스터가 구매 대화상자에서 보는 결제 수단), Play Billing Lab(국가, 갱신, 계정 보류를 위조하는 Google 앱)을 차례로 살펴봅니다.
마감 기한 하나는 같은 맥락에서 짚고 넘어가야 합니다. 테스트 케이스 작성 방식이 달라지기 때문입니다. 앱과 업데이트는 Play 결제 라이브러리 버전 8 이상으로 출시해야 하며, 2026년 11월 1일까지 연장 경로가 마련되어 있습니다. 버전 7 동작을 검증하는 샌드박스로는 릴리스 빌드의 동작을 알 수 없습니다.
1단계 · 어떤 샌드박스가 정말 필요한지 결정하기
세 가지 다른 설정이 모두 '테스트'라고 불리지만, 각각 답하는 질문이 다릅니다. 기기를 만지기 전에 선택하세요.
- 개발 중에 라이선스 테스터를 사용하세요. "내 클라이언트 코드가 구매, 확인, 소비를 제대로 처리하는가?"에 답해 줍니다. 사이드로드 빌드에서도 작동하므로 아무것도 업로드하지 않고 반복 테스트할 수 있습니다. Google의 문서에 따르면 결제 라이브러리는 일반적으로 서명되어 Play에 업로드되지 않은 앱에서는 차단되며, 라이선스 테스터는 이 검사에서 예외입니다.
- 테스트 트랙과 라이선스 테스터. "Google Play가 실제로 서비스하는 빌드가 동일하게 작동하는가?"라는 질문에 답합니다. 내부 테스트 트랙을 사용하세요. Google가 결제 관련 작업에 권장하는 트랙입니다.
- 일반 Google 계정으로 진행하는 테스트 트랙. "타인의 실제 카드가 정상 승인되고 올바르게 청구되는가?"라는 질문에 답합니다. 이 결제는 실제 비용이 발생하며, 초안 앱과 내부 테스트 트랙 릴리스에는 지출 한도가 적용됩니다.
첫 번째 설정만 계속 실행한다면 같은 가정을 두 번 검증하는 셈입니다. 세 가지 설정은 대안이 아니라 누적 적용됩니다.
2단계 · Play Console에서 테스터 추가
- Play Console을 열고 설정 → 라이선스 테스트로 이동하세요.
- 테스터는 이메일 목록 또는 Google 그룹으로 추가하세요. 이메일 목록은 최대 2,000개 주소를 담을 수 있고, Google 그룹은 인원 제한이 없어 QA 인력이 자주 바뀌는 에이전시가 그룹을 사용합니다.
- 변경 사항을 저장하세요. 본인의 퍼블리싱 계정은 항상 라이선스 테스터로 처리되므로, 가장 먼저 구매할 수 있는 사람은 바로 본인입니다.
테스터가 실제로 상품에 도달할 수 있는지는 두 가지 조건으로 결정되며, 이 두 가지가 "구매 버튼이 회색으로 비활성화되는" 흔한 원인입니다:
- 앱이 공개 테스트, 비공개 테스트, 내부 테스트 또는 프로덕션 트랙에 게시되어 있어야 하며, 테스터는 해당 릴리스에 접근할 자격이 있어야 합니다. 즉, 트랙(또는 트랙의 Google 그룹)에 추가되고 테스트의 옵트인 URL을 통해 참여 의사를 밝혀야 합니다.
- 테스트하려는 일회성 상품과 구독은 반드시 게시되어 있어야 합니다. 게시되지 않은 상품은 테스터 설정과 무관하게 구매 흐름에 존재하지 않습니다.
테스트 트랙에 게시한 후 테스터가 설치할 수 있기까지 몇 시간이 걸릴 수 있다고 Google에서 안내합니다. QA 세션 당일 아침이 아니라 전날부터 시간을 계산하세요.
3단계 · 테스터 기기에 구매 가능한 빌드 배포하기
라이선스 테스터는 "서명 후 업로드" 검사를 면제받기 때문에 디버그 빌드를 직접 설치해도 정상적으로 구매 대화상자가 표시됩니다. 단 하나의 필수 조건이 있습니다. 패키지 이름이 Play Console에 구성된 앱과 일치해야 합니다. .debug 접미사가 붙은 디버그 변형은 겉보기에는 정상이지만 결제 시점에 실패합니다.
계정은 빌드만큼이나 중요합니다. 테스트 계정은 반드시 테스터의 기기에 있어야 하며, 기기에 Google 계정이 여러 개 있을 때는 앱을 다운로드한 계정으로 결제가 이루어집니다. 다운로드한 계정이 없다면 기기의 첫 번째 계정으로 결제됩니다. 결제 창을 펼치면 어느 계정으로 결제되는지 확인할 수 있어, 결제가 엉뚱한 사용자에게 귀속되는 문제를 가장 빠르게 진단할 수 있습니다.
4단계 · 테스트 도구로 구매하기
라이선스 테스터에게는 실제 카드 대신 테스트 결제 수단이 제공됩니다. 그중 두 가지가 가치의 대부분을 차지합니다:
- 테스트 도구, 항상 승인 — 구매를 완료하고 토큰을 반환하므로 권한 부여 전달, 영수증 검증, 확인 처리를 테스트할 수 있습니다.
- 테스트 수단, 항상 거절 — 결제가 실패하는 경우로, 실제 사용자가 겪기 전까지 대부분의 연동이 간과하는 상황입니다. 앱은 복구 가능한 오류를 표시하고 무료 잠금 해제를 제공하지 않은 채 사용자에게 아무것도 남기지 않아야 합니다.
테스트 구매는 일반 구매 흐름을 재사용하지만 알아둘 만한 두 가지 차이가 있습니다. 세금이 계산되지 않으며, 대화상자 중앙에 해당 구매가 테스트임을 표시하는 안내가 나타납니다. 이 안내가 보이지 않는다면 테스트 구매가 아니므로 코드가 아니라 계정을 확인하세요.
구독은 테스트 도구가 한계에 부딪히는 영역입니다. 테스트 갱신은 실제 결제 주기를 기다리지 않으므로, 갱신, 유예 기간, 계정 보류 로직은 Play Billing Lab의 가속 기능이나 기록된 구매 토큰에 대한 서버 측 시뮬레이션을 사용해야 합니다.
5단계 · 3분 이내에 확인 처리
이 부분에서 Google의 문서는 유난히 구체적입니다. 라이선스 테스터가 구매한 경우, 앱이 구매를 확인 처리하지 않으면 주문은 3분 후 환불되며 취소에 관한 이메일을 받게 됩니다. Play Console의 주문 탭에서도 같은 내용을 확인할 수 있습니다.
그 3분의 대기 시간은 불편이 아니라 기능입니다. 확인 처리를 눈에 보이는 테스트로 바꿔주기 때문이죠. 구매하고, 확인 전에 앱을 종료하고, 기다린 뒤 주문을 확인하세요. 주문이 살아남는다면 확인 처리 경로가 예상치 못한 곳에서 실행되고 있는 것입니다. 흔히 서버 호출 오류를 감추는 재시도 루프에서요. 같은 테스트로 반대 버그도 잡을 수 있습니다. 소모성 상품이 아닌 상품을 소모 처리하면, 두 번 구매되면 안 되는 상품이 두 번 구매 가능해집니다.
6단계 · Play Billing Lab에서 까다로운 상태 리허설하기
Play Billing Lab은 Google이 게시한 별도의 Android 앱으로, 테스트 빌드와 결제 백엔드 사이에 위치합니다. Google 문서에 따르면 제공되는 기능은 다음과 같습니다.
- 테스트를 위해 플레이 국가를 변경하면, 실제로 이전하지 않고도 지역별 가격 표시와 이용 자격을 확인할 수 있습니다.
- 무료 체험과 신규 가입 혜택은 같은 계정에서 반복할 수 있습니다. 그렇지 않으면 혜택은 첫 실행에만 쓸 수 있는 일회성입니다.
- 다른 활성 구독자에게 영향 없이 구독 가격 변경을 테스트하세요.
- 구독 상태 전환 가속화: 갱신을 강제로 실행하거나, 구독을 유예 기간 또는 계정 보류 상태로 한 번의 작업으로 전환하세요. 며칠씩 기다릴 필요가 없습니다.
- 특정 구매 흐름 위험 신호를 우회하려면 실제 결제 수단을 사용하세요.
- 앱 밖에서 이루어진 결제도 백엔드에서 처리되도록 앱 외 결제를 테스트하세요.
같은 문서에 나오는 운영상의 세부 사항 세 가지입니다. 모두 나중에 뒤늦게 알면 반나절을 날리는 항목이죠. Play Billing Lab에는 결제에 사용하는 것과 동일한 계정으로 로그인해야 하고, 그 계정은 테스트 대상 앱의 라이선스 테스터여야 하며, 구성은 2시간 후에 만료됩니다. 변경 사항이 적용되지 않는 것처럼 보이면 다시 로그인해 재시도하고, 테스트를 실행하는 기기의 Play 스토어 캐시를 지우세요.
7단계 · 그런 다음 의도적으로 샌드박스를 깨보세요
팀이 가장 자주 잊는 마지막 테스트가 있습니다. 라이선스 테스터가 아닌 계정으로 구매를 반복하는 것입니다. 라이선스 테스터는 테스트에 맞춰진 동작(대표적으로 갱신 기간)을 경험하므로, 라이선스 테스터로만 테스트한 앱은 테스트 환경에 조용히 의존하는 로직을 출시할 수 있습니다. Google가 일반 계정으로 가끔 테스트할 것을 권장하는 이유가 바로 여기에 있으며, 대규모 결제 변경 후에도 마찬가지입니다.
예산을 잡아두세요. 이런 구매는 실제 청구이며 환불은 토글이 아니라 지원 절차입니다. 저가 상품으로 테스트하고 주문 ID를 보관하며, 사용자에게 지불 거절을 요청하는 대신 Play Console을 통해 의도적으로 환불하세요.
대부분을 차지하는 여섯 가지 실패 원인
- 패키지 이름 불일치. 디버그 빌드가 Play Console의 applicationId와 다른 applicationId로 설치 및 결제되어, 별다른 오류 메시지 없이 결제가 실패합니다.
- 제품이 게시되지 않음. 라이선스 테스트가 설정되고 테스터가 추가되었는데도 SKU가 표시되지 않는다면, 일회성 제품이나 구독이 활성화되지 않은 것입니다.
- 트랙에 없는 테스터. 라이선스 테스트와 트랙 멤버십은 별개의 목록입니다. 한쪽에 있다고 해서 다른 쪽에도 속하는 것은 아닙니다.
- 기기에 잘못된 Google 계정. 구매는 앱을 다운로드한 계정으로, 아무도 다운로드하지 않았다면 첫 번째 계정으로 귀속됩니다.
- 확인되지 않은 구매가 3분 후 환불됨. 보통 서버 호출 누락이며, 간혹 재시도 래퍼가 삼킨 예외인 경우도 있습니다.
- 라이선스 테스터만 테스트되었습니다. 샌드박스에서는 정상 작동하지만 유료 사용자에게는 오작동합니다. 테스터가 아닌 경로를 전혀 검증하지 않았기 때문입니다.
출처: Play Console 고객센터 "애플리케이션 라이선스로 인앱 결제 테스트"(라이선스 테스터 목록, 공개된 상품, 테스트 트랙 자격), Android Developers "Google Play Billing Library 연동 테스트"(사이드로드 예외, 테스트 도구, 3분 환불 규칙, Play Billing Lab 기능, 2시간 구성 만료). Google는 결제 위험 신호에 대한 합격 기준을 공개하지 않으며, 이 문서에서도 추정하지 않습니다.
개발자 계정을 대규모로 운영하시나요? 운영 업무를 저희가 처리합니다.
메시지를 접수했습니다. 24시간 이내에 답변드리겠습니다.
← 수정으로 돌아가기