Como Criar uma Loja Tebex para um Servidor FiveM

Para criar uma loja Tebex para FiveM, cadastre a loja no Tebex, selecione a integração FiveM, copie a chave secreta gerada para a configuração sv_tebexSecret do servidor, reinicie o servidor e verifique a autenticação antes de adicionar pacotes. Consulte a página oficial atual de configuração durante o processo; os nomes no painel e as etapas iniciais podem mudar.

Não cole o segredo em um script do cliente, captura de tela, repositório público ou mensagem de suporte. Qualquer pessoa que o receba deve ser tratada como tendo acesso até que a chave seja substituída. Este guia cobre o processo de conexão e teste, não uma promessa de que todos os pacotes possíveis são permitidos.

Antes de conectar a loja

Revise as instruções oficiais da Cfx.re para configurar o Tebex e a regra de monetização.
Confirme quem é o proprietário do servidor Cfx.re e da conta comercial do Tebex.
Faça backup de server.cfg e registre quem pode ler ou alterar os segredos.
Defina um benefício de teste que possa ser concedido e removido com segurança.
Prepare um ambiente fora da produção ou uma janela controlada para os testes.

1. Crie a loja e escolha FiveM

Crie a conta através do processo oficial de integração de criadores do Tebex e adicione um servidor de jogos usando a integração FiveM. Use detalhes reais de negócios e suporte; não invente uma identidade de empresa nem oculte cobranças recorrentes. Mantenha a recuperação de conta e a autenticação multifator sob o controle do proprietário do negócio.

2. Adicione o segredo do servidor

Copie o segredo exibido para essa conexão de servidor de jogos e adicione a configuração documentada à configuração do lado do servidor:

sv_tebexSecret "REPLACE_WITH_THE_SECRET_FROM_TEBEX"

Não copie o placeholder literalmente. Mantenha a configuração fora de qualquer arquivo servido por um servidor web ou enviado para o Git. Reinicie o FXServer usando o mesmo processo controlado que você usa para outras alterações de configuração e, em seguida, inspecione o console do servidor para o resultado de autenticação da integração.

Se a autenticação falhar, compare a entrada do servidor e o segredo no Tebex, verifique se há erros de espaço em branco ou de aspas e substitua a chave se houver dúvida sobre sua confidencialidade. Não desative controles de segurança não relacionados para fazer a conexão funcionar.

3. Defina um pacote com precisão

Antes de adicionar muitos produtos, crie um pacote com nome exato, preço, frequência de cobrança, benefício, prazo de entrega, compatibilidade, validade e canal de suporte. Verifique as regras atuais da plataforma para esse benefício. Um rótulo vago de “VIP” não é suficiente para o comprador nem para o desenvolvedor que implementa a entrega.

4. Configure a entrega no lado do servidor

Use comandos suportados pelo recurso ou framework específico que você realmente executa. Não cole um comando genérico de outro servidor supondo que seus identificadores ou a ordem dos argumentos se apliquem. A entrega deve:

resolver a identidade correta do comprador/servidor;
executar apenas após um evento Tebex autenticado;
garantir a segurança quando a mesma entrega for retentada;
registrar a referência do pedido e o direito resultante;
suportar expiração ou reversão onde os termos do produto exigirem.

5. Teste antes de publicar

Visualize o pacote no desktop e no celular e verifique o texto de preço, renovação e entrega.
Execute uma compra controlada através do fluxo oficial de teste/criador disponível para a conta.
Confirme que apenas um direito é concedido à identidade pretendida.
Tente novamente a entrega e prove que ela não concede duas vezes.
Teste o servidor de jogo ou o banco de dados como indisponível e reconcilie o resultado posteriormente.
Teste o cancelamento/expiração e o caminho de reembolso aplicável.
Verifique se a equipe de suporte consegue encontrar o pedido sem solicitar senhas ou dados de cartão de pagamento.

6. Lance com responsabilidades operacionais definidas

Designe um responsável para entregas falhas, reembolsos, disputas, rotação de segredos e conciliação entre pedidos e direitos de acesso. Revise o acesso da equipe periodicamente. Um desconto ou um grande CTA não pode compensar um pacote que é pouco claro ou falha na entrega.

Para políticas de pacotes, definição de benefícios e controles do ciclo de vida, use o guia completo de monetização de servidores FiveM.