Compra de assinatura

Para implementar a compra de assinaturas no seu aplicativo, siga esta lógica:

  1. Recupere a lista de planos de assinatura disponíveis para compra e exiba-os ao usuário.
  2. Inicie a compra do plano selecionado pelo usuário.

Para uma implementação simplificada, consulte a amostra.

Observação

A compra e gerenciamento de assinaturas só está disponível para usuários autenticados. Para mais informações sobre como usar o SDK para a autenticação de usuários, consulte a seção Autenticação.

As amostras de código usam a autenticação de senha via nome de usuário e senha (o método XsollaAuth.SignIn) com credenciais codificadas para simplificar a demonstração do fluxo de trabalho da assinatura. Em um aplicativo real, você precisa implementar a lógica de autenticação completa e a validação usando o método XsollaAuth.AuthBySavedToken.

Recupere uma lista de planos de assinatura

Para recuperar a lista de planos configurados na Conta de Distribuidor, chame o método XsollaSubscriptions.GetSubscriptionPublicPlans ou XsollaSubscriptions.GetSubscriptionPlans. Use os dados retornados (o objeto PlanItem) para exibir o catálogo de assinaturas no seu aplicativo.

Os principais campos para configurar widgets de interface:

  • plan_name — nome da assinatura.
  • plan_description — descrição dos benefícios do plano.
  • charge — objeto contendo o preço (amount) e moeda (currency).
  • period — período de cobrança.

Inicie a compra da assinatura

Para iniciar a compra de um plano de assinatura selecionado pelo usuário, chame o método XsollaSubscriptions.GetSubscriptionPurchaseUrl, passando o parâmetro planExternalId. Após uma solicitação bem-sucedida, um objeto PaymentLink contendo um link à interface de gerenciamento de assinatura será passado à função de retorno de chamada. Para abrir o link em um navegador externo ou um WebView integrado, use o método XsollaWebBrowser.Open.

Aviso

Para rastrear o status do pedido, você deve configurar o gerenciamento do webhook e receber as informações do pedido no lado do servidor do seu aplicativo. Isso permitirá que você implemente validações adicionais das compras concluídas.

Consulte a seção Obter informações de assinatura para obter informações mais detalhadas sobre como configurar e testar webhooks.

Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Última atualização: 14 de Abril de 2026

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!
Não conseguimos enviar seu feedback
Tente novamente mais tarde ou contate-nos via doc_feedback@xsolla.com.