Cómo probar la integración de la Biblioteca de Facturación Google Play

Debes probar la integración durante el desarrollo. Para probar durante la fase de desarrollo, recomendamos verificadores con licencia y lab de Facturación Play para ejecutar las situaciones descritas. en esta sección.

Verificadores de licencia

Para configurar los verificadores con licencia, consulta Prueba la facturación integrada con licencias de aplicaciones.

El uso de verificadores con licencia ofrece los siguientes beneficios:

  • Por lo general, la Biblioteca de Facturación Google Play se bloquea para las apps que no están firmadas ni subidas a Google Play. Los verificadores con licencia pueden omitir esta verificación, lo que significa que puedes transferir apps para pruebas, incluso apps que usan compilaciones de depuración con firmas de depuración, sin necesidad de subirlas a la versión nueva de la app. Ten en cuenta que el nombre del paquete debe coincidir con el de la app configurada para Google Play, y la Cuenta de Google debe ser de un verificador con licencia de la cuenta de Google Play Console.
  • Los verificadores con licencia tienen acceso a formas de pago de prueba que evitan los cargos reales por las compras. También puedes usar formas de pago de prueba para simular determinadas situaciones, como cuando se rechaza un pago. En la figura 1, se muestran estas formas de pago de prueba como aparecen en el flujo de compra.
  • Los verificadores con licencia pueden probar rápidamente las funciones de suscripción.
los verificadores con licencia tienen acceso a las formas de pago de prueba
Figura 1: Los verificadores con licencia tienen acceso a las formas de pago de prueba

Aquí hay algunos detalles adicionales sobre el proceso de compra de prueba:

  • Las compras de prueba usan el mismo flujo de compra de la app que las compras reales.
  • No se calculan los impuestos en las compras de prueba.
  • Para indicar una compra de prueba, Google Play muestra una notificación en el centro del diálogo de la compra.

Expande el cuadro de diálogo de la compra para confirmar la cuenta que hace la compra. Ten en cuenta lo siguiente:

  • Las cuentas de prueba deben estar en el dispositivo Android del verificador.
  • Si el dispositivo tiene más de una cuenta, la compra se realiza con la cuenta que descargó la app.
  • Si ninguna de las cuentas descargó la app, la compra se hará con la primera cuenta.

Antes de distribuir la app, puedes usar los segmentos de pruebas de Google Play para realizar una validación adicional. Por ejemplo, puedes aprovechar los segmentos de pruebas para que el equipo de control de calidad califique una versión nueva.

Con los segmentos de pruebas, los usuarios pueden instalar la app desde Google Play y probar una versión que aún no esté disponible públicamente. Los usuarios pueden hacer compras reales con cualquiera de sus formas de pago en Google Play.

Para probar la integración de la Biblioteca de Facturación Google Play en segmentos de pruebas, haz lo siguiente:

  1. Publica la app en un segmento de pruebas. Ten en cuenta que, después de publicar una app en un segmento de pruebas, puede tardar algunas horas en estar disponible para los verificadores.
  2. Asegúrate de que cada verificador acepte participar en la prueba de la app. En la URL para participar en las pruebas, los verificadores verán una explicación de lo que significa ser un verificador y un vínculo de aceptación.

Puedes probar la integración en cualquier dispositivo que ejecute Android 1.6 o versiones posteriores. La versión más reciente de la aplicación de Google Play debe estar instalada en el dispositivo. Si deseas obtener información general sobre cómo configurar un dispositivo de modo que se pueda usar en el desarrollo de aplicaciones para Android, consulta Cómo ejecutar apps en un dispositivo de hardware.

Lab de Facturación Play

Play Billing Lab es una app para Android que ayuda a los desarrolladores a probar sus e integración en el sistema de facturación de Google Play. Proporciona una forma fácil y conveniente para que los desarrolladores prueben funciones de facturación, realicen integraciones más rápido, y lanzarlas con mayor confianza. Puedes descargar e instalar Lab de Facturación Play desde la Play Store.

Play Billing Lab te permite hacer lo siguiente durante las pruebas:

Panel del lab de Facturación Play
Figura 2: Panel del lab de Facturación Play

Cómo probar productos únicos

Cómo probar productos consumibles

En el momento de hacer pruebas con productos consumibles, recomendamos que pruebes distintas situaciones, incluidas las siguientes:

  • Una compra exitosa en la que el usuario recibe un artículo. Con un verificador con licencia, puedes usar la forma de pago Tarjeta de prueba, siempre aprueba
  • Una compra en la que no se puede hacer el cargo en la forma de pago y el usuario no debería recibir el artículo. Con un verificador con licencia, puedes usar la forma de pago Tarjeta de prueba, siempre rechaza
  • Asegúrate de que los artículos puedan comprarse varias veces.

También deberías verificar que las compras se procesen de forma correcta según lo descrito en Cómo procesar las compras. En el caso de las compras de verificadores con licencia, se reembolsará una compra después de 3 minutos si la app no procesa la compra, y recibirás un correo electrónico sobre la cancelación. También puedes revisar la pestaña Pedidos en Google Play Console para ver si se reembolsó un pedido después de 3 minutos.

Cómo probar productos no consumibles

Los productos no consumibles deben probarse de la misma manera que los productos consumibles, pero deberías verificar que no se pueda volver a comprar un artículo en la app. Asegúrate de verificar que se procesen las compras de productos consumibles y no consumibles (según corresponda), ya que la lógica de procesamiento de cada uno de estos tipos de compras varía.

Cómo probar compras pendientes

Debes probar una compra pendiente en la que se otorga el artículo cuando el estado de compra sea PURCHASED. Los verificadores con licencia tienen acceso a dos instrumentos de prueba para formas de pago demoradas en las que el pago se completa o se cancela automáticamente al cabo de unos minutos.

  1. Realiza una compra con una forma de pago con demora que indique el mensaje "Tarjeta de prueba lenta (se rechaza después de unos minutos)", como se muestra en la figura 2. Reinicia la app y comprueba que no se haya generado la compra.

    prueba una compra con una tarjeta de prueba lenta rechazada
    Figura 3: Prueba una compra con una tarjeta de prueba lenta rechazada.

  2. Realiza una compra con una forma de pago con demora que indique el mensaje "Tarjeta de prueba lenta (se aprueba después de unos minutos)", como se muestra en la figura 3. Espera unos minutos y comprueba que se haya generado la compra.

    prueba una compra con una tarjeta de prueba lenta aprobada
    Figura 4: Prueba una compra con una tarjeta de prueba lenta aprobada.

Si deseas obtener más información, consulta la sección Cómo administrar transacciones pendientes.

Cómo probar funciones específicas para suscripciones

Los flujos de compra de suscripciones y productos únicos son similares, pero las suscripciones tienen situaciones adicionales, como las renovaciones de suscripción correctas o rechazadas. Para probar las renovaciones, puedes usar las formas de pago Tarjeta de prueba, siempre aprueba y Tarjeta de prueba, siempre rechaza disponibles para los verificadores con licencia, como se muestra en la figura 1. Usa estos instrumentos de pago para probar diferentes situaciones aparte de una situación de suscripción correcta.

Al igual que los productos únicos, también deberías verificar que las compras se procesen de forma correcta según lo descrito en Cómo procesar las compras. En el caso de las compras de verificadores con licencia, se reembolsará una compra después de 3 minutos si la app no procesa la compra, y recibirás un correo electrónico sobre la cancelación. También puedes revisar la pestaña Pedidos en Google Play Console para ver si se reembolsó un pedido después de 3 minutos.

Períodos de renovación

Las suscripciones de prueba se renuevan más rápido que las reales. Las suscripciones de prueba se pueden renovar un máximo de seis veces, sin contar las suscripciones gratuitas las pruebas y los períodos introductorios.

En la siguiente tabla, se enumeran los tiempos de renovación de prueba de suscripciones con distintas duraciones. Los tiempos son aproximados. Quizá veas algunas pequeñas variaciones en el tiempo exacto de un evento. Para compensar la variación, llama a la API para ver el estado actual después de cada fecha de vencimiento de una suscripción.

Período de suscripción de producción Renovación de suscripción de prueba
1 semana 5 minutos
1 mes 5 minutos
3 meses 10 minutos
6 meses 15 minutos
1 año 30 minutos

Las funciones de suscripciones basadas en el tiempo, como las pruebas gratuitas, también se acortan para las pruebas. En la siguiente tabla, se identifican los períodos de prueba asociados con las funciones de suscripciones basadas en el tiempo:

Función Período de prueba
Procesamiento de compra 5 minutos
Prueba gratuita 3 minutos
Período con precio de lanzamiento Igual que el período de prueba de suscripción
Período de gracia (de 3 y 7 días) 5 minutos
Suspensión de la cuenta 10 minutos
Pausa (1 mes) 5 minutos
Pausa (2 meses) 10 minutos
Pausa (3 meses) 15 minutos

Ofertas de prueba

Con la función de prueba de la oferta de prueba del Lab de Facturación Play, una El verificador con licencia puede probar y usar la prueba gratuita o las ofertas introductorias una cantidad de veces consultando la sección "Prueba gratuita u oferta de lanzamiento" y aplicar el cambio. Esto elimina la necesidad de crear múltiples para probar una oferta de prueba que solo está disponible para suscriptores nuevos.

ofertas de prueba
Figura 5: Probar ofertas de prueba

Cambios de precio

También puedes usar Play Billing Lab y verificadores con licencia para realizar pruebas cambios en los precios de las suscripciones sin que afecta a otros suscriptores activos mediante los siguientes pasos:

  1. Haz clic en Administrar en la tarjeta Configuración de la suscripción del Panel.
  2. Elige la suscripción activa que quieras probar.
  3. Ingresa el precio nuevo.
  4. Selecciona o anula la selección de la casilla de verificación Inhabilitación de usuarios según los requisitos de la prueba.
  5. Haz clic en Aplicar.
probar cambio de precio de la suscripción
Figura 6. Prueba el cambio de precio de la suscripción.

Después de aplicar los cambios, el precio se actualizará a partir del siguiente la renovación solo para el verificador. Esto no afectará a los demás suscriptores activos. Todas las reglas de verificadores de licencias se aplicarán a la suscripción de prueba. El verificador puede hacer lo siguiente: y, luego, probar la app para procesos descendentes generados por el cambio de precio, como notificaciones de cambios de precios.

Ten en cuenta las siguientes consideraciones cuando planifiques los períodos de prueba:

  • Debido a la corta duración de renovación de los verificadores de licencias, es posible que un La migración de precios desde la consola no se registrará para los verificadores de licencias. Para garantizar que se puedan probar las notificaciones y los correos electrónicos sobre cambios de precios, deberían aplazar la facturación al menos una hora después de activar un cambio de precio.
  • Las disminuciones de precios no tienen un período de notificación. Se notifica a los usuarios de una disminución de precio poco después de la migración de la cohorte. Esto no se modifica durante las pruebas.
  • Para los aumentos de precio, los tiempos de las notificaciones de prueba se calculan de la misma manera que con los aumentos reales:
    • Se le cobra al usuario en el primer aniversario de facturación después de un período de notificación obligatorio.
    • Los tiempos de notificación se calculan de forma retroactiva a partir de la fecha del primer cobro.
    • La notificación final siempre es 1 minuto antes del cobro, sin importar el período de facturación.

En la siguiente tabla, se muestran los períodos de notificación y facturación de prueba de varios períodos de facturación actuales:

Período de facturación del plan básico actual Período de facturación de prueba Período de notificación de prueba (regiones de participación o rechazo con 30 días de anticipación) Período de notificación de prueba (no participar en regiones con 60 días de aviso)
1 semana 5 minutos 5 minutos 10 minutos
1 mes 5 minutos 5 minutos 10 minutos
3 meses 10 minutos 3 minutos 6 minutos
6 meses 15 minutos 2 minutos 4 minutos
1 año 30 minutos 3 minutos 6 minutos

Casos de prueba

Haz clic en Mostrar/Ocultar para expandir la sección siguiente y mostrar las situaciones de prueba que debes usar para verificar la integración de suscripción.

Cómo probar transacciones pendientes

Debes probar que las transacciones pendientes se manejen correctamente y que se cumplan los derechos se actualiza según corresponda cuando el estado de compra se vuelve PURCHASED. Verificadores de licencias tienen acceso a dos instrumentos de prueba para formas de pago demoradas en las que la el pago se completa o cancela automáticamente después de unos minutos.

  1. Realiza una compra con una forma de pago con demora que indique el mensaje "Tarjeta de prueba lenta (se rechaza después de unos minutos)", como se muestra en la figura 2. Reinicia la app y comprueba que no se haya generado la compra.

    prueba una compra con una tarjeta de prueba lenta rechazada
    Figura 2: Prueba una compra con una tarjeta de prueba lenta rechazada.

  2. Realiza una compra con una forma de pago con demora que indique el mensaje "Tarjeta de prueba lenta (se aprueba después de unos minutos)", como se muestra en la figura 3. Espera unos minutos y comprueba que se haya generado la compra.

    prueba una compra con una tarjeta de prueba lenta aprobada
    Figura 3: Prueba una compra con una tarjeta de prueba lenta aprobada.

Cómo probar los códigos promocionales

Puedes usar Google Play Console para crear códigos para tus propias pruebas. Recuerda que solamente puedes crear 500 códigos promocionales por trimestre en todos los productos administrados de una app.

Deberías probar las siguientes situaciones de canje de código promocional:

  • Cuando se ingresa el código promocional en un cuadro de diálogo de compra que se inició en la app.
  • Cuando se canjea el código promocional en la app de Google Play Store.
  • Cuando se canjea el código promocional en https://play.google.com/store con el botón Canjear en la barra de navegación izquierda.

Dentro de estas situaciones, deberías probar el canje de códigos de todas las formas posibles. Recomendamos que ejecutes las siguientes pruebas como mínimo:

  • Canje antes de instalar la app.
  • Canje mientras la app se ejecuta en primer plano. Recuerda que, en esta prueba, necesitas otro dispositivo para hacer la prueba con la app de Google Play Store. Asegúrate de probar los canjes desde diferentes pantallas de la app.
  • Canje con el modo multiventana, en el que tu app y la de Google Play Store se muestran al mismo tiempo.

En cada prueba, asegúrate de que el elemento se detecte correctamente y de que se notifique al usuario.

Cómo probar la experiencia de compra en diferentes regiones

Puedes probar la experiencia de compra con o sin Play Billing Lab:

Prueba con

La app para Android de Play Billing Lab te permite probar la del flujo de compra en cualquier región. Sin embargo, para usar Play Billing Lab, debes ser un verificador con licencia. Usa el sigue estos pasos para la prueba:

  1. Registra al usuario de facturación de la app como verificador de licencia.
  2. Accede a la app de Play Billing Lab con el mismo usuario.
  3. Selecciona el país que desees y aplica el cambio en Play Billing Lab.
  4. Inicia el flujo de compra en la app que se esté probando.
prueba de la experiencia de compra en diferentes regiones
Figura 7: Prueba la experiencia de compra en diferentes regiones.

Prueba sin

También puedes probar el flujo de compra en cualquier región sin usar en Play Billing Lab. Sigue estos pasos para realizar la prueba:

  1. Crea una nueva cuenta de Gmail. La cuenta se puede crear en cualquier país.
  2. De manera opcional, puedes configurar al usuario como un verificador de licencias.
  3. Usa una VPN del país que quieras probar.
  4. Inicia el flujo de compra.

Puedes borrar los datos y la caché de Play Store, y repetir los pasos 3 y 4 con cualquier país que deseas probar. Después de cambiar a otro país, deberás para borrar los datos de Google Play Store y quitar los datos relacionados con país.

Ambos métodos para probar las compras te permiten evaluar la elegibilidad regional de las ofertas la experiencia del usuario en cualquier región, independientemente del lugar físico en el que realices la prueba.