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.
Seu progresso
Obrigado pelo seu feedback!
Última atualização: 26 de Janeiro 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!