Gerenciamento de assinaturas de usuários

Para implementar o gerenciamento de assinaturas no seu aplicativo, siga esta lógica:

1. Recupere a lista de assinaturas do usuário e exiba-as no aplicativo.
2. Implemente o gerenciamento de assinaturas — abra a conta do assinante ou gerencie assinaturas específicas diretamente pelo seu aplicativo.

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

Recupere as assinaturas do usuário

Para recuperar todas as assinaturas ativas do usuário atual, use o método XsollaSubscriptions.GetSubscriptions. O método vai retornar assinaturas com os status active, non_renewing e freeze vinculados à conta do usuário atual.

Você também pode solicitar informações detalhadas sobre cada assinatura usando o método XsollaSubscriptions.GetSubscriptionDetails.

Use os dados retornados (o objeto SubscriptionItem) para exibir a interface de gerenciamento de assinaturas no seu aplicativo.

Os principais campos para configurar widgets de interface:

• plan_name — nome da assinatura.
• status — estado atual da assinatura (new, active, canceled, non_renewing, freeze).
• date_next_charge — data e horário da próxima cobrança automática.
• charge — informações de pagamentos recorrentes. O objeto contém o preço (amount) e moeda (currency).

Gerenciamento de assinatura

Abertura da conta do assinante

A Xsolla fornece uma interface pré-pronta — a conta de assinante — através da qual os usuários podem visualizar informações sobre suas assinaturas e gerenciá-las. Essa é a maneira mais simples e recomendada de implementar o gerenciamento de assinaturas.

Recursos principais:

• a visão de detalhes da assinatura
• o gerenciamento da assinatura — cancelamento imediato, desativação de renovação automática ou reativação (dependendo das configurações do projet).
• a alteração do plano de assinaturas
• a atualização do método de pagamento

Para exibir a conta de assinante ao usuário, chame o método XsollaSubscriptions.GetUserAccountUrl. Quando a solicitação for bem-sucedida, um objeto UserAccountLink contendo um link à interface da conta será passado à função de retorno da chamada. Para abrir o link em um navegador externo ou a WebView construída, use o método XsollaWebBrowser.Open.

Gerenciamento de assinatura específica

Para abrir a interface de gerenciamento para uma assinatura específica do seu aplicativo, use o método XsollaSubscriptions.GetSubscriptionManagementUrl. Quando a solicitação for bem-sucedida, um objeto PaymentLink contendo um link à interface de gerenciamento de assinaturas 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.

Cancelamento de assinaturas

Para implementar o cancelamento de assinaturas na interface do seu aplicativo, use o método XsollaSubscriptions.CancelSubscription. O método desativa a renovação automática, e a assinatura transita ao status non_renewing. Isso significa que nenhuma cobrança automática será feita no próximo período de cobrança; a assinatura permanecerá ativa até o fim do período pago.

Renovação de assinatura

Para implementar a navegação à interface de renovação de assinaturas a partir do seu aplicativo, use o método XsollaSubscriptions.GetSubscriptionRenewalUrl. Quando a solicitação for bem-sucedida, um objeto PaymentLink contendo um link à interface de renovação de assinaturas 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.