Os produtos de compra única têm um ciclo de vida mais simples do que os produtos por assinatura, mas ainda há vários estados e eventos de transição que o back-end precisa para processar corretamente.
Novas compras de produtos únicos
Depois que o usuário conclui o fluxo de faturamento, o app pode acessar informações sobre a nova compra de uma destas maneiras:
- Implementando a interface
PurchasesUpdatedListener
deBillingClient
para receber atualizações automáticas sobre a compra. - Chamando o
método
BillingClient.queryPurchasesAsync()
.
Depois de receber a nova compra, use o
método getPurchaseState
para determinar o estado de pagamento dela.
Transações pendentes
As compras de produtos únicos só geram RTDNs quando estão pendentes. O
formato do campo data
para esse tipo de RTDN é
OneTimeProductNotification
. Para
atualizar o estado de compra do back-end, use o token fornecido no objeto
OneTimeProductNotification
para chamar o
método
purchases.products.get
. Esse método fornece o status de compra e consumo mais recente, considerando um
token de compra.
Processe os RTDNs relacionados a transações no back-end seguro.
Processar transações concluídas
Quando um usuário conclui uma compra pendente de um produto único, o Google Play envia uma
mensagem OneTimeProductNotification
com o tipo ONE_TIME_PRODUCT_PURCHASED
.
Quando você receber esse RTDN, processe a compra conforme descrito em Processar
compras de produtos únicos no back-end.
Processar transações canceladas
Quando uma compra pendente de um produto único é cancelada, o Google Play envia uma
mensagem OneTimeProductNotification
com o tipo ONE_TIME_PRODUCT_CANCELED
.
Por exemplo, isso poderá ocorrer se o usuário não concluir o pagamento dentro do
período necessário. Quando o servidor de back-end receber essa notificação, chame
o método
purchases.products.get
para conferir o estado mais recente da compra e atualize o back-end de acordo com ele,
incluindo os direitos do usuário.
Apenas compras de produtos únicos no estado Pending
podem ser canceladas. Se uma
compra de produto único no estado Purchased
for reembolsada, você vai receber
uma notificação pela API Voided Purchases.
Processar compras de produtos únicos no back-end
Se você detectou uma nova compra com uma RTDN de ONE_TIME_PRODUCT_PURCHASED
ou recebeu um aviso no app usando
PurchasesUpdatedListener
ou buscando manualmente compras no
método onResume()
do app, será preciso processar a nova compra. Recomendamos
processar as compras no back-end para maior segurança.
Siga estas etapas para processar uma nova compra única:
- Consulte o endpoint
purchases.products.get
para conferir o status mais recente da compra do produto único. Para chamar esse método para uma compra, você precisa dopurchaseToken
correspondente do seu app ou do RTDNONE_TIME_PRODUCT_PURCHASED
. - Chame
getPurchaseState()
e verifique se o estado de compra éPURCHASED
. - Verifique a compra.
- Conceda ao usuário o acesso ao conteúdo. A conta de usuário associada à
compra poderá ser identificada com o campo
obfuscatedExternalAccountId
depurchases.products.get
se um código tiver sido definido usandosetObfuscatedAccountId()
quando a compra foi feita.- Para compras de produtos que não são de consumo, confirme o envio do conteúdo
chamando o
método
purchases.products.acknowledge
. Confira se a compra não foi confirmada anteriormente verificando o campoacknowledgementState
. - Se o produto for de consumo, marque o item como consumido chamando o método
purchases.products.consume
. Assim, o usuário poderá comprar o item novamente depois de consumi-lo. Esse método também confirma a compra.
- Para compras de produtos que não são de consumo, confirme o envio do conteúdo
chamando o
método
A Biblioteca Play Faturamento também tem disponíveis confirmações de compra e métodos de consumo que permitem processar compras no seu app, mas recomendamos processá-la no back-end, se você tiver um, para ter uma implementação mais segura.