API de compras integradas

Venda productos digitales y suscripciones en su aplicación Android WebView con Google Play Billing.

Dentro de algunas apps, se puede comprar contenido o servicios adicionales. Este tipo de compras se denominan «compras integradas» (in-app purchases). Pueden ser una fuente de ingresos atractiva para los desarrolladores y muy cómodas para los clientes, ya que utilizan las cuentas y los métodos de pago existentes para la liquidación. WebViewGold permite activar las compras integradas de Google Play. Asegúrese de disponer de una Licencia Extendida de WebViewGold si tiene previsto utilizar esta función en un producto final. ¿Necesita ampliarla? Aprenda cómo ampliarla aquí.

Opción 1 (predeterminada): RevenueCat

Cree su cuenta gratuita de RevenueCat para empezar. La información sobre precios está disponible en su sitio web. Después, configure RevenueCat siguiendo sus asistentes de configuración y su documentación (los detalles de precios están disponibles en su sitio web). A continuación, añada sus datos a Config.java. Este enfoque también es compatible con el programa de tarifa de servicio reducida del 15 % de Google Play Store y con el Small Business Program de Apple. Si participa en estos programas de tarifa reducida, informe a RevenueCat a través de sus páginas Apple Small Business Program o tarifa de servicio reducida del 15 % de Google. Así es como se ve la configuración en Config.java:

public static final String REVENUECAT_API_KEY = "xxxxxxxsxxxxxxxxxxxxxxxxxxxxxxxxxx"; //Your RevenueCat API Key (sign up via tinyurl.com/register-revenuecat first, then follow tinyurl.com/api-key-revenuecat how to find it)
public static final String REVENUECAT_PROJECT_ID = "xxxxxxx"; //Your RevenueCat Project ID (sign up via tinyurl.com/register-revenuecat first, then follow tinyurl.com/project-id-revenuecat how to find it)

Asegúrese de que el nombre de paquete de su APK y de Google Play Console coincida con el proyecto configurado en RevenueCat. Active una compra o suscripción utilizando:

revenuecat://purchase?external_id=user_123&product=sub_30_days

external_id = identificador de usuario, p. ej. el correo electrónico de su cliente o su ID de usuario. product = ID mostrado en la consola de RevenueCat. Funciona tanto en Android como en iOS.

Opción 2: Manual (sin RevenueCat)

Nos comprometemos a ayudar a nuestros clientes de WebViewGold a tener éxito, y queremos llamar su atención sobre el programa de tarifa de servicio reducida del 15 % de Google Play Store y el Small Business Program de Apple. Estos programas permiten a los desarrolladores que cumplan los requisitos optar a una comisión del 15 %, una reducción significativa respecto al 30 % estándar. La solicitud es rápida y sencilla, y puede ahorrarle hasta un 50 % en comisiones al reducir las tasas de comisión de Google y Apple del 30 % al 15 %. Una vez aprobado, recibirá la tarifa de comisión reducida para todas las apps de pago y las compras integradas que realicen los clientes en las respectivas tiendas. Para obtener más información sobre el programa de Google Play, haga clic aquí, y para el programa de Apple, visite aquí.

Tras la configuración, para los productos de compra integrada simplemente enlace a este tipo de URL:

<a href="inapppurchase://?package=purchase_package_identifier_name_here&disableadmob=true&consumable=true&successful_url=https://www.google.com">Buy In-App Purchase</a>
        

• El «package» es el identificador de producto del artículo que desea vender.
• La «successful_url» es la URL que desea que la app cargue una vez completada la compra.
  • Quizá desee guardar una cookie en esta página para que su app web recuerde que se ha realizado la compra.
• Incluya «disableadmob=true» si desea desactivar los anuncios tras la compra del producto.
• Para permitir que se vuelva a cobrar al usuario por el mismo producto de compra integrada (si lo compra de nuevo), establezca el atributo «consumable» en true. Por el contrario, si desea evitar que se vuelva a cobrar al usuario por el mismo producto (si lo compra de nuevo), establezca «consumable» en false u omítalo por completo (ya que false es el valor predeterminado). Asegúrese de utilizar WebViewGold para Android v12.5 o una versión más reciente.

<a href="inappsubscription://?package=purchase_package_identifier_name_here&expired_url=https://www.yahoo.com&successful_url=https://www.google.com">Start In-App Subscription</a>
        

• El «package» es el identificador de producto de la suscripción que desea vender.
• La «successful_url» es la URL que desea que la app cargue una vez completada la compra.
  • Quizá desee guardar una cookie en esta página para que su app web recuerde que se ha activado la suscripción.
• La «expired_url» es la URL que desea que la app cargue cuando la suscripción deje de ser válida.
  • Quizá desee actualizar o eliminar una cookie en esta página para que su app web recuerde que se ha desactivado la suscripción.

Gestionar/cancelar suscripciones: WebViewGold para Android puede enlazar directamente a la pantalla de gestión de suscripciones de Play Store: solo tiene que apuntar su enlace a cancelinapppurchase://:

<script>
<a href="cancelinapppurchase://">Manage/cancel subscription in Google Play</a>
<script>

<script>
<a href="restoreinapppurchases://">Restore</a>
<script>

<script>
// Utility function to wait for a variable to be defined
function waitForVariable(variableName, callback, timeout = 5000) {
    const startTime = Date.now();

    (function checkVariable() {
        if (window[variableName] !== undefined) {
            callback(window[variableName]);
        } else if (Date.now() - startTime < timeout) {
            setTimeout(checkVariable, 100);
        } else {
            console.error(`Timeout: ${variableName} was not set within ${timeout} ms`);
        }
    })();
}

// Example: Handling In-App Purchase/Subscription variables
waitForVariable("planID", function(planID) {
    console.log("planID:", planID);
    // Send the Product ID to your server
    sendToServer("planID", planID);
});

waitForVariable("transactionIdentifier", function(transactionIdentifier) {
    console.log("transactionIdentifier:", transactionIdentifier);
    // Send the Transaction ID to your server
    sendToServer("transactionIdentifier", transactionIdentifier);
});

waitForVariable("subreceipts", function(subreceipts) {
    console.log("subreceipts:", subreceipts);
    // Send Subscription Receipt IDs to your server
    sendToServer("subreceipts", subreceipts);
});

// Function to send data to your server for validation
function sendToServer(key, value) {
    fetch("https://example.com/api/validate", {
        method: "POST",
        headers: {
            "Content-Type": "application/json"
        },
        body: JSON.stringify({ [key]: value })
    })
    .then(response => response.json())
    .then(data => console.log(`Server Response for ${key}:`, data))
    .catch(error => console.error(`Error sending ${key}:`, error));
}
</script>

Precios localizados / obtener la ubicación de la tienda: El esquema de URL getstorelocation:// inyecta la ubicación de Play Store en una variable JavaScript. Cuando se llama o se enlaza getstorelocation://, el wrapper de WebViewGold obtiene el código de país de Play Store, si está disponible. Como alternativa, considere establecer autoInjectVariable en true en el archivo de configuración para inyectar automáticamente este valor (y otros) en JavaScript sin necesidad de una llamada a una URL. A continuación, el código de país se inyecta en una variable JavaScript storeLocation para su uso posterior por parte de su app web (p. ej., para mostrar precios localizados). Si el código no está disponible, storeLocation se establecerá en null:

• Si tiene éxito (ejemplo, Estados Unidos): var storeLocation = 'US';
• Si no se encuentra ningún código de país: var storeLocation = null;

Nota: como con cualquier tecnología, es fundamental mencionar que, también al utilizar nuestra API, existe el riesgo de que algunos usuarios (con conocimientos técnicos) puedan acceder al contenido restringido sin pagar por él. Esto podría ocurrir, por ejemplo, al recuperar y abrir directamente el enlace de la Success URL, al desinstalar la app y cancelar después los productos de suscripción para que la Expiration URL nunca se llame (para minimizar este riesgo, puede, por tanto, solicitar reautorizaciones de forma ocasional) o mediante el ejercicio del derecho de desistimiento o los procesos de devolución de cargos de las tarjetas de crédito. No obstante, conviene señalar que algún tipo de riesgo está presente en cualquier enfoque digital. En general, nuestra API es un enfoque práctico y fácil de integrar para entregar contenido de pago a los usuarios de la app, y seguimos trabajando en formas de reducir aún más los riesgos. El uso de nuestra API sigue siendo bajo su propia responsabilidad y sin garantía, pero, en conjunto, aunque es esencial ser consciente del riesgo de acceso no autorizado o no pagado al contenido, las ventajas de utilizar nuestra API superan con creces los riesgos para la mayoría de los usuarios. Se recomienda hacer un seguimiento y comparar los datos de ventas de la Google Play Store Developer Console con las activaciones del lado del servidor de los productos de compra integrada para garantizar informes de ingresos precisos e identificar posibles discrepancias.