Problemas comuns
O que fazer quando o gateway não conecta, o pedido não confirma ou a forma de pagamento some do checkout.
Antes de tudo, abra Configurações › Gateways, clique na conexão e use Testar conexão. A MinePag confere as credenciais guardadas com o gateway e atualiza o estado da conexão. O resultado aparece como "Conexão funcionando" ou "O gateway recusou a conexão", com o motivo.
O gateway não conecta
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| "Esta loja já tem … conectado nesse ambiente." | Cada gateway aceita uma conexão por ambiente na loja. | Use Atualizar credenciais na conexão existente ou desconecte-a antes. |
| Mensagem de ambiente trocado (chave de teste em Produção ou o contrário) | As credenciais são de outro ambiente. | Veja a tabela de Sandbox e Produção. |
| Mensagem de permissão ou escopo faltando | A aplicação ou a chave não tem as permissões que a MinePag usa. | Efí: escopos. Stripe: permissões. Mercado Pago: use credenciais de produção da aplicação. |
| "Não foi possível validar as credenciais agora. Tente novamente." | O gateway não respondeu. | Tente de novo em alguns minutos. |
| Aviso de que a loja está com restrições por pendência de faturamento | A conta de faturamento está Restrita: conectar gateways, trocar credenciais e alterar rotas ficam bloqueados. | Pague a fatura em aberto. Veja Fatura vencida. |
| O botão Conectar não aparece | Os dois ambientes já estão conectados, ou você não é Proprietário nem Administrador. | Gerencie as conexões existentes ou peça a um administrador da loja. |
O pedido não muda para Pago
Confira o pagamento no gateway. Veja no painel do gateway se o pagamento foi mesmo aprovado. Pix e boleto só confirmam depois que o cliente paga.
Consulte o gateway pelo pedido. Abra o pedido em Vendas › Pedidos e clique em Consultar gateway na seção Pagamentos. Se o gateway já aprovou, o pedido vira Pago na hora.
Confira o webhook. Na página da conexão, veja a seção Avisos de pagamento (webhook). Se a conexão aparecer como Webhook pendente ou não houver nenhum aviso recente, siga Webhooks dos gateways.
Sem webhook, a MinePag ainda confirma os pagamentos sozinha, por consulta periódica, com alguns minutos de atraso.
Mercado Pago com credenciais
A causa mais comum é a assinatura secreta não salva. Confira se a página da conexão tem a URL cadastrada na aplicação do Mercado Pago, com os eventos Order (Mercado Pago), Pagamentos e Contestações, e se a assinatura secreta foi colada em Assinatura secreta. Veja Mercado Pago.
Avisos com assinatura inválida
Se Últimos avisos recebidos mostra Assinatura inválida:
- Mercado Pago: a assinatura secreta colada não é a atual. Copie de novo na aplicação e salve.
- Stripe: o endpoint "MinePag" foi editado ou recriado fora da MinePag. Crie uma chave restrita nova e use Atualizar credenciais para a MinePag recriar o endpoint.
- Efí: o webhook da chave Pix foi trocado por outro sistema. Desconecte e conecte de novo.
Uma forma de pagamento sumiu do checkout
| Causa | Como confirmar | O que fazer |
|---|---|---|
| A forma não tem gateway de Produção | Na seção Checkout, a coluna Clientes · Produção mostra Desativado, ou a forma só tem gateway no Sandbox. | Escolha um gateway de Produção ou conecte um. |
| A conexão da rota está com problema | O campo mostra a conexão como "(com problema)". | Resolva a conexão com Testar conexão ou Atualizar credenciais, ou escolha outra. |
| O gateway foi desconectado | A conexão não aparece mais em Conectados. | Conecte de novo e escolha a rota. |
| A Efí está sem a API de Cobranças | A conexão Efí só lista Pix em Formas de pagamento. | Ative a API de Emissão de Cobranças e clique em Testar conexão. |
| O checkout da loja está pausado | Aviso de fatura vencida há 15 dias ou limite rígido de gastos atingido. | Veja Fatura vencida e Orçamento de excedente. |
A conexão ficou como Credenciais inválidas
O gateway passou a recusar as credenciais guardadas. Acontece quando:
- você revogou ou apagou a chave no gateway;
- o certificado da Efí foi revogado;
- no Mercado Pago conectado pelo login, a autorização foi removida e a renovação falhou.
Gere credenciais novas no gateway e use Atualizar credenciais. No Mercado Pago conectado pelo login, desconecte e conecte de novo entrando com o Mercado Pago.
Credenciais de outra conta
Atualizar credenciais recusa credenciais de outra conta do gateway ("As novas credenciais são de outra conta."). Isso evita trocar, sem querer, a conta que recebe as vendas. Para mudar de conta, desconecte o gateway e conecte de novo.
Desconectar um gateway
Use quando for parar de receber por aquela conta. Para trocar só uma chave, prefira Atualizar credenciais.
- Na página da conexão, vá até Desconectar gateway e clique no botão.
- Leia as consequências e digite o nome da conexão exatamente como aparece (por exemplo,
Efí · Produção). - Clique em Desconectar gateway.
Ao desconectar:
- as formas de pagamento que usavam a conexão saem do checkout até você escolher outro gateway;
- Pix e boletos já emitidos continuam sendo confirmados: a MinePag guarda as credenciais só para consultar esses pagamentos, até 15 dias depois da emissão ou 5 dias depois do vencimento do boleto;
- depois desse prazo, ou na hora se não houver pagamento pendente, as credenciais são apagadas da MinePag e o webhook é removido do gateway quando possível;
- pedidos e transações já registrados continuam no painel.
Pagamentos pendentes
Durante esse prazo, a MinePag só consulta os pagamentos já emitidos: ela não cria cobranças, não reembolsa e não importa histórico com a conexão desconectada.
Ainda com problema
Abra um chamado em Suporte no painel com o número do pedido ou o nome da conexão e a mensagem exibida. Nunca envie credenciais, chaves ou o certificado no chamado.