Guia de configuração da instância de pagamentos

Última atualização: 11/10/2026

Este guia mostra como configurar a sua instância de pagamentos sem depender do suporte: onde conseguir cada token e credencial, o que colar em cada campo e como testar antes de abrir as vendas. Tudo é feito em Minha conta → sua licença → aba Instância → Configuração. No painel, cada campo tem os links Onde pegar (abre o painel oficial do provedor) e Passo a passo (abre o trecho deste guia).

Tokens, chaves, segredos, senhas e a URL da instância são de responsabilidade exclusiva do cliente. A MMMods Store não se responsabiliza por vazamento, exposição ou uso indevido dessas credenciais, nem pelos prejuízos decorrentes, na máxima extensão permitida pela lei.

Ver seção 5 dos Termos de UsoAbrir Minha conta

1. Visão geral

A instância de pagamentos recebe as compras feitas dentro do seu servidor de DayZ (mod MM_ModPack) e conversa com o seu provedor de pagamento. O dinheiro cai direto na sua conta do Mercado Pago ou da Stripe: a MMMods Store não intermedeia nem guarda os valores.

O que você vai precisar

  • Licença ativa do produto de instância de pagamentos.
  • Para PIX: conta Mercado Pago com chave Pix cadastrada e credenciais de produção ativadas.
  • Para cartão e checkout internacional: conta Stripe ativada para receber pagamentos.
  • Para o painel CFTools in-game (opcional): servidor cadastrado no CFCloud com assinatura Basic ou superior.

Resumo do processo

  1. Abra Minha conta → sua licença → aba Instância → Configuração.
  2. Marque os métodos que vai usar: PIX, Stripe e/ou CFTools. Os campos de cada método aparecem ao marcar.
  3. Preencha os campos seguindo as seções abaixo.
  4. Clique em Salvar Configuração.
  5. Copie a URL do Endpoint e cole no campo de pagamentos do painel admin do mod.
  6. Faça uma compra de teste de valor baixo e confira o resultado na aba Dashboard.

2. Segurança e responsabilidade pelas credenciais

Tokens, chaves, segredos, senhas e a própria URL da instância dão acesso às suas contas e ao seu dinheiro. Trate todos como senha.

  • Pegue as credenciais somente nos painéis oficiais dos provedores (os links deste guia levam direto a eles).
  • Ninguém da equipe MMMods pede token, senha, segredo ou a URL da instância. Para suporte, informe apenas o ID da Instância.
  • Não envie credenciais nem prints que as mostrem em tickets, Discord, chat de suporte com IA, vídeos ou lives.
  • Ative a autenticação em dois fatores no Mercado Pago, na Stripe, na CFTools e no Discord.
  • Depois de salvos, os campos secretos aparecem como [configurado]. Para trocar, apague e digite o valor novo; para manter, não mexa no campo.
  • Suspeitou de vazamento? Gere a credencial de novo no painel do provedor, atualize aqui e, se foi a URL da instância que vazou, use Gerar nova URL.

Conforme a seção 5 dos Termos de Uso, as credenciais pertencem ao cliente e são de responsabilidade dele. A MMMods Store não se responsabiliza por vazamento, exposição ou uso indevido de tokens, chaves, senhas, URLs e demais credenciais, nem por cobranças, estornos, bloqueios ou outros prejuízos decorrentes, na máxima extensão permitida pela lei.

3. URL da instância (vai no mod)

No topo da aba Instância fica a URL do Endpoint. Ela já contém a chave de integração da sua instância e é a única coisa que o mod precisa:

  1. Clique em Copiar.
  2. No jogo, abra o painel admin do MM_ModPack e cole no campo da URL de pagamentos (MM_URLPaymentsAPI).
  3. Salve no mod e reinicie o servidor para ele carregar os métodos ativos.

A mesma URL serve para a loja (PIX/Stripe) e para o painel CFTools. Ela não muda quando você salva a configuração.

Gerar nova URL cria uma chave nova e invalida a anterior na hora: a loja e o painel CFTools do mod param até você colar a URL nova. Use só se a URL vazou.

Se o painel avisar que a instância ainda não tem chave, salve a configuração uma vez para gerar a URL.

4. Campos gerais

Nome da Aplicação

Opcional. Nome da sua loja ou servidor. Aparece na página de pagamento da Stripe junto com a quantidade de coins (ex.: Meu Servidor DayZ Coins 100).

Discord Webhook URL

Opcional. Envia para um canal do seu Discord o registro das ações administrativas feitas pelo painel CFTools in-game (expulsar, banir, fila prioritária, whitelist, RCon, Architect e outras).

  1. No Discord, abra Configurações do servidor → Integrações → Webhooks → Novo webhook.
  2. Escolha um canal privado da staff e clique em Copiar URL do webhook.
  3. Cole no campo. A URL começa com https://discord.com/api/webhooks/.

Não confunda com o webhook do PIX: o webhook do Discord não recebe avisos de pagamento. Quem tem essa URL consegue postar no canal, então guarde-a como segredo. Ajuda oficial do Discord

5. PIX (Mercado Pago)

Para vender por PIX você usa a sua própria conta Mercado Pago. Antes de começar:

  • tenha uma chave Pix cadastrada na conta Mercado Pago que vai receber;
  • crie uma aplicação em Suas integrações e ative as credenciais de produção.

Com o PIX marcado, Token MercadoPago e PIX Webhook Secret são obrigatórios: sem o segredo do webhook (mínimo de 32 caracteres) o painel não salva.

Token MercadoPago (Access Token)

  1. Acesse Suas integrações com a conta que vai receber os pagamentos.
  2. Abra a sua aplicação (ou crie uma em Criar aplicação).
  3. No menu lateral, abra Produção → Credenciais de produção. Se ainda não estiverem ativas, informe o ramo de atividade e o site e clique em Ativar credenciais de produção.
  4. Copie o Access Token (começa com APP_USR-) e cole no campo Token MercadoPago.

Use o Access Token de produção. Public Key, Client ID e Client Secret não são usados aqui. Documentação oficial

PIX Webhook Secret e PIX Webhook URL

O webhook avisa a sua instância assim que o PIX é pago, e a assinatura secreta garante que o aviso veio mesmo do Mercado Pago.

  1. Em Suas integrações, abra a mesma aplicação do Access Token.
  2. No menu lateral, clique em Webhooks → Configurar notificações.
  3. Em Modo de produção, informe a URL de webhook da sua instância: https://mmmods.store/payments-api/ID_DA_INSTANCIA/pix/webhook. Troque ID_DA_INSTANCIA pelo ID da Instância do painel. O painel mostra essa URL pronta, com botão Copiar.
  4. Em eventos, marque Pagamentos (payment).
  5. Clique em Salvar. O Mercado Pago gera a assinatura secreta: revele e copie.
  6. Cole a assinatura no campo PIX Webhook Secret.
  7. No campo PIX Webhook URL, clique em Usar esta URL (a mesma do passo 3) ou deixe vazio, já que ela está cadastrada no Mercado Pago.

Se você redefinir a assinatura no Mercado Pago, cole a nova aqui; caso contrário, os avisos de pagamento passam a ser recusados. Documentação oficial

Validação MX

Confere se o domínio do e-mail que o jogador registra no jogo existe e recebe mensagens, evitando cobranças com e-mail inválido. Deixe em Validar domínio de e-mail (MX).

6. Stripe (cartão e outros métodos)

A Stripe abre uma página de pagamento (Stripe Checkout) para o jogador. Com a Stripe marcada, Stripe Secret Key e Stripe Webhook Secret são obrigatórios.

Moeda: com o PIX também ligado, o mod cobra em BRL na Stripe; com só a Stripe ligada, em USD. Confira se a sua conta Stripe aceita a moeda usada.

Stripe Secret Key

  1. Abra Chaves de API no Dashboard da Stripe, com o modo de teste desligado.
  2. Na linha Chave secreta, revele e copie a chave (começa com sk_live_).
  3. Cole no campo Stripe Secret Key.

A chave publicável (pk_live_) não é usada aqui. Para testar antes de vender, use a chave sk_test_ com um webhook criado no modo de teste e troque as duas pelas de produção depois.

Stripe Webhook Secret

  1. Abra Webhooks no Workbench da Stripe e clique em Criar um destino de evento (ou Adicionar endpoint).
  2. Selecione Sua conta.
  3. No formato da carga útil, escolha Snapshot (não use Thin).
  4. Selecione os eventos:
    • checkout.session.completed
    • checkout.session.expired
    • checkout.session.async_payment_succeeded
    • checkout.session.async_payment_failed
  5. Escolha Endpoint de webhook e informe a URL: https://mmmods.store/payments-api/ID_DA_INSTANCIA/stripe/webhook. O painel da instância mostra essa URL pronta, com botão Copiar.
  6. Na página do endpoint criado, revele o Segredo de assinatura (começa com whsec_) e cole em Stripe Webhook Secret.

O segredo do modo de teste e o de produção são diferentes: use o do mesmo modo da sua chave secreta. Documentação oficial

Stripe Success URL e Stripe Cancel URL

Opcionais. Para onde o jogador vai depois de pagar ou cancelar no checkout. Vazios, ele vê uma página simples avisando que pode fechar a aba. Se preencher, use endereços completos com https:// (ex.: o site ou o Discord do seu servidor).

7. CFTools (painel in-game)

Liga o painel CFTools dentro do jogo: jogadores online, banimentos, fila prioritária, whitelist, ranking, GameLabs e, opcionalmente, o Architect. Usa a mesma URL da instância.

Requisito: o servidor precisa estar no CFCloud com assinatura Basic ou superior. No plano Free a CFTools bloqueia a API de servidor (o teste avisa plano Free), e nenhuma configuração aqui resolve isso.

CFTools Application ID e Application Secret

  1. Acesse developer.cftools.cloud/applications com a sua conta CFTools.
  2. Crie uma aplicação (ou abra uma existente).
  3. Copie o Application ID e o Secret para os campos CFTools Application ID e CFTools Application Secret.

Esses dois campos são obrigatórios para ligar o CFTools. Documentação da Data API

Conceder acesso (grant) ao servidor e à ban list

A aplicação só enxerga o que você autorizar.

  1. Com o Application ID preenchido, o painel mostra o link Conceder acesso na CFTools (formato https://app.cftools.cloud/authorize/SEU_APPLICATION_ID).
  2. Abra o link logado no CFCloud, selecione o servidor e a ban list e confirme.
  3. Volte ao painel, salve e clique em Testar conexão CFTools. Os grants podem levar alguns minutos para aparecer.

Esse link não é uma chave: não cole em nenhum campo.

Server API ID

Pode ficar vazio quando a aplicação tem grant de um único servidor: ele é descoberto sozinho. Para preencher:

  • Mais fácil: depois do teste, clique em Usar este servidor na lista de grants e salve.
  • Manual: no CFCloud, abra o servidor → Settings → API Key e copie o Server ID (formato UUID, com hífens).

Não use o código da barra de endereço do navegador nem a "API Key" dessa tela: essa chave é do plugin do jogo e não é usada aqui.

Ban list ID

Pode ficar vazio quando há grant de uma única ban list. Para preencher, clique em Usar esta ban list depois do teste ou copie o ID da ban list no Ban manager.

Enterprise token e GDS API key

Deixe vazios, a não ser que a CFTools tenha fornecido esses dados para a sua conta. O Enterprise token é só para contas Enterprise. A GDS API key é a chave do Gameserver Data Service e acrescenta estatísticas na visão geral do servidor. O link de grant (app.cftools.cloud/authorize/...) não é chave GDS.

Ações bloqueadas

Opcional. Lista, separada por vírgula, das ações que o painel in-game não pode executar, nem para admins. Aceita a ação exata ou um grupo terminado em .*.

Exemplos: server.rcon,bans.add · arch.* (desliga todo o Architect) · gl.action,vip.sync.

Grupos: server.* (servidor, mensagens, RCon, ranking), players.* e player.* (jogadores), bans.* (banimentos), qp.* (fila prioritária), wl.* (whitelist), gl.* (GameLabs), vip.* (sincronização VIP) e arch.* (Architect).

Testar a conexão

  1. Salve a configuração: o teste usa os dados já salvos.
  2. Clique em Testar conexão CFTools.
  3. Confira as capacidades (Data API, Ban list, GameLabs, Architect, GDS) e a lista de grants. Se algo falhar, a mensagem diz o motivo; veja Problemas comuns.

Em Ver últimas chamadas você acompanha o que o painel in-game executou.

8. Architect (opcional)

Permite ligar, parar, reiniciar, fazer backup e ver o console do servidor pelo painel in-game, usando o agente do CFTools Architect instalado na máquina do servidor. Se não usa o Architect, deixe todos os campos vazios. Com a URL preenchida, usuário, senha e Server ID passam a ser obrigatórios.

URL do agente

Endereço público do agente no formato https://host:porta (a porta padrão do agente é 8090), sem nada depois da porta. Ex.: https://meuservidor.com:8090. O endereço precisa ser acessível pela internet: IPs de rede local (192.168.x.x, 10.x.x.x), localhost e similares são recusados. Libere a porta no firewall da máquina.

Usuário e senha do agente

Crie um usuário só para o site no Architect Manager (Add new User); a senha inicial aparece na tela ao criar. Veja a documentação de usuários do Architect.

Um usuário próprio pode ser removido a qualquer momento sem afetar os outros acessos. O agente tem acesso amplo à máquina do servidor: trate esse usuário como acesso de administrador, use senha forte e exclusiva e bloqueie em Ações bloqueadas o que não for usar.

Server ID no agente

O identificador que você deu ao servidor ao criá-lo no Architect Manager (ex.: Servidor-1). Não é o Server API ID da CFTools.

Impressão digital TLS (opcional)

  • Agente atrás de um domínio com certificado válido (ex.: Let's Encrypt): deixe vazio.
  • Agente com certificado autoassinado (padrão da instalação): salve sem a impressão digital e rode o teste. A mensagem de erro mostra o SHA-256 do certificado. Confirme que é o do seu agente, cole aqui (aceita AA:BB:... ou hex corrido), salve e teste de novo.

Se o certificado do agente mudar, atualize este campo.

9. Ativar e testar

  1. Salve a configuração. Se faltar algo obrigatório, o painel mostra o motivo e não salva.
  2. Confirme que a URL do Endpoint está colada no mod.
  3. Reinicie o servidor para o mod carregar os métodos ativos.
  4. No jogo, registre um e-mail e faça uma compra de teste de valor baixo.
  5. Acompanhe a transação na aba Dashboard da instância e confira o pagamento no painel do Mercado Pago ou da Stripe.
  6. Para o CFTools, abra o painel in-game: o cabeçalho deve mostrar Conectado.

10. Problemas comuns

Mensagem ou sintoma O que fazer
Ao salvar: "PIX_WEBHOOK_SECRET deve ter pelo menos 32 caracteres" Cole a assinatura secreta do webhook do Mercado Pago no campo PIX Webhook Secret (passo a passo).
Ao salvar: "STRIPE_WEBHOOK_SECRET deve ter pelo menos 32 caracteres" Cole o segredo whsec_ do endpoint de webhook da Stripe (passo a passo).
Ao salvar: "Preencha Application ID e Secret da CFTools" Preencha os dois campos ou desmarque o CFTools.
Ao salvar: "GDS API key inválida: isso é um link" Você colou o link de grant no campo GDS. Apague o campo e abra o link no navegador.
Ao salvar: erro na URL do agente Architect Use https://host:porta, sem caminho, ? ou usuário/senha na URL.
Compras no jogo pararam depois de Gerar nova URL Cole a URL nova no mod e reinicie o servidor.
"MERCADO_PAGO_ACCESS_TOKEN nao configurado" Preencha o Token MercadoPago e salve.
PIX pago, mas a confirmação demora O mod consulta o status sozinho a cada poucos segundos. Confira se o webhook está cadastrado no Mercado Pago e se a assinatura secreta é a atual.
Jogador não consegue registrar o e-mail O domínio do e-mail não recebe mensagens. Peça outro e-mail.
Stripe mostra entregas de webhook com erro 400 Segredo errado ou de outro modo (teste × produção), ou formato Thin. Use o whsec_ do endpoint certo e o formato Snapshot.
Teste CFTools: credenciais recusadas Confira Application ID e Secret e espere 1 minuto antes de testar de novo.
Teste CFTools: nenhum grant / sem grant Abra o link Conceder acesso na CFTools e conceda o servidor e a ban list.
Teste CFTools: plano Free Assine Basic ou superior para o servidor no CFCloud.
Teste CFTools: Server API ID ausente ou ambíguo Há mais de um servidor concedido: clique em Usar este servidor e salve.
Architect: endereço não permitido A URL aponta para rede local. Use um endereço público.
Architect: inacessível ou erro de certificado Porta fechada, agente desligado ou certificado autoassinado sem impressão digital (passo a passo).
"Instância ainda não provisionada" Aguarde alguns minutos após a compra. Se continuar, abra um ticket.

Precisa de ajuda? Abra um ticket pelos canais oficiais informando só o ID da Instância e a mensagem de erro. Nunca envie tokens, senhas, segredos ou a URL da instância.

← Voltar para a loja