Probar la facturación integrada

La Google Play Developer Console ofrece varias herramientas que te ayudan a probar tu implementación de facturación integrada:

  • Compras de prueba, que permiten a los usuarios evaluadores de licencias comprar tus artículos integrados en la aplicación publicados, sin que se realicen cobros a sus cuentas.
  • Respuestas estáticas de facturación desde Google Play, para la evaluación durante etapas tempranas del desarrollo

Para probar la facturación integrada, debes publicar tu app en un canal alfa o beta en Google Play.

Luego de que publiques una app en un canal alfa o beta, es posible que pasen unas horas hasta que esta se encuentre disponible para los evaluadores. El código de versión de un APK en un dispositivo de prueba debe coincidir con la versión subida actualmente al canal alfa o beta en Google Play.

Importante: Para probar productos integrados en la aplicación o hacer compras directas desde la aplicación en tu app del canal alfa o beta, cada evaluador debe participar de la prueba alfa o beta de tu app. En la URL de participación de tu prueba, tus evaluadores hallarán una explicación sobre lo que implica ser un evaluador y un vínculo para participar.

Puedes realizar pruebas en cualquier dispositivo de hardware con tecnología Android que tenga instalada la versión 1.6 o una posterior de este sistema. La versión más actual 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 para usarlo en el desarrollo de aplicaciones para Android, consulta Usar dispositivos de hardware.

Pruebas de compras directas desde la aplicación

Cuando esté lista tu implementación de facturación integrada, podrás probar la compra de tus SKU en la aplicación de dos formas:

  • Compras de prueba, que permiten a tus usuarios seleccionados para evaluar licencias comprar tus artículos integrados en la aplicación, sin que se les apliquen cobros. Las compras de prueba pueden usarse únicamente en versiones alfa o beta.
  • Compras reales, que permiten a los usuarios realizar compras reales de tus productos integrados en la aplicación y generan costos reales en los medios de pago de los usuarios.

En cualquiera de los dos casos, necesitas publicar tu app en los canales para versiones alfa y beta de Google Play para gestionar los usuarios que puedan hacer compras.

En las siguientes secciones se brinda más información sobre cómo usar estos enfoques para pruebas y validaciones.

Compras de prueba (zona de pruebas para la facturación integrada)

Las compras de prueba ofrecen una forma segura y práctica de permitir pruebas a mayor escala de tu implementación de facturación integrada durante el desarrollo o en la preparación para el lanzamiento. Permiten que desde las cuentas de usuarios autorizados se realicen compras de tus productos integrados en la aplicación a través de Google Play, sin que se generen costos reales en las cuentas de los usuarios.

Una vez autorizados para acceder a la prueba, esos usuarios pueden hacer compras sin costos. Las compras de prueba no tienen un campo orderId, lo cual garantiza que no se apliquen cobros reales en las cuentas de los usuarios.

Nota: Las compras de prueba para suscripciones se repiten a diario, sin importar el período de suscripción del producto.

Configuración de las compras de prueba

Es fácil configurar compras de prueba; cualquier cuenta de usuario puede seleccionarse para ser una cuenta de prueba, y cualquier usuario de una cuenta de prueba puede hacer compras de prueba con cualquier método de pago disponible (aunque no se genera un costo por el método de pago).

Primero, sube y publica productos integrados en la aplicación que deseas poner a disposición de los evaluadores para la compra. Puedes subir y publicar productos integrados en la aplicación. Ten en cuenta que puedes subir y publicar tus artículos integrados en la aplicación antes de publicar el propio APK.

Luego crea cuentas de prueba de licencias para los usuarios autorizados. En la Developer Console, ve a Settings > Account details y luego, en la sección License Testing, agrega las direcciones en el campo Gmail accounts with testing access. Para obtener más información, consulta Configuración para compras de prueba.

Una vez que hayas agregado los usuarios como cuentas de evaluadores de licencias y guardado los cambios, en un plazo de 15 minutos los usuarios podrán comenzar a realizar compras de prueba de tus productos integrados en la aplicación.

Importante: Luego de que publiques tu app en un canal alfa o beta, tus evaluadores deberán participar en la prueba alfa o beta de esta por medio de la URL de participación proporcionada para poder realizar compras de prueba.

Nota: Las cuentas de prueba de licencias deben estar en el dispositivo Android del usuario. Si el dispositivo tiene más de una cuenta, la compra se hará con la cuenta que descargó la app. Si ninguna de las cuentas descargó la app, la compra se hará con la primera cuenta. Los usuarios pueden confirmar la cuenta que hace la compra expandiendo el diálogo de compra.

Nota: Las compras de prueba no tienen campos orderId. Para llevar un registro de las compras de prueba, se usa el campo purchaseToken en su lugar.

Compras de prueba y cuenta de desarrollador

Las cuentas autorizadas para prueba de licencias se asocian a tu cuenta de desarrollador en Google Play, en lugar de tu APK específico o el nombre del paquete. Al identificar una cuenta como cuenta de prueba, se habilita para comprar cualquiera de tus productos integrados en la aplicación sin costo.

Detalles del flujo de compra

Durante una compra de prueba, los usuarios pueden probar el flujo de comercialización, compra y tramitación en tu app. Durante la compra, el artículo integrado en la aplicación se muestra como un artículo normal con su precio. Sin embargo, Google Play marca las compras de prueba con una notificación en el centro del diálogo de compra, para facilitar su identificación.

Cancelar las compras de prueba completadas

Google Play acumula las compras de prueba completadas para cada usuario, pero no las transfiere al sistema de procesamiento financiero.

En algunos casos, es posible que desees cancelar manualmente una compra de prueba para continuar con la evaluación. Para eso, abre la página de la app en la Play Store. Si la compra de prueba que deseas cancelar es una suscripción, también puedes usar el método cancel() de la Purchases.subscriptions API.

Importante: Los métodos refund() y revoke() de la Purchases.subscriptions API no admiten compras de prueba.

Pruebas con transacciones reales

Mientras te preparas para lanzar una app que use facturación integrada, puedes usar las opciones de versiones alfa y beta de Google Play para realizar validaciones y pruebas de carga en tu implementación antes de distribuir la app a todos tus usuarios.

Con los grupos de evaluación alfa y beta, los usuarios reales (que tú elijas) pueden instalar tu app desde Google Play y probar tus productos integrados en la aplicación. Pueden realizar compras reales que generen costos reales en sus cuentas, a través de cualquiera de sus métodos de pago comunes en Google Play para compras. Ten en cuenta que si incluyes cuentas de prueba de licencias en tus grupos de distribución alfa y beta, los usuarios en cuestión solo podrán realizar compras de prueba.

Importante: Luego de que publiques tu app en un canal alfa o beta, tus evaluadores deberán participar en la prueba alfa o beta de esta por medio de la URL de participación proporcionada para poder realizar compras de prueba.

Pruebas con respuestas estáticas

Te recomendamos que primero pruebes tu implementación de facturación integrada usando respuestas estáticas de Google Play. Esto te permite verificar que tu aplicación maneje correctamente las respuestas primarias de Google Play y pueda verificar correctamente las firmas. Puedes hacer esto incluso si la app aún no se ha publicado.

Para probar tu implementación con respuestas estáticas, debes realizar una solicitud de facturación integrada usando un artículo especial con un ID de producto reservado. Cada ID de producto reservado devuelve una respuesta estática específica de Google Play. No se transfiere dinero cuando haces solicitudes de facturación integrada con los ID de productos reservados. Además, no puedes especificar la forma de pago cuando haces una solicitud de facturación con un ID de producto reservado. En la figura 1 se muestra el flujo de finalización de la compra para el artículo reservado que tiene el ID de producto android.test.purchased.

Figura 1: Flujo de compra para el artículo reservado especial android.test.purchased.

No es necesario que enumeres los productos reservados en la lista de productos de tu aplicación. Google Play ya reconoce los ID de productos reservados. Tampoco necesitas cargar tu aplicación a la Developer Console para realizar pruebas de respuestas estáticas con los ID de productos reservados. Puedes simplemente instalar tu aplicación en un dispositivo, acceder al dispositivo y realizar solicitudes de facturación usando los ID de productos reservados.

Nota: Anteriormente, se podía probar una app cargando una versión de “borrador” no publicada. Ya no se admite esta funcionalidad. Sin embargo, puedes probar tu app con respuestas estáticas incluso antes de subirla a Google Play Store. Para obtener más información, consulta Ya no se admiten apps de borrador.

Hay cuatro ID de productos reservados para probar respuestas estáticas de facturación integrada:

  • android.test.purchased

    Cuando realizas una solicitud de facturación integrada con este ID de producto, Google Play responde como si compraras correctamente un artículo. En la respuesta se incluye una string JSON, que contiene información de compra falsa (por ejemplo, un ID de pedido falso). En algunos casos, la string JSON se firma y la respuesta incluye la firma para que puedas probar tu implementación de verificación de firmas por medio de estas respuestas.

  • android.test.canceled

    Cuando haces una solicitud de facturación integrada con este ID de producto, Google Play responde como si se hubiera cancelado la compra. Esto puede suceder cuando se encuentra un error en el proceso de pedido, como una tarjeta de crédito no válida, o cuando cancelas el pedido de un usuario antes de que se cobre.

  • android.test.refunded

    Cuando haces una solicitud de facturación integrada con este ID de producto, Google Play responde como si se hubiera reembolsado la compra. Los reembolsos no pueden iniciarse a través del servicio de facturación integrada de Google Play. Tú (el comerciante) debes iniciar los reembolsos. Una vez que procesas una solicitud de reembolso a través de tu cuenta de comerciante de Google Payments, Google Play envía un mensaje de reembolso a tu aplicación. Esto ocurre únicamente cuando Google Play recibe, por parte de Google Payments, la notificación de que se hizo un reembolso. Para obtener más información sobre reembolsos, consulta Gestionar mensajes de IN_APP_NOTIFY y Precios en la facturación integrada.

  • android.test.item_unavailable

    Cuando haces una solicitud de facturación integrada con este ID de producto, Google Play responde como si el artículo comprado no figurara en la lista de productos de tu aplicación.

En algunos casos, los artículos reservados pueden devolver respuestas estáticas firmadas, lo cual te permite probar la verificación de firmas en tu aplicación. Los artículos reservados solo devuelven respuestas firmadas si el usuario que ejecuta la aplicación tiene una cuenta de desarrollador o una cuenta de prueba.

Para hacer una solicitud de facturación integrada con un ID de producto reservado, simplemente se construye una solicitud normal de REQUEST_PURCHASE, pero en vez de un ID de producto real de la lista de productos de tu aplicación, se usa uno de los ID de productos reservados.

Para probar tu aplicación usando ID de productos reservados, sigue estos pasos:

  1. Instala tu aplicación en un dispositivo con tecnología Android.

    No puedes usar un emulador para probar la facturación integrada; debes instalar tu aplicación en un dispositivo para probar la facturación integrada.

    Para obtener información sobre cómo instalar una aplicación en un dispositivo, consulta Ejecución en un dispositivo.

  2. Accede a tu dispositivo con tu cuenta de desarrollador.

    No necesitas usar una cuenta de prueba si únicamente pruebas con los ID de productos reservados.

  3. Verifica que tu dispositivo tenga instalada una versión compatible de la aplicación de Google Play o la aplicación MyApps.

    Si tu dispositivo ejecuta Android 3.0, la facturación integrada requiere la versión 5.0.12 (o una versión posterior) de la aplicación MyApps. Si tu dispositivo cuenta con otra versión de Android, la facturación integrada requiere la versión 2.3.4 (o una versión posterior) de la aplicación de Google Play. Para obtener más información sobre cómo comprobar la versión de la aplicación de Google Play, visita Actualizar Google Play.

  4. Ejecuta tu aplicación y compra los ID de productos reservados.

Nota: Realizar solicitudes de facturación integrada con los ID de productos reservados anula el sistema de producción normal de Google Play. Cuando envíes una solicitud de facturación integrada para un ID de producto reservado, la calidad del servicio no será comparable con el entorno de producción.

Configuración para compras de prueba

Luego de que finalices tus pruebas de respuestas estáticas y compruebes que la verificación de firmas funciona en tu aplicación, puedes probar tu implementación de facturación integrada por medio de compras directas desde la aplicación reales. Probar compras directas desde la aplicación reales te permite probar la experiencia de facturación integrada de principio a fin, incluidas las compras reales desde Google Play y el flujo real para la finalización de la compra que los usuarios experimentarán en tu aplicación.

Nota: Puedes hacer pruebas integrales de tu aplicación si la publicas en un canal de distribución alfa. Esto te permite publicar la app en la Google Play Store, pero limita su disponibilidad únicamente a los evaluadores que designes.

Para probar tu implementación de facturación integrada con compras directas desde la aplicación reales, necesitarás registrar al menos una cuenta de prueba en la Google Play Developer Console. No puedes usar tu cuenta de desarrollador para probar el proceso completo de compras directas desde la aplicación porque Google Payments no te permite comprar tus propios artículos. Si no configuraste cuentas de prueba anteriormente, visita Configurar cuentas de prueba.

Una cuenta de prueba puede comprar un artículo en tu lista de productos únicamente si el artículo está publicado.

Para probar tu implementación de facturación integrada con compras reales, sigue estos pasos:

  1. Carga tu aplicación al canal de distribución alfa con la Developer Console.

    Nota: Anteriormente, se podía probar una app cargando una versión de “borrador” no publicada. Esta funcionalidad ya no se admite; en cambio, debes realizar la publicación en los canales de distribución alfa y beta. Para obtener más información, consulta Ya no se admiten apps de borrador.

  2. Agrega artículos a la lista de productos de la aplicación.

    Asegúrate de publicar los artículos (la aplicación puede permanecer sin publicarse). Consulta Crear una lista de productos para aprender a hacer esto.

  3. Instala tu aplicación en un dispositivo con tecnología Android.

    No puedes usar un emulador para probar la facturación integrada; debes instalar tu aplicación en un dispositivo para probar la facturación integrada.

    Para obtener información sobre cómo instalar una aplicación en un dispositivo, consulta Ejecución en un dispositivo.

  4. Verifica que tu dispositivo tenga instalada una versión compatible de la aplicación de Google Play o la aplicación MyApps.

    Si tu dispositivo ejecuta Android 3.0, la facturación integrada requiere la versión 5.0.12 (o una versión posterior) de la aplicación MyApps. Si tu dispositivo cuenta con otra versión de Android, la facturación integrada requiere la versión 2.3.4 (o una versión posterior) de la aplicación de Google Play. Para obtener más información sobre cómo comprobar la versión de la aplicación de Google Play, visita Actualizar Google Play.

  5. Realiza compras directas desde la aplicación en tu aplicación.

Nota: La única forma de cambiar la cuenta principal en un dispositivo es restablecer la configuración de fábrica, asegurándote de haber accedido primero con tu cuenta principal.

Cuando termines de probar tu implementación de facturación integrada, estás listo para publicar tu aplicación en Google Play. Puedes seguir los pasos normales para la preparación, la firma y la publicación en Google Play.

Ya no se admiten apps de borrador

Anteriormente, se podía publicar una versión de “borrador” de tu app para probarla. Ya no se admite esta funcionalidad. En cambio, hay dos formas en las que puedes probar la manera en que funciona la versión previa al lanzamiento de una app en Google Play Store:

  • Puedes publicar una app en los canales de distribución alfa o beta. Esto hace que la app esté disponible en la tienda de Google Play, pero únicamente para los evaluadores que incluyas en una “lista blanca”.
  • En algunos pocos casos, puedes probar la funcionalidad de Google Play con una app no publicada. Por ejemplo, puedes probar la compatibilidad con la facturación integrada de una app no publicada usando respuestas estáticas, ID de productos reservados que siempre muestran un resultado específico (como “comprado” o “reembolsado”).