Notas da versão da API Google Play Developer

Este documento contém notas da versão das APIs Google Play Developer.

6 de julho de 2026

Novos recursos

• Atualizações na responsabilidade pelos custos de estorno: o Google Play agora oferece suporte a um processo colaborativo de contestação de estorno.

  • Notificações de análise de reembolso pendente: um novo tipo de notificação do desenvolvedor em tempo real (RTDN, na sigla em inglês), PendingRefundReviewNotification, é enviado quando um usuário solicita um estorno que exige sua análise. As análises pendentes só oferecem suporte a CHARGEBACK como motivo do reembolso.

  • API ReviewRefund: você pode avaliar essas solicitações e responder em até 24 horas chamando a nova API orders.reviewrefund. Na chamada da API, é necessário fornecer uma preferência de reembolso (como APPROVE, DECLINE ou NEUTRAL) e evidências relevantes de uso da compra (como endereço IP do usuário, porcentagem de consumo cumulativo e localização geográfica aproximada) para ajudar o Google Play a contestar o estorno.

19 de maio de 2026

Novos recursos

• ID do pedido pendente: a API SubscriptionPurchaseV2 agora inclui os campos onHoldStateContext e inGracePeriodStateContext. Esses campos fornecem mais detalhes, como o ID do pedido pendente ou com falha, quando uma assinatura entra no estado ON_HOLD ou IN_GRACE_PERIOD devido a um pagamento de renovação recusado.

Suspensões de uso

• Algumas das APIs de assinatura foram descontinuadas. Para mais informações, consulte Suspensão de uso da API Subscription de maio de 2026.

27 de janeiro de 2026

Novos recursos

• Adiar assinatura com complementos: antes, a API Google Play Developer permitia o adiamento do faturamento apenas para assinaturas individuais. A funcionalidade de adiamento agora está disponível para assinaturas individuais e com complementos usando o purchases.subscriptionsv2.defer método. Ao adiar a data de faturamento de uma assinatura com complementos, a data de faturamento de todos os itens da assinatura é adiada pela duração especificada.

• OfferPhase: o campo OfferPhase agora está disponível na API SubscriptionPurchaseV2. Esse campo fornece a fase atual da assinatura como um período proporcional, teste sem custo financeiro, preço inicial e preço do plano básico.

19 de novembro de 2025

Novos recursos

• Processamento de nova assinatura aprimorado.

  • O campo outOfAppPurchaseContext agora está disponível em SubscriptionPurchaseV2, o que ajuda a vincular compras de novas assinaturas feitas na Google Play Store, fornecendo detalhes da assinatura expirada.
  • O método purchases.subscriptions.acknowledge agora aceita opcional externalAccountId no corpo da solicitação, o que permite associar a compra de nova assinatura aos identificadores do usuário.

• O campo SubscriptionPurchaseLineItem.itemReplacement agora está disponível em SubscriptionPurchaseV2, que oferece detalhes sobre o item que está sendo substituído, se aplicável.

• A API Orders agora inclui o campo offerPhaseDetails, que fornece informações mais detalhadas sobre os pedidos que financiam um período proporcional.

11 de setembro de 2025

Novos recursos

• A API SubscriptionPurchaseV2 agora oferece o método cancel.

  Esse método oferece um aprimoramento da funcionalidade existente purchases.subscriptions.cancel, introduzindo suporte para o cancellationType parâmetro nas bibliotecas de cliente.

• Os recursos de consentimento de aumento de preço estão disponíveis:

  • Um novo campo foi adicionado à SubscriptionPurchaseV2: SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details.

  • Um novo tipo de notificação do desenvolvedor em tempo real SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED está disponível.

30 de junho de 2025

Novos recursos

• A nova API ProductPurchaseV2, que oferece suporte a várias opções de compra e ofertas para produtos únicos, está disponível.

21 de maio de 2025

Suspensões de uso

• Algumas das APIs de assinatura foram descontinuadas. Para mais informações, consulte Suspensão de uso da API Subscription.

Novos recursos

• Os novos campos a seguir estão disponíveis na SubscriptionPurchaseV2:

  • SubscriptionPurchaseLineItem.latest_successful_order_id
  • PriceChangeState.CANCELED

• O método subscriptionsv2.revoke agora oferece a opção item_based_refund.

• A API Orders agora oferece os métodos get e batchGet.

Outras mudanças

• O parâmetro subscriptionId é opcional nas APIs purchases.subscriptions.