Loja VIP
Integração com loja de venda de VIP (CentralCart) para cruzar gastos dos jogadores com as métricas
Loja VIP
Conecte a API da sua loja de VIP para cruzar quanto cada jogador gastou com as métricas do servidor. Hoje suportamos CentralCart (mais lojas, como Hydrus, em breve).
Com a loja conectada, aparecem:
- Na página de Economia do jogador — um bloco Loja VIP com o total gasto, gráfico de gasto acumulado e os últimos pedidos.
- Na página de um grupo (facção) — um card Gasto na loja VIP com a somatória de todos os membros e quantos compraram.
A integração é somente leitura e fica inteiramente no painel — não exige nada no resource Lua nem no servidor de jogo.
Como o jogador é casado com o pedido
O FiveTrack soma os pedidos cujo client_identifier (identificador do cliente no pedido) é igual ao passaporte do jogador. Apenas pedidos com status APPROVED (pagos) entram na conta.
Isso depende de a sua loja entregar o VIP usando o passaporte / ID do vRP como identificador. Se a sua loja usa license, steam ou discord, o total vai aparecer zerado — fale com a equipe FiveTrack para ajustar o mapeamento.
Configuração
Pegue o token da API na sua loja
No painel da CentralCart: Dashboard → Desenvolvedor → API. Copie o token.
Conecte no painel FiveTrack
Configurações → Servidores → editar servidor → Integração · Lojas de VIP → cole o token da CentralCart no campo CentralCart → Salvar.
Veja os gastos
- Abra a Economia de um jogador → bloco Loja VIP.
- Abra um grupo em Legal & Ilegal → card Gasto na loja VIP.
Detalhes técnicos
- O token é guardado criptografado (AES-256-GCM) e nunca volta para o navegador.
- O total do jogador filtra os pedidos pelo passaporte (
q=<passaporte>) e somaprice. - O total do grupo faz uma leitura paginada de todos os pedidos aprovados da loja, monta um mapa
identificador → soma(cache de 10 min) e soma os passaportes dos membros — evitando uma chamada por membro. - Resultados são cacheados por alguns minutos para não sobrecarregar a API da loja.
Os valores são exibidos na moeda informada pela loja (padrão BRL).