Comece agora

Fluxo de integração

Para integrar Subscriptions:

  1. Crie um projeto para o seu jogo.
  2. Configure planos de assinatura.
  3. Configure a autorização.
  4. Crie interface de catálogo.
  5. Configure a abertura da interface de pagamento.
  6. Implemente a obtenção de informações de assinatura.
  7. Assine o contrato de licenciamento.

Como funciona

Compra de assinaturas

Renovação automática de assinaturas recorrentes

Fluxo do usuário

Glossário

Plano de assinatura
Condições de faturamento (valor de cobrança, moeda e frequência) em termos das quais um usuário obtém seu acesso ao serviço. A configuração de um plano é uma etapa de integração necessária.
Produto baseado em assinatura

Um serviço ou um conjunto de serviços fornecidos a um usuário quando ele compra a assinatura. A chamada de API Criar Produto é usada para criar um produto. A criação de produtos é necessária se você configurar a venda de assinaturas separadas para serviços diferentes ou se quiser dar a um usuário a capacidade de obter várias assinaturas ao mesmo tempo. Um produto baseado em assinatura pode ser o acesso a ao canal de um streamer, jogo ou item exclusivo/habilidade exclusiva. Você pode ler mais sobre como configurar e usar os produtos baseados em assinatura nestas instruções.

Assinatura

Uma combinação do produto e do plano escolhido. Uma assinatura é criada quando um usuário seleciona um plano de assinatura e obtém acesso a um serviço. O número de assinaturas que um usuário pode obter ao mesmo tempo depende do número de produtos no projeto. As condições de assinatura (período de cobrança, custo e outros) correspondem às condições do plano selecionado. As condições da assinatura existente não serão alteradas se as condições do plano forem alteradas após a criação da assinatura.

EXEMPLO 1

Produto: Acesso ao jogo

  • Plano de assinaturaSilver: $10 por 1 mês
  • Plano de assinatura Gold: $100 por 1 ano

Um usuário pode selecionar uma das seguintes assinaturas:

  • Assinatura 1: Acesso ao jogo com o plano de $10/mês
  • Assinatura 2: Acesso ao jogo com o plano de $100/ano

EXEMPLO 2

Produto 1: Acesso ao jogo1

Produto 2: Acesso ao jogo2

  • Plano de assinatura: $10 por 1 mês

Um usuário pode obter duas assinaturas simultaneamente:

  • Assinatura 1: Acesso ao jogo1 com o plano de $10/mês
  • Assinatura 2: Acesso ao jogo2 com o plano de $10/mês
Observação
Se o produto baseado em assinatura não estiver configurado, o usuário poderá obter apenas uma assinatura por vez. Para obter várias assinaturas simultaneamente, você precisa configurar produtos.
Grupo de planos

Um conjunto de planos que têm o mesmo valor de parâmetro group_id. Para criar ou modificar um grupo, passe o parâmetro group_id para as chamadas de API:

Criar um grupo de planos é necessário se você quiser:

  • criar um produto baseado em assinatura

  • limitar o número de planos que você pode escolher para assinar um produto

  • permitir que o usuário mude para outro plano dentro do grupo

você pode ler mais sobre como configurar e usar grupos nestas instruções

Período de avaliação
O período em que o usuário pode experimentar a assinatura sem pagar por ela. Recursos:
  • Quando uma assinatura com um período de avaliação é comprada, uma conta de cobrança é criada e um pagamento de autorização é feito. Há um pequeno valor cobrado da conta do usuário e, em seguida, reembolsado. Quando o pagamento é cobrado, um webhook de pagamento não é enviado para o URL do webhook.
  • Após o término do período de avaliação, o custo total do plano de assinatura é cobrado e os webhooks Payment e Updated Subscription são enviados para o URL do webhook. Se o pagamento da assinatura não for bem-sucedido, o webhook Canceled Subscription será enviado. O período de avaliação não está incluído no período de validade do plano e sua duração é calculada separadamente.
  • Um período de avaliação pode ser adicionado como bônus a uma promoção.
Período de carência
Um período de pagamento adiado. Durante esse período, os usuários que não pagaram pela assinatura a tempo podem continuar usando os serviços. Características:
  • Um período de carência só está disponível para as assinaturas do plano regular e o pagamento único. As assinaturas com o tipo de renovação automática de pagamento são cobradas automaticamente.
  • A Xsolla notifica o usuário da necessidade de se fazer um pagamento no momento que o período de carência é ativado e a cada dia subsequente do período de carência.
  • Se o usuário pagar por uma assinatura durante o período de carência, o pagamento é feito pelo período de pagamento completo.
  • A quantidade de dias que o usuário terá acesso ao serviço do parceiro sem realizar um pagamento é subtraída do número total de dias no período de assinatura.
  • Se o valor no campo Grace period nas configurações do plano for 0, o plano não tem período de carência.
Você pode ler mais sobre a configuração de um período de carência nestas instruções.
Período de repetição
Um período quando as tentativas de cobrar a conta de pagamento salva são feitas. Nesse período, os usuários podem continuar usando os serviços de assinatura. É ativado após uma cobrança mal-sucedida. Características:
  • O período de tentativa só está disponível para as assinaturas plano regular e pagamento automático.
  • As tentativas de cobrança são feitas a partir de uma conta de pagamento salva uma vez por dia.
  • O sistema tentará cobrar até que a assinatura seja renovada, cancelada por um usuário ou cancelada após exceder a quantidade de tentativas de cobrança.
  • Se um usuário renovar a assinatura antes do fim do período de tentativas, a quantidade de dias nas quais o usuário teve acesso ao serviço do parceiro sem realizar um pagamento serão subtraídas do número total de dias do período de assinatura.
  • Se o valor no campo Number of billing retires nas configurações do plano for 0, o plano não possui período de tentativas.
Você pode ler mais sobre a configuração de um período de tentativas nestas instruções.
Pagamento automático
Um tipo de renovação de assinatura que cobra automaticamente sua conta de cobrança salva. Nenhuma ação do usuário é necessária. Se a conta de cobrança não tiver sido salva, uma assinatura com um tipo de pagamento automático alternará para o status Non renewing.
Pagamento único
Um tipo de renovação de assinatura quando as cobranças são feitas pelo usuário com o link de pagamento recebido por e-mail. Utilizado se o usuário selecionar uma forma de pagamento que não oferece suporte a pagamentos automáticos.

Status de assinatura

Uma assinatura pode ter um dos seguintes status:

  • Active. Status primário. A assinatura é criada e ativada após o primeiro pagamento bem-sucedido. Cobranças adicionais só são possíveis para assinaturas ativas.

Aviso
Você não pode criar uma assinatura manualmente usando a API — isso só pode ser feito automaticamente ao fazer uma compra.
  • Canceled. A assinatura foi cancelada com efeito imediato devido a um dos seguintes motivos:
    • Status alterado via método de API ou Xsolla Conta de Distribuidor.
    • Cancelado pelo usuário.
    • Expirado, se uma data de expiração foi definida nos parâmetros.
    • O número máximo de tentativas de carregamento excedido. São três por padrão; entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com para alterá-lo.
    • Usuário não encontrado no jogo.
    • Conta de usuário excluída.
Observação
Quando uma assinatura é cancelada, o último pagamento pode ser reembolsado. Essa opção está disponível tanto para o parceiro quanto para o usuário.
  • Non renewing. Renovação da assinatura cancelada. A assinatura durará até que o ciclo de cobrança atual termine antes que o status mude para Canceled. Uma renovação pode ser cancelada devido a um dos seguintes motivos:
    • Status alterado via método de API ou Conta de Distribuidor.
    • Cancelado pelo usuário via link de e-mail.
    • Conta de usuário excluída.
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: 31 de Julho de 2024

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!