Reminder: By Aug 31, 2025, all new apps and updates to existing apps must use Billing Library version 7 or newer. If you need more time to update your app, you can request an extension until Nov 1, 2025. Learn about Play Billing Library version deprecation.
Play 결제 라이브러리는 트리거된 작업의 결과를 알려주는 BillingResult 응답을 반환합니다. 자세한 내용은
자세한 내용은 BillingResult 응답 코드 처리를 참조하세요. 앱을 프로덕션 환경에 배포하기 전에 응답 시뮬레이터를 사용하여 앱의 다양한 응답 흐름을 테스트할 수 있습니다.
응답 시뮬레이터
앱을 Play 결제 라이브러리와 통합하면 Play 스토어와 Play 백엔드 간의 통신을 거의 제어할 수 없으므로 모든 BillingResponseCode 흐름을 테스트하기가 어려울 수 있습니다.
Play 결제 실험실 앱의 응답 시뮬레이터 기능을 사용하면 Play 결제 라이브러리의 오류 코드 응답을 구성하여 다양한 복잡한 오류 시나리오를 테스트할 수 있습니다.
Play 결제 라이브러리의 결제 재정의 테스트 사용 설정
응답 시뮬레이터와 앱 간의 통신을 사용 설정하려면 다음 안내를 따르세요.
Play 결제 라이브러리에 결제 재정의 테스트를 사용 설정해야 합니다.
할 수 있습니다. 이렇게 하려면 앱의
AndroidManifest.xml 파일.
프로덕션 환경에 앱을 배포할 때 다음 중 하나를 수행해야 합니다.
이를 포함하지 않는 별도의 AndroidManifest.xml 파일을 사용합니다.
메타데이터 태그를 삭제하거나
AndroidManifest.xml 파일.
Play 결제 라이브러리 오류 시뮬레이션
Play 결제 라이브러리 오류를 시뮬레이션하려면 먼저 Play 결제 실험실 앱에서 응답 코드를 구성한 다음 앱을 테스트합니다.
응답 코드 구성
Play 결제 실험실 앱에서 앱의 라이선스 테스터 계정으로 로그인합니다.
다음과 같은 Play 결제 실험실 대시보드가 표시됩니다.
응답 시뮬레이터 카드.
그림 1. 응답 시뮬레이터 카드
응답 시뮬레이터 카드에서 관리를 클릭합니다.
응답 시뮬레이터 화면이 표시됩니다.
메시지가 표시되면 Play 결제 실험실의 알림을 허용하여 앱의 연결 상태를 확인하세요.
아직 사용 설정되지 않은 경우 Play 결제 라이브러리 응답 시뮬레이션 스위치를 사용 설정합니다.
그림 2. Play 결제 라이브러리 응답 스위치를 시뮬레이션합니다.
테스트할 Play 결제 라이브러리 API의 응답 코드를 선택합니다.
선택사항이 자동으로 저장되고 응답 시뮬레이터가 선택한 응답 코드를 앱에 전송할 준비가 됩니다.
앱의 오류 처리 테스트
앱을 엽니다.
Play 결제 실험실의 알림을 허용했다면 기기의 상태 표시줄에 Play 결제 실험실 알림 아이콘이 표시되며 이는 응답 시뮬레이터에 성공적으로 연결되었음을 나타냅니다.
를 통해 개인정보처리방침을 정의할 수 있습니다.
<ph type="x-smartling-placeholder"></ph>
그림 3. 연결이 완료되었음을 나타내는 Play 결제 실험실 아이콘
테스트하려는 Play Billing Library API 메서드를 트리거합니다. 예를 들어
launchBillingFlow를 테스트하려면 인앱 구매를 시작하세요.
있습니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Test BillingResult response codes\n\nThe Play Billing Library returns a [`BillingResult`](/reference/com/android/billingclient/api/BillingResult) response to let you\nknow the outcome of an action that was triggered. For more\ninformation, see [handling `BillingResult` response codes](/google/play/billing/errors). Before you\ndeploy your app to the production environment, you can test your app's various\nresponse flows by using the Response Simulator.\n\nResponse Simulator\n------------------\n\nWhen you integrate your app with the Play Billing Library, it can be difficult\nto test all of the [`BillingResponseCode`](/reference/com/android/billingclient/api/BillingClient.BillingResponseCode) flows, because you don't have much\ncontrol over the communication between the Play Store and Play's backend.\nThe Response Simulator feature in the [Play Billing Lab](https://play.google.com/store/apps/details?id=com.google.android.apps.play.billingtestcompanion) app lets you\nconfigure error code responses for the Play Billing Library to test various complex\nerror scenarios.\n\n### Enable billing overrides testing for the Play Billing Library\n\n| **Note:** Before testing, ensure that your app is using [Play Billing Library](/google/play/billing/integrate#dependency) version 7.1.1 or later.\n\nTo enable communication between the Response Simulator and your app,\nyou must enable billing overrides testing for the Play Billing Library\nfrom within your app. To do this, add the following metadata tags to your app's\n`AndroidManifest.xml` file. \n\n```scdoc\n\u003cmanifest ... \u003e\n \u003capplication ... \u003e\n ...\n \u003cmeta-data\n android:name=\"com.google.android.play.largest_release_audience.NONPRODUCTION\"\n android:value=\"\" /\u003e\n \u003cmeta-data\n android:name=\"com.google.android.play.billingclient.enableBillingOverridesTesting\"\n android:value=\"true\" /\u003e\n \u003c/application\u003e\n\u003c/manifest\u003e\n```\n| **Note:** Even though adding only the `enableBillingOverridesTesting` tag and setting it to `true` is sufficient to enable billing overrides testing for your app, it's recommended that you also add the `NONPRODUCTION` tag. The `NONPRODUCTION` tag prevents accidental deployment of your app to the production environment with billing overrides testing enabled.\n\nWhen you deploy your app to the production environment, you should either\nuse a separate `AndroidManifest.xml` file that doesn't include these\nmetadata tags or ensure that you've removed these tags from the\n`AndroidManifest.xml` file.\n\n### Simulate Play Billing Library errors\n\nTo simulate Play Billing Library errors, first, configure the response codes\nin the [Play Billing Lab](https://play.google.com/store/apps/details?id=com.google.android.apps.play.billingtestcompanion) app, and then test your app.\n\n#### Configure a response code\n\n1. In the Play Billing Lab app, sign in with a [license tester](/google/play/billing/test#license-testers) account for your app.\n This displays the Play Billing Lab **Dashboard** including\n the **Response Simulator** card.\n\n **Figure 1.** Response Simulator card.\n2. Click **Manage** on the Response Simulator card.\n This shows the **Response Simulator** screen.\n\n3. When prompted, allow notifications from Play Billing Lab to see the connection status of your app.\n\n4. Enable the **Simulate Play Billing Library responses** switch, if it isn't\n already enabled.\n\n **Figure 2.** Simulate Play Billing Library responses switch.\n5. Select a response code for the Play Billing Library APIs that you want\n to test.\n Your selections are automatically saved, and the Response Simulator\n is ready to send the selected response codes to your app.\n\n#### Test your app's error handling\n\n| **Note:** When testing using the Response Simulator, ensure that you first open Play Billing Lab, and then open your app. Opening your app before opening Play Billing Lab may result in issues connecting to the Response Simulator.\n\n1. Open your app.\n\n - If you have allowed notifications from Play Billing Lab, you will see the Play Billing Lab notification icon in your device's status bar which indicates a successful connection to the Response Simulator.\n\n **Figure 3.** Play Billing Lab icon indicating successful connection.\n2. Trigger the Play Billing Library API method you want to test. For example,\n if you want to test the `launchBillingFlow`, initiate an in-app purchase\n flow."]]