Comece agora
Fluxo de integração
Para integrar Subscriptions:
- Crie um projeto para o seu jogo.
- Configure planos de assinatura.
- Configure a autorização.
- Crie interface de catálogo.
- Configure a abertura da interface de pagamento.
- Implemente a obtenção de informações de assinatura.
- 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
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 assinatura
Silver : $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
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
- 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 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.
Período de repetição
- 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.
Pagamento automático
Pagamento único
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.
- 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.
- 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.
Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.