Gateways de pagamento

Sandbox e Produção

Teste a loja inteira com as credenciais de teste do gateway antes de vender de verdade.

Cada conexão de gateway é feita em um ambiente. O ambiente define se o dinheiro é real e se o pedido conta para a sua fatura da MinePag.

SandboxProdução
CredenciaisDe teste do gatewayReais
DinheiroNenhuma cobrança é realVendas reais
Quem pode pagarSó a equipe da loja: membros logados no painel, na vitrine, ou chamadas com a chave secreta, na APIQualquer cliente
Pedido no painelMarcado com o selo SandboxSem selo
Conta para a fatura da MinePagNãoSim, quando aprovado
Entregas e e-mailsFuncionam normalmenteFuncionam normalmente

Entregas de teste são reais

Um pedido Sandbox aprovado libera os benefícios de verdade: executa os comandos no servidor Minecraft, dá o cargo no Discord, envia o e-mail ao cliente. Teste com o seu próprio nick, conta e e-mail.

Nome de cada ambiente nos gateways

GatewaySandbox na MinePag corresponde aComo reconhecer as credenciais
EfíHomologaçãoCredenciais e certificado gerados para Homologação
Mercado PagoCredenciais de testeAccess Token e Public Key começando com TEST-
PagBankSandbox (Portal do Desenvolvedor)Token do ambiente de testes
StripeModo de testeChaves rk_test_… e pk_test_…

Testar antes de vender

Conecte o gateway em Sandbox

Em Configurações › Gateways, clique em Conectar, escolha Sandbox e use as credenciais de teste. Siga o guia do seu gateway: Efí, Mercado Pago, PagBank ou Stripe.

Confira as rotas

Na seção Checkout, a coluna Equipe testando · Sandbox já usa a conexão nova nas formas que ela aceita. As rotas de Clientes · Produção não mudam: testar nunca tira uma forma de pagamento dos clientes.

Faça uma compra de teste

Entre no painel com a sua conta e, no mesmo navegador, abra a vitrine. Compre um produto, escolha Sandbox em Pagar em e pague com os dados de teste do gateway (cartão de teste, Pix simulado ou boleto de teste, conforme o gateway permite). Só a equipe da loja vê essa escolha; os clientes pagam sempre em Produção.

Confira o resultado

  • Em Vendas › Pedidos, o pedido aparece com o selo Sandbox e muda para Pago quando o gateway confirma.
  • Em Entregas, os benefícios aparecem como Entregue.
  • Na página da conexão, Últimos avisos recebidos mostra os avisos do gateway como Processado.

Conecte Produção

Em Conectados, clique em Conectar Produção ao lado da conexão Sandbox e use as credenciais reais. As formas que ainda não tinham gateway de Produção passam a usá-lo, e a seção Checkout mostra o que os clientes conseguem pagar.

Sem gateway de Produção, os clientes não pagam

Clientes nunca pagam em Sandbox. Enquanto uma forma não tiver gateway de Produção, ela não aparece para eles. A seção Checkout avisa quando os clientes não veem nenhuma forma de pagamento.

Os dois ambientes ao mesmo tempo

Cada gateway aceita uma conexão Sandbox e uma de Produção na mesma loja. Você pode manter a de Sandbox conectada para testes futuros: ela só cobra se estiver em uma rota.

Se o gateway já tem os dois ambientes conectados, o atalho Conectar Produção (ou Conectar Sandbox) some da conexão e o gateway sai de Conectar outro gateway. Para trocar uma conta, use Atualizar credenciais na conexão existente ou desconecte antes de conectar de novo.

Pedidos Sandbox e a fatura

Pedidos Sandbox nunca contam para a fatura da MinePag, mesmo quando aprovados. Veja os preços e franquias.

Nesta página