Como configurar produtos baseados em assinatura e grupos de planos

Produto baseado em assinatura é um serviço ou um conjunto de serviços fornecidos a um usuário quando ele compra a assinatura. 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 exemplo de um produto baseado em assinatura seria o acesso ao canal do streamer, ao jogo ou a um item/habilidade exclusivo.

Observação
Se você quiser vender acesso a jogos com apenas uma opção de assinatura, precisará configurar um plano de assinatura, mas não precisará configurar o produto.
Um grupo de planos é um conjunto de planos que têm o mesmo valor de parâmetro group_id. O parâmetro group_id é usado para formar um grupo de planos e associar esse grupo a produtos baseados em assinatura. A criação de um grupo de planos permite:
  • 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
Observação
Por padrão, os planos são criados com o parâmetro “group_id”:null e incluídos no grupo geral. Você pode optar por não criar grupos se nenhum produto for criado em seu projeto.
Grupos, planos e produtos interagem entre si de acordo com as seguintes regras:
  • Um plano pode pertencer apenas a um grupo.
  • Um produto pode ser criado com base em apenas um grupo.
  • Um grupo pode ser vinculado a vários produtos.

Para criar um grupo de produtos e planos baseado em assinatura, passe os seguintes parâmetros para a chamada de API Criar Produto:

  • name com o nome do produto
  • group_id com o nome do grupo de planos
Observação
Você também pode criar um grupo passando o parâmetro group_id para as chamadas de API Criar Plano ou Atualizar Plano e, em seguida, criar um produto usando o valor existente group_id.
Para alterar, excluir ou obter uma lista de todos os produtos, use as chamadas de API correspondentes:

Para vincular um plano a um grupo de planos e a um produto, passe o parâmetro group_id com o nome do grupo de planos para a chamada de API Atualizar Plano. Para remover um grupo, passe “group_id”:null.

Para abrir a interface de pagamento ao comprar um plano vinculado a um produto, passe os seguintes parâmetros para a chamada de API Criar token:

  • purchase.subscription.plan_id com ID do plano
  • purchase.subscription.product_id com o ID do produto associado ao plano via group_id

Exemplos
  • Se você quiser vender acesso a jogos com apenas uma opção de assinatura, precisará configurar um plano de assinatura, mas não precisará configurar o produto.
  • Se você quiser vender o acesso ao jogo por diferentes termos, por exemplo, por 1 e 3 meses, você precisa configurar 2 planos de assinatura com as condições apropriadas. Você também não precisa configurar o produto. Os planos terão o parâmetro “group_id”:null por padrão, ou seja, estarão no grupo geral. O usuário poderá escolher qualquer um deles ao adquirir uma assinatura, bem como mudar de um plano para outro.
  • Você quer vender não apenas o acesso ao jogo por 1 e 3 meses, mas também uma assinatura adicional, por exemplo, uma melhoria de espada por 6 meses. Nesse caso:
    1. Crie 2 produtos “jogo” e “espada” passando os parâmetros exclusivos name e group_id para cada produto para a chamada de API Criar Produto.
    2. Crie planos para 1, 3 e 6 meses de uma das seguintes maneiras:
      • Configure os planos em sua Conta de Distribuidor e use a chamada da API Atualizar Plano para passar o parâmetro de produto group_id “jogo” para os planos de assinatura para vender o jogo e o parâmetro de produto group_id “espada” para os planos de assinatura para vender a espada.
      • Use a chamada de API Criar Plano, onde você passa os dados sobre os planos, bem como o parâmetro do produto group_id “jogo” para os planos de assinatura para vender o jogo e o parâmetro do produto group_id “espada” para os planos de assinatura para vender a espada.
    3. Implemente a exibição de produtos de “assinatura de jogo” e “assinatura de atualização de espada” na interface da loja.
Observação
Ao implementar a interface, observe que o objeto de venda não é a assinatura em si, mas o produto criado no projeto, já que a assinatura é uma combinação do produto e do plano selecionado resultante da compra.
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!