APIs de facturación alternativa

Los desarrolladores aptos pueden ofrecer a los usuarios de ciertos países un sistema alternativo de facturación en su app e informar las transacciones resultantes a Google. Según el lugar donde distribuyas la app y la elegibilidad, hay dos versiones de facturación alternativa que una app puede compilar:

En esta guía, se abordan las APIs que deben usarse para cualquiera de las ofertas. Debes consultar las páginas del programa y, luego, inscribirte en los programas correspondientes antes de usar estas APIs.

Glosario de términos

Convenciones de términos que se siguen en esta guía:

  • APIs de facturación alternativa: Son las APIs que se usan para mostrar las pantallas aplicables a los usuarios y permitir que los desarrolladores informen las transacciones completadas en el sistema alternativo de facturación del desarrollador.
  • Sistema alternativo de facturación: Es el sistema alternativo de facturación de un desarrollador que se puede ofrecer junto con el sistema de facturación de Google Play o por su cuenta (sujeto a los requisitos de elegibilidad).
  • Transacción externa: Es una transacción que se realiza fuera del sistema de Facturación Google Play.
  • Token de transacción externa: Es un token que se proporciona al desarrollador a través de la Biblioteca de Facturación Play para que lo use cuando el usuario complete un sistema alternativo de facturación. Este token se usa para notificar a Google Play sobre una compra exitosa.
  • ID de transacción externa: Es un identificador único que genera el desarrollador para identificar una transacción.

Cómo ofrecer una facturación alternativa con la elección del usuario

En esta sección, se describe cómo ofrecer a los usuarios una facturación alternativa con la opción de usar el sistema de facturación de Google Play. Antes de usar estas APIs, asegúrate de hacer lo siguiente:

El resto de los módulos recomendados para la integración de la Facturación Google Play son los mismos que los desarrolladores ya tendrían para su integración actual.

Además, te recomendamos tener lista una configuración de integración de la API de Google Play Developer, ya que la integración de backend la aprovechará.

Configuración en Play Console

Los desarrolladores que completaron la inscripción para el programa de facturación alternativa con elección del usuario correspondiente y que realizaron la integración con APIs de facturación alternativa pueden administrar su configuración de facturación alternativa a través de Play Console.

  • En cada una de tus apps aptas, puedes elegir si ofrecer o no un sistema alternativo de facturación.
  • Sube logotipos de las formas de pago de acuerdo con los lineamientos y con todas las especificaciones de formato. Las imágenes que no cumplan con estos lineamientos no se mostrarán para tu sistema alternativo de facturación en la pantalla de elección del usuario. (Nota: Incluir logotipos de formas de pago es opcional, aunque muy recomendable).
  • Si ofreces suscripciones, proporciona el vínculo requerido de administración de suscripciones.
IU de prueba, diseñada con fines ilustrativos, sujeta a cambios.

Experiencia del usuario

Las APIs del cliente habilitan la siguiente funcionalidad:

  • Google Play renderiza y administra la información aplicable y las pantallas de elección del usuario.
  • Si el usuario elige usar el sistema de facturación de Google Play, el flujo de facturación continúa usando la interfaz estándar de facturación de Google Play.

App de desarrollador

Pantalla de selección de facturación

Ejemplo solo con fines ilustrativos.

Pantalla de elección del usuario

La pantalla de elección del usuario presenta a los usuarios la opción de usar el sistema alternativo de facturación del desarrollador o el sistema de facturación de Google Play.

Anatomía de una opción de facturación alternativa

La opción de facturación alternativa en la pantalla de elección del usuario incluye los siguientes elementos de la IU:

  1. Ícono de la app
  2. Nombre de la app
  3. Elemento de imagen que incluye formas de pago que ofrece el desarrollador
  4. El indicador adicional (y más de la IU no forma parte del recurso de imagen)

Recurso de imagen para las formas de pago

El recurso de imagen única se compone de varias tarjetas de forma de pago y debe seguir las especificaciones que se definen en estos lineamientos.

Dimensiones

192 dp X 20 dp

Espacio para tarjetas

8 dp

Formato de archivo

PNG, fondo transparente

Variaciones de las formas de pago

Los desarrolladores pueden elegir la cantidad de íconos de formas de pago disponibles que desean incluir en el recurso de imagen, hasta un máximo de 5.

No se debe incluir ninguna otra imagen ni texto.

Especificaciones de la tarjeta

Las tarjetas de forma de pago que se incluyen en el recurso de imagen deben seguir los siguientes lineamientos sobre tamaño, espaciado y estilo.

Dimensiones de la tarjeta 32 dp X 20 dp
Padding interno 3 dp
Contorno 1 dp (brazo interno incluido en las dimensiones); radio 2 dp, #E0E0E0
Fondo de la tarjeta Color sólido (preferentemente blanco)

Próximos pasos

Para comenzar a integrar las APIs de facturación alternativa con la elección del usuario, sigue las guías detalladas sobre la integración en la app y la integración de backend.

Cómo ofrecer solo facturación alternativa

En esta sección, se describe cómo ofrecer a los usuarios una facturación alternativa sin la opción de usar el sistema de facturación de Google Play. Antes de usar estas APIs, asegúrate de hacer lo siguiente:

Te recomendamos tener lista una configuración de integración de la API de Google Play Developer, ya que la integración de backend la aprovechará.

Configuración en Play Console

Los desarrolladores que completaron la inscripción y realizaron la integración con APIs de facturación alternativa pueden administrar su configuración de facturación alternativa a través de Play Console:

  • En cada una de tus apps aptas, habilita o inhabilita la oferta de solo facturación alternativa (sin elección del usuario) en cada país disponible.
IU de prueba, diseñada con fines ilustrativos, sujeta a cambios.

Pantalla de información para los usuarios

La pantalla de información ayuda a los usuarios a comprender que solo se ofrece un sistema alternativo de facturación dentro de la app apta. La pantalla de información se mostrará a los usuarios al comienzo de su primera compra en tu app, una vez que se haya habilitado la facturación alternativa. Este mensaje no se mostrará en las compras posteriores que realice el mismo usuario en la app, en el mismo dispositivo. Ten en cuenta que, en algunas ocasiones, es posible que el diálogo se vuelva a mostrar a un usuario en situaciones como cuando el usuario borra la caché de su dispositivo.

Próximos pasos

Para comenzar a integrar las APIs de facturación alternativa, sigue las guías detalladas sobre la integración en la app y la integración de backend.