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.

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

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

Para alterar, excluir ou obter uma lista de todos os produtos, use as chamadas de API correspondentes:

• Atualizar Produto
• Excluir Produto

• Obter Produtos

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.

Última atualização: 22 de Janeiro de 2024