Skip to main content
Quando alguém compra um item, VIP ou pacote de dinheiro na sua loja, alguma coisa precisa acontecer dentro do servidor — dar o item, aplicar o VIP, rodar um comando. A loja.gg resolve isso com um resource oficial pronto: você instala, configura um token pelo painel e a entrega roda sozinha.
Não há uma API externa de gerenciamento de loja para integrações próprias — quem quiser automatizar a entrega usa o resource oficial abaixo. A única API pública da loja.gg é a storefront headless, para quem quer montar a própria vitrine.

​
O resource oficial: lojagg_script

É um resource FiveM/RedM (suporta gta5 e rdr3) publicado pela loja.gg. Ele se registra no servidor, manda heartbeat e fica ouvindo comandos para executar — sem você escrever nenhuma lógica de entrega.
1

Gere um token de servidor no painel

Em Loja → Integrações → FiveM/RedM, gere um token para o seu servidor. Ele identifica qual loja e qual servidor estão conectados.
2

Instale o resource

Baixe o resource lojagg_script e coloque na pasta resources/ do seu servidor.
3

Configure o token

Defina o convar antes de iniciar o resource, no server.cfg:
4

Mapeie produtos para comandos

No painel, associe cada produto a um comando de console do seu servidor — por exemplo, give {player_id} vip 30 ou um comando exportado pelo seu framework (ESX/QBCore/vRP). Use os placeholders {player_id} e {player_name} quando o seu comando aceitar.
O fxmanifest.lua do resource declara suporte a games { 'gta5', 'rdr3' } — o mesmo resource funciona em servidores FiveM e RedM.

​
Como funciona por baixo

O resource conversa com o backend da loja.gg em três passos, de forma automática — nada disso é uma API que você chama, é o próprio resource fazendo a integração:
O comando executado no servidor é exatamente o que foi configurado no painel para aquele produto. Teste o comando manualmente no console do seu servidor antes de vincular ao produto — se o comando falhar silenciosamente (ex.: sintaxe errada do framework), a entrega será marcada como erro, mas o jogador não recebe nada.

​
Apenas um servidor por token

Se você tentar iniciar o mesmo token em dois servidores ao mesmo tempo, o segundo registro é recusado — evita que uma mesma fila de comandos seja disputada por dois processos.

​
Token vazado?

Revogue e gere um novo token em Loja → Integrações → FiveM/RedM e atualize o server.cfg. Assim como qualquer credencial de servidor, o token nunca deve ir para o client_script nem aparecer em logs públicos.