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
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.
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
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
- 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.
- 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.
- 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.
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.
