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.
Cómo probar los códigos de respuesta BillingResult
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La Biblioteca de Facturación Play muestra una respuesta BillingResult para informarte el resultado de una acción que se activó. Para ver más
consulta cómo manejar códigos de respuesta BillingResult. Antes de implementar tu app en el entorno de producción, puedes probar los diversos flujos de respuesta de tu app con el simulador de respuestas.
Simulador de respuestas
Cuando integras tu app con la biblioteca de Play Billing, puede ser difícil probar todos los flujos de BillingResponseCode, ya que no tienes mucho control sobre la comunicación entre Play Store y el backend de Play.
La función de simulador de respuestas de la app de Play Billing Lab te permite
configurar respuestas de códigos de error para la Biblioteca de Facturación Play y probar varias situaciones de error
complejas.
Cómo habilitar las pruebas de anulaciones de facturación para la Biblioteca de Facturación Play
Para habilitar la comunicación entre el Simulador de respuestas y tu app, debes habilitar las pruebas de anulaciones de facturación de la Biblioteca de Facturación Play desde tu app. Para ello, agrega las siguientes etiquetas de metadatos al archivo AndroidManifest.xml de tu app.
Cuando implementes tu app en el entorno de producción, debes usar un archivo AndroidManifest.xml independiente que no incluya estas etiquetas de metadatos o asegurarte de haberlas quitado del archivo AndroidManifest.xml.
Simula errores de la Biblioteca de Facturación Play
Para simular errores de la Biblioteca de Facturación Play, primero configura los códigos de respuesta
en la app de Play Billing Lab y, luego, prueba tu app.
Configura un código de respuesta
En la app de Play Billing Lab, accede con una cuenta de verificador con licencia para tu app.
Aquí se mostrará el Panel del lab de Facturación Play, que incluye lo siguiente:
la tarjeta Simulador de respuestas.
Figura 1: Tarjeta del simulador de respuesta
En la tarjeta Simulador de respuesta, haz clic en Administrar.
Se mostrará la pantalla del Simulador de respuestas.
Cuando se te solicite, permite las notificaciones de Play Billing Lab para ver el estado de conexión de tu app.
Si no lo está, habilita el interruptor Simular respuestas de la Biblioteca de Facturación Play.
ya está habilitado.
Figura 2: Interruptor para simular las respuestas de la Biblioteca de Facturación Play
Selecciona un código de respuesta para las APIs de la Biblioteca de Facturación Play que deseas probar.
Tus selecciones se guardan automáticamente, y el simulador de respuestas está listo para enviar los códigos de respuesta seleccionados a tu app.
Cómo probar el manejo de errores de tu app
Abre tu app.
Si permitiste las notificaciones de Play Billing Lab, verás el ícono de notificaciones de Play Billing Lab en la barra de estado de tu dispositivo, que indica que la conexión al simulador de respuestas se realizó correctamente.
Figura 3: Ícono del lab de Facturación Play que indica que la conexión se realizó correctamente
Activa el método de la API de la Biblioteca de Facturación Play que deseas probar. Por ejemplo, si quieres probar launchBillingFlow, inicia un flujo de compra directa desde la aplicación.
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[null,null,["Última actualización: 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."]]