Docs
Guias do lojista

Ranks e upgrade

Escada de ranks em que o jogador sobe pagando só a diferença.

Marque a categoria como escalonada e ordene os ranks do menor para o maior (VIP, VIP+, MVP, MVP+). A loja passa a tratar a categoria como uma escada:

  • Quem já tem um rank vê os de cima com o preço do upgrade: o valor do novo menos o que já pagou.
  • O comprador só pode ter um rank por categoria. Ao subir, o anterior termina com o motivo UPGRADE e as ações de fim dele rodam (por exemplo, tirar o grupo antigo).
  • Se o upgrade for reembolsado ou perder uma disputa, o rank anterior volta.
  • Upgrade abaixo de R$ 1,00 não é cobrado: a loja mostra o motivo em vez de criar um Pix de centavos.

Dica: nos comandos, use a ação de fim do rank para remover o grupo, e a de compra para adicionar. Assim a troca no upgrade é automática.

Os eventos entitlement.ended (com endReason: "UPGRADE") e entitlement.created contam a troca para o seu sistema.