Usar o Play Faturamento na sua Atividade confiável na Web

André Cipriani Bandarra

Além de permitir que seu app venda produtos e assinaturas digitais na Play Store, o Google Play Faturamento oferece ferramentas para gerenciar seu catálogo, preços e assinaturas, relatórios úteis e um fluxo de finalização de compra com a Play Store que já é familiar para seus usuários. Ele também é um requisito para apps publicados na Play Store que vendem produtos digitais.

O Chrome 88 está sendo lançado com um teste de origem no Android que permite a integração de atividades da Web confiáveis com a API Payment Request e a API Digital Goods para implementar fluxos de compra pelo Google Play Faturamento. Esperamos que esse teste de origem também esteja disponível para o ChromeOS na versão 89.

Para facilitar a integração com o app Android, a equipe de atividades confiáveis na Web está lançando uma biblioteca de extensões para android-browser-helper. Este guia mostrará as mudanças necessárias para integrar essa biblioteca a um aplicativo existente.

Observação:este artigo aborda a integração do app Android. Se você estiver usando o Bubblewrap para criar seu aplicativo, poderá usar a ferramenta para atualizar o app. A implementação no Bubblewrap está sendo rastreada neste problema. Este guia é destinado às pessoas que não usam o Bubblewrap para atualizar o app.

build.gradle

A biblioteca de extensão de faturamento depende da versão 2.1.0 do android-browser-helper. Verifique se o aplicativo está usando uma versão igual ou superior a ela.

Você também precisa adicionar uma declaração de implementação para a biblioteca de extensão de faturamento:

dependencies {
    ...
    implementation 'com.google.androidbrowserhelper:androidbrowserhelper:2.1.0'
    implementation 'com.google.androidbrowserhelper:billing:1.0.0-alpha05'
}

DelegationService.java

O android-browser-helper é enviado com um DelegationService padrão que pode ser usado diretamente pelos apps. Ao usar a extensão de faturamento, você precisa de uma versão um pouco personalizada do DelegationService.

Para fazer isso, você precisa criar sua própria classe DelegationService que estenda a original e substitua onCreate(). Dentro de onCreate(), você precisa adicionar uma única chamada de método que registre o aplicativo como um gerenciador da API Digital Goods:

package com.example.yourapp;

import com.google.androidbrowserhelper.playbilling.digitalgoods.DigitalGoodsRequestHandler;
import com.google.androidbrowserhelper.trusted.DelegationService;

public class DelegationService
        extends com.google.androidbrowserhelper.trusted.DelegationService {
    @Override
    public void onCreate() {
        super.onCreate();
        registerExtraCommandHandler(new DigitalGoodsRequestHandler(getApplicationContext()));
    }
}

AndroidManifest.xml

No manifesto do Android, você vai precisar mudar a referência para a biblioteca de delegação da sua própria implementação. Na declaração service correspondente, substitua com.google.androidbrowserhelper.trusted.DelegationService pela classe recém-criada.

<service
    android:name=".DelegationService"
    android:exported="true">

    <intent-filter>
        <action android:name="android.support.customtabs.trusted.TRUSTED_WEB_ACTIVITY_SERVICE"/>
        <category android:name="android.intent.category.DEFAULT"/>
    </intent-filter>
</service>

A biblioteca de faturamento também apresenta dois novos componentes que precisam ser adicionados ao manifesto do Android: um serviço a que o navegador pode se conectar e verificar se o aplicativo oferece suporte ao pagamento e uma atividade, que processa o fluxo de pagamento em si:

<activity
    android:name="com.google.androidbrowserhelper.playbilling.provider.PaymentActivity"
    android:theme="@android:style/Theme.Translucent.NoTitleBar"
    android:configChanges="keyboardHidden|keyboard|orientation|screenLayout|screenSize"
    android:exported="true">
    <intent-filter>
        <action android:name="org.chromium.intent.action.PAY" />
    </intent-filter>
    <meta-data
        android:name="org.chromium.default_payment_method_name"
        android:value="https://play.google.com/billing" />
</activity>
<!-- This service checks who calls it at runtime. -->
<service
    android:name="com.google.androidbrowserhelper.playbilling.provider.PaymentService"
    android:exported="true" >
    <intent-filter>
        <action android:name="org.chromium.intent.action.IS_READY_TO_PAY" />
    </intent-filter>
</service>

Saiba mais sobre a API Digital Goods e o Google Play Faturamento

Este artigo abordou as etapas necessárias especificamente no aplicativo Android que usa a atividade da Web confiável, mas a API Google Play Faturamento tem sua própria terminologia e inclui componentes de cliente e back-end. Recomendamos que você leia a documentação do Google Play Faturamento e da API Digital Goods e entenda os conceitos antes de integrar a API a um aplicativo em produção.