O pagamento não é processado. Erro visível no checkout.

O pagamento parece ser concluído, mas o dinheiro não chega.

Alguns métodos funcionam e outros não.

• Os pedidos aparecem no Shopify, mas o pagamento é exibido como "pendente" ou "simulado"
• As credenciais configuradas começam com TEST- (MercadoPago) ou key_test_ (Conekta)
• No painel do gateway, os pagamentos aparecem no ambiente de testes

1. Vá ao painel do seu gateway e obtenha as credenciais de produção
2. No Shopify: Configurações > Pagamentos > edite seu gateway
3. Substitua as credenciais de teste pelas de produção
4. Desative o modo de teste se houver um botão específico
5. Faça uma compra de teste real para confirmar

• Você recebe um e-mail do gateway indicando que é necessária verificação adicional
• Os pagamentos são processados, mas os fundos não são liberados
• No painel do gateway, há alertas ou notificações pendentes

1. Faça login no painel do seu gateway e verifique as notificações pendentes
2. Complete todos os passos de verificação (documentos, dados fiscais, conta bancária)
3. Se sua conta foi suspensa, entre em contato com o suporte do gateway para reativá-la
4. Ative um gateway alternativo temporariamente enquanto resolve o problema

• Os pagamentos funcionavam antes e pararam de funcionar de repente sem mudanças aparentes
• O erro menciona "autenticação falha" ou códigos 401/403

1. Vá ao painel do seu gateway > seção de credenciais ou chaves da API
2. Copie as credenciais de produção atuais
3. No Shopify: Configurações > Pagamentos > edite seu gateway e atualize as credenciais
4. Salve e faça uma compra de teste

Métodos de pagamento desativados ou mal configurados

Dentro de cada gateway, os métodos (cartões, OXXO, SPEI, PSE) são ativados individualmente. Se um não aparece no checkout, pode estar desativado no gateway ou no Shopify. Alguns métodos como OXXO Pay ou MSI exigem aprovação adicional.

Solução: Vá em Configurações > Pagamentos no Shopify e verifique quais métodos estão ativos. Confirme também no painel do seu gateway se esses métodos estão habilitados para sua conta.

Conflito entre múltiplos gateways ativos

Ter mais de um gateway ativo pode gerar conflitos: opções duplicadas no checkout, erros intermitentes ou pagamentos que são processados pelo gateway errado. Comum quando um novo gateway é ativado sem desativar corretamente o anterior.

Solução: Defina um gateway principal e desative os que você não precisa. Se usar vários, certifique-se de que cada um tenha métodos claramente diferenciados e não sobrepostos.

Problema com o certificado SSL

Sem SSL válido, os navegadores bloqueiam o processo de pagamento e os gateways recusam as conexões. O Shopify inclui SSL automaticamente, mas pode haver problemas com domínios personalizados mal configurados ou com conteúdo misto (recursos carregando por HTTP em vez de HTTPS).

Solução: Vá em Configurações > Domínios e verifique o status do certificado SSL. Consulte a documentação oficial do Shopify sobre SSL.

Moeda não suportada pelo gateway

Nem todos os gateways suportam todas as moedas. Se sua loja cobra em MXN, COP ou ARS, mas seu gateway só aceita USD, os pagamentos falharão. Especialmente relevante na LATAM, onde há muitas moedas locais.

Solução: Use o MercadoPago como gateway principal (suporta MXN, ARS, COP, CLP nativamente). Verifique a compatibilidade de moedas na documentação do seu gateway antes de ativá-lo.

Webhooks mal configurados

Os webhooks são notificações que o gateway envia para a Shopify quando um pagamento é concluído. Sem eles configurados corretamente, os pedidos ficam com status pendente indefinidamente. Crítico para métodos diferidos como OXXO Pay ou PSE, onde o cliente paga horas depois de gerar o recibo.

Solução: No painel do seu gateway, verifique se a URL do webhook aponta corretamente para sua loja Shopify. Faça uma transação de teste com um método diferido para confirmar que o webhook funciona.

Restrições do plano da Shopify

Alguns planos têm restrições sobre quais gateways você pode usar e aplicam taxas adicionais por transação quando você usa gateways de terceiros: 2% no Basic, 1% no Shopify, 0.5% no Advanced. No Shopify Plus essas taxas desaparecem.

Solução: Verifique os limites do seu plano em Configurações > Plano. Considere ativar o Shopify Payments se estiver disponível em seu país para eliminar taxas adicionais.

Erros do lado do cliente

Nem todos os problemas são de configuração. Cartão recusado por fundos insuficientes, dados incorretos, limites do banco para compras online ou autenticação 3D Secure falha são erros normais do lado do cliente que não indicam um problema com sua loja.

Solução: Configure mensagens de erro claras, ofereça múltiplos métodos de pagamento e tenha um canal de atendimento (WhatsApp) onde o cliente possa relatar o problema e receber ajuda imediata.

🏭 Opção A: Modo sandbox

Use cartões de teste sem processar dinheiro real:

• MercadoPago: 4509 9535 6623 3704
• Conekta: 4111 1111 1111 1111
• Stripe: 4242 4242 4242 4242
• CVV: quaisquer 3 dígitos • Data: futura

💰 Opção B: Compra real mínima

Crie um produto de R$ 1 e faça uma compra real com seu cartão. Depois, reembolse-se pela Shopify.

Confirme o fluxo completo de produção, incluindo e-mails e webhooks.

📊 Monitoramento periódico

Revise o painel do seu gateway semanalmente. Configure alertas por e-mail para erros de pagamento ou alterações no status da sua conta.

🔐 Gateway de backup

Tenha um segundo gateway configurado e pronto para ativar em caso de emergência. Pode salvá-lo de perder vendas por horas.

📄 Documente sua configuração

Guarde em um gerenciador de senhas: credenciais de produção, URLs de webhooks, métodos ativos e contatos de suporte de cada gateway.

📊 Testes mensais

Uma vez por mês, faça uma compra de teste rápida para confirmar que tudo continua funcionando. É melhor descobrir você antes que seus clientes.

As causas mais comuns: o aplicativo não está instalado ou está desativado, as credenciais estão incorretas, ou a conta não está verificada. Verifique Configurações > Pagamentos no seu painel da Shopify.

Verifique no painel do seu gateway se o pagamento foi processado. Se aparecer no gateway, mas não na Shopify, o problema está nos webhooks. Entre em contato com o cliente e ofereça alternativas de pagamento enquanto você resolve.

Sim. Ative temporariamente o PayPal ou outro gateway alternativo enquanto resolve o problema. Isso permite que você continue recebendo pagamentos sem interromper sua operação.

Geralmente entre 24 e 48 horas para novos domínios ou com alterações recentes de DNS. Se após 48 horas o SSL ainda não estiver ativado, entre em contato diretamente com o suporte da Shopify.

Verifique o código de erro no painel do seu gateway. Erros como insufficient_funds ou card_declined são do banco do cliente. Erros de autenticação são da sua configuração.