Reminder: By Aug 31, 2025, all new apps and updates to existing apps must use Billing Library version 7 or newer. If you need more time to update your app, you can request an extension until Nov 1, 2025. Learn about
Play Billing Library version deprecation.
APIs de ofertas externas
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Em alguns países, os desenvolvedores qualificados podem direcionar usuários para fora do
app, inclusive para promover ofertas de recursos e serviços digitais no app. Neste
guia, abordamos as APIs para ativar ofertas externas. Analise os
requisitos do programa e se inscreva no programa de ofertas externas antes
de usar essas APIs.
Glossário de termos
Convenções de termos seguidas por este guia:
- APIs de ofertas externas: APIs usadas para direcionar o usuário para fora do app,
incluindo exibição da tela de informações necessárias e geração de relatórios de transações
aplicáveis.
- Transação externa: uma transação qualificada que ocorre fora
do app, conforme definido pelos requisitos do programa.
- Token de transação externa: um token fornecido ao desenvolvedor pela
Biblioteca Play Faturamento a ser usado quando o usuário concluir
uma transação externa. Esse token é usado para
notificar o Google Play sobre uma compra realizada.
- ID da transação externo: um identificador exclusivo gerado pelo desenvolvedor
para identificar uma transação externa.
Suporte a ofertas externas
Nesta seção, descrevemos como oferecer suporte a ofertas externas.
Antes de usar essas APIs, verifique o seguinte:
Configurar no Play Console
Para configurar ofertas externas no Play Console, siga as etapas descritas nos
requisitos do programa.
A tela de informações ajuda os usuários a entender que estão prestes a visitar um
site externo. A tela de informações será mostrada aos usuários todas as vezes antes
de eles serem direcionados para fora do app usando as APIs de ofertas externas.
Tela de informações
|
Exemplo com fins ilustrativos.
Próximas etapas
Para começar a integrar as APIs de ofertas externas, siga os guias detalhados
da integração no app e da integração de back-end.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[null,null,["Última atualização 2025-07-27 UTC."],[],[],null,["# External offers APIs\n\nIn certain countries, eligible developers are able to lead users outside the\napp, including to promote offers for in-app digital features and services. This\nguide addresses the APIs to enable external offers. You should review the\n[program requirements](https://support.google.com/googleplay/android-developer/answer/14372887) and enroll in the external offers program before\nusing these APIs.\n\nGlossary of terms\n-----------------\n\nTerm conventions followed by this guide:\n\n- **External offers APIs**: APIs used to direct the user outside of the app, including surfacing required information screen and reporting applicable transactions.\n- **External transaction** : A qualifying transaction that occurs outside of the app as defined by the [program requirements](https://support.google.com/googleplay/android-developer/answer/14372887).\n- **External transaction token**: A token provided to the developer through the Play Billing Library for the developer to use when the user completes an external transaction. This token is used to notify Google Play of a successful purchase.\n- **External transaction ID**: A unique identifier generated by the developer to identify an external transaction.\n\nSupport external offers\n-----------------------\n\nThis section describes how to support external offers.\nBefore using these APIs, ensure the following:\n\n- Review the eligibility requirements for the relevant program and complete the onboarding steps outlined in the [program requirements](https://support.google.com/googleplay/android-developer/answer/14372887).\n- Integrate [Play Billing Library 6.2.1](/google/play/billing/release-notes) or higher.\n\n### Configure in Play Console\n\nTo configure external offers in Play Console, follow the steps outlined in\nthe [program requirements](https://support.google.com/googleplay/android-developer/answer/14372887).\n\n### Information screen for users\n\nThe information screen helps users understand that they are about to visit an\nexternal website. The information screen will be shown to users each time before\nthey are directed outside of the app using the external offers APIs. \n\n|--------------------|\n| Information screen |\n\nExample for illustrative purposes only.\n\n### Next steps\n\nTo begin integrating the external offers APIs, follow the in-depth guides\nfor both [in-app integration](/google/play/billing/external/integration) and [backend integration](/google/play/billing/outside-gpb-backend)."]]