lightbulb_outline Help shape the future of the Google Play Console, Android Studio, and Firebase. Start survey

Información general sobre facturación integrada

En este documento se describen los componentes y las funciones fundamentales de la facturación integrada que debes comprender para agregar funciones de facturación integrada a tu aplicación.

Nota: Asegúrate de cumplir con las leyes vigentes de los países en los que distribuyas apps. Por ejemplo, en los países de la UE, las leyes basadas en la Directiva sobre prácticas comerciales desleales prohíben incitar directamente a los niños a comprar productos publicitados o persuadir a sus padres o demás adultos para que compren por ellos los productos publicitados. Lee la posición de las autoridades de protección al consumidor de la UE para obtener más información sobre este y otros temas.

In-app Billing API

Tu aplicación accede al servicio de facturación integrada usando una API expuesta por la app de Google Play instalada en el dispositivo. La app de Google Play luego transmite las solicitudes y respuestas de facturación entre tu aplicación y el servidor de Google Play. En la práctica, tu aplicación nunca se comunica directamente con el servidor de Google Play. En cambio, tu aplicación envía solicitudes de facturación a la app de Google Play a través de la comunicación entre procesos (IPC) y recibe respuestas de la app de Google Play. Tu aplicación no gestiona ninguna conexión de red entre ella y el servidor de Google Play.

Solo puedes implementar la facturación integrada en aplicaciones que publiques a través de Google Play. Para completar solicitudes de compra directa desde la aplicación, la app de Google Play debe poder acceder al servidor de Google Play a través de la red.

La versión 3 de la facturación integrada es la última versión y ofrece una amplia compatibilidad entre los distintos dispositivos Android. Es compatible con dispositivos que tengan instalado Android 2.2 (nivel 8 de API) o versiones posteriores y la última versión de la aplicación de Google Play (la gran mayoría de dispositivos activos).

Funciones de la versión 3

La versión 3 de facturación integrada ofrece las siguientes funciones:

  • Tu app envía solicitudes a través de una API optimizada que permite a los usuarios solicitar fácilmente detalles de productos desde Google Play y ordenar productos integrados en la aplicación. La API restablece rápidamente los productos según lo que el usuario posee.
  • La API propaga de manera sincrónica la información de pedido al dispositivo cuando se completa la compra.
  • Todas las compras son gestionadas (es decir, Google Play lleva registro de los productos integrados en la aplicación que el usuario posee). El usuario no puede tener distintas copias de un producto integrado en la aplicación; solo una copia puede ser suya en todo momento.
  • Los productos comprados se pueden consumir. Cuando se consume, el producto vuelve al estado de no adquirido y se restablece su disponibilidad para la compra desde Google Play.
  • La API ofrece compatibilidad con las suscripciones.

Para más información sobre otras versiones de facturación integrada, consulta Notas de la versión.

Productos integrados en la aplicación

Los productos integrados en la aplicación son los productos digitales que ofreces a los usuarios para la venta desde tu aplicación. Algunos ejemplos de productos digitales pueden ser: dinero en un juego, mejoras en las funciones de una aplicación para enriquecer la experiencia del usuario y contenido nuevo para tu aplicación.

Puedes usar la facturación integrada para vender únicamente contenido digital. No puedes usarla para vender productos físicos, servicios personales u otras cosas que requiera una entrega física. A diferencia de las aplicaciones pagas, no se muestra una ventana de reembolso luego de que el usuario compra un producto integrado en la aplicación.

Google Play no ofrece ninguna forma de entrega de contenido. Tienes la responsabilidad de entregar el contenido digital que vendas en tus aplicaciones. Los productos integrados en la aplicación siempre se asocian de manera explícita con una única aplicación. Es decir, desde una aplicación no es posible comprar un producto integrado en la aplicación que se publique para otra app, aunque estas pertenezcan al mismo desarrollador.

Tipos de productos

Para ofrecerte flexibilidad en la manera de monetizar tu aplicación, la facturación integrada es compatible con distintos tipos de productos. En todos los casos, tus productos se definen a través de la Google Play Developer Console.

Puedes especificar dos tipos de productos para tu aplicación con facturación integrada: productos integrados en la aplicación gestionados y suscripciones. Google Play gestiona y controla la propiedad para los productos integrados a la aplicación y suscripciones para tu aplicación por cada usuario. Obtén más información sobre los tipos de productos compatibles con la versión 3 de facturación integrada.

Google Play Developer Console

La Developer Console es el espacio en el que puedes publicar tu aplicación con facturación integrada y gestionar los distintos productos integrados en la aplicación que estén disponibles para la compra desde tu aplicación.

Puedes crear una lista de productos con los productos digitales que estén asociados a tu aplicación, como los productos para la compra única y las suscripciones periódicas. Para cada producto, puedes definir información como la siguiente:

  • ID único del producto (también llamado SKU);
  • tipo de producto;
  • precio;
  • descripción;
  • gestión y registro de compras para ese producto por parte de Google Play.

Si vendes varios ejemplares de tus apps o productos integrados en la aplicación al mismo precio, puedes agregar plantillas de precios para gestionar estos precios competitivos desde una ubicación centralizada. Al usar plantillas de precios, puedes incluir impuestos locales dentro de los precios que ofrezcas o bien proporcionar los precios y dejar que el sistema les agregue estos impuestos. Puedes aplicar modificaciones a los precios en tus plantillas de precios, como la actualización de las tasas de cambio para ciertos países, y tus cambios tienen efecto en las apps y los productos integrados en la aplicación que vincules a la plantilla.

También puedes crear cuentas de prueba a fin de autorizar el acceso para probar aplicaciones que no estén publicadas.

Si deseas aprender a usar la Developer Console para configurar tus productos integrados en la aplicación y la lista de productos, consulta Administrar la facturación integrada.

Flujo de compra de Google Play

Para finalizar la compra, Google Play usa el mismo servicio de backend que el de las compras de aplicaciones; por lo tanto, tus usuarios experimentan un flujo de compra uniforme y familiar.

Importante: Debes tener una cuenta de comerciante de Google Payments para poder usar el servicio de facturación integrada en Google Play.

Para iniciar una compra, tu aplicación envía una solicitud de facturación de un producto integrado en la aplicación específico. Luego, Google Play gestiona toda la información detallada del proceso de finalización de compra de la transacción; se incluyen la solicitud y validación del formulario de pago y el procesamiento de la operación financiera.

Cuando se completa el proceso de finalización de compra, Google Play envía a tu aplicación los datos detallados de la compra, como el número, la fecha y la hora del pedido, y el precio abonado. Tu aplicación no debe gestionar transacciones financieras en ningún momento. De eso se encarga Google Play.

Ejemplo de aplicación

Para ayudarte a integrar la facturación integrada en tu aplicación, en el Android SDK se ofrece un ejemplo de aplicación en el que se muestra la manera de vender suscripciones y productos integrados a la aplicación desde una app.

En el ejemplo TrivialDrive para la Version 3 API se muestra la manera de usar la In-app Billing Version 3 API para implementar compras de suscripciones y productos integrados en la aplicación para un juego de conducción. En la aplicación se muestra la manera de enviar solicitudes de facturación integrada y gestionar respuestas sincrónicas desde Google Play. También se muestra la manera de registrar el consumo de productos con la API. En el ejemplo de la versión 3 se incluyen clases de conveniencia para procesar operaciones de facturación integrada y realizar la verificación automática de firmas.

Recomendación: Asegúrate de ocultar el código en tu aplicación antes de publicarla. Para obtener más información, consulta Seguridad y diseño.

Consideraciones para la migración

La In-app Billing Version 2 API se discontinuó en enero de 2015. Si en tu implementación de facturación integrada actual se usa esta versión o una anterior, debes migrar a la In-app Billing Version 3.

Luego de la migración, los productos gestionados y no gestionados se manejan de la siguiente manera:

  • Los productos gestionados y las suscripciones que hayas definido previamente en la Developer Console funcionan con la versión 3 al igual que antes.
  • Los productos no gestionados que hayas definido para aplicaciones existentes se tratan como productos gestionados si haces una solicitud de compra de estos usando la Version 3 API. No necesitas crear una nueva entrada de producto en la Developer Console para estos productos, y puedes usar las mismas ID de producto para gestionarlos.