Como Criar uma Loja Tebex para um Servidor FiveM

Para criar uma loja Tebex para FiveM, registre-a no Tebex, selecione a integração FiveM e copie o segredo gerado para a configuração do servidor sv_tebexSecret , reinicie o servidor e verifique a autenticação antes de adicionar pacotes. Use a página de configuração oficial atual enquanto trabalha; os rótulos do painel e as etapas de integração 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 a regra oficial de configuração e monetização do Tebex do Cfx.re.
• Confirme quem é o proprietário do servidor Cfx.re e da conta comercial do Tebex.
• Faça backup server.cfg e registre quem pode ler ou alterar 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

1. Visualize o pacote no desktop e no celular e verifique o texto de preço, renovação e entrega.
2. Execute uma compra controlada através do fluxo oficial de teste/criador disponível para a conta.
3. Confirme que apenas um direito é concedido à identidade pretendida.
4. Tente novamente a entrega e prove que ela não concede duas vezes.
5. Teste o servidor de jogo ou o banco de dados como indisponível e reconcilie o resultado posteriormente.
6. Teste o cancelamento/expiração e o caminho de reembolso aplicável.
7. 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ítica de pacotes, design de direitos e controles de ciclo de vida, use o completo Guia de monetização de servidor FiveM.