Erros de cobrança
Cada motivo pelo qual uma cobrança de assinatura pode falhar na Chargezen, se ela é tentada de novo, onde você o vê e o que fazer para a renovação ser paga.
Última atualização: 2026-10-18
Quando uma cobrança de renovação falha, a Shopify devolve um código de erro. A Chargezen classifica cada código em um grupo que decide se ela tenta de novo, se o cliente é avisado e se você precisa agir. Use esta página para consultar um código e a solução.
Onde você vê o motivo
- Subscriptions → Manage → Orders, nas visualizações In dunning e Failed, em Last failure. Mostra a mensagem da própria Shopify, ou o código.
- Na página da cobrança, que mostra Last failure e um aviso como “This charge failed. Chargezen retries it automatically on” uma data, ou “Needs your action” com o que corrigir.
- Nos Logs da assinatura, em palavras simples, por exemplo “Payment failed: Insufficient funds”.
- Em Analytics → Dashboards → Order Errors, agrupados em Errors by type.
Motivos e soluções
Problema no pagamento do cliente
- Códigos:
card_declined, declined, expired_card, expired_payment_method, insufficient_funds, invalid_card, invalid_payment_method, payment_method_declined, payment_method_not_found, authentication_error, buyer_canceled_payment_method, fraud_suspected, invalid_customer_billing_agreement, paypal_error_general - O que significa: o banco ou a carteira digital recusou o pagamento, ou a forma de pagamento salva não funciona mais.
- Tentado de novo: sim, no seu calendário de Dunning, com mensagens ao cliente. Sua ação final é executada se todas as novas tentativas falharem.
- O que fazer: envie ao cliente um link para atualizar o pagamento, para que ele adicione um cartão que funcione. Em caso de saldo insuficiente, uma nova tentativa mais tarde costuma dar certo sozinha.
Problema de configuração da loja
- Códigos:
payment_provider_is_not_enabled, payment_provider_not_enabled, payment_provider_disabled - O que significa: o provedor de pagamentos da Shopify da sua loja está desativado.
- Tentado de novo: não. A cobrança mostra Needs your action e espera por você.
- O que fazer: ative de novo o provedor de pagamentos na Shopify. As novas tentativas recomeçam assim que isso for corrigido.
A Shopify rejeitou a solicitação
- Códigos:
initiation_failed, invalid, contract_not_found, contract_paused, contract_terminated, contract_under_review, cycle_index_out_of_range, cycle_start_date_out_of_range, origin_time_before_contract_creation, origin_time_out_of_range, upcoming_cycle_limit_exceeded, billing_cycle_charge_before_expected_date - O que significa: a Shopify recusou a solicitação de cobrança, então nenhum pagamento foi tentado.
- Tentado de novo: não. A cobrança mostra Needs your action.
- O que fazer: confira a assinatura na Shopify (por exemplo, se ela foi pausada ou encerrada lá) e depois cobre pela Chargezen com Process order now.
Sem estoque
- Códigos:
insufficient_inventory, inventory_allocations_not_found - O que significa: um produto do pedido não está disponível.
- Tentado de novo: sim, no seu calendário de Dunning. O cliente não é avisado de que o pagamento falhou, e isso não gasta as novas tentativas dele.
- O que fazer: reponha o estoque ou troque o produto. Ative o Inventory guard para reter as cobranças até o estoque voltar.
Erro temporário da Shopify
- Códigos:
rate_limit, throttled, timeout, network_error, service_unavailable, transient_error, unexpected_error - O que significa: a Shopify estava ocupada ou ficou indisponível por pouco tempo.
- Tentado de novo: sim, sem aviso. Não gasta as novas tentativas do cliente. Se continuar acontecendo, a cobrança mostra System error.
- O que fazer: normalmente, nada. Se uma cobrança terminar como System error, tente de novo com Retry charge now.
Qualquer outro
- Códigos:
Any other code Shopify sends - O que significa: tratado como um problema no pagamento do cliente.
- Tentado de novo: sim, como um problema no pagamento do cliente.
- O que fazer: leia a mensagem de Last failure na cobrança e siga a solução correspondente acima.
Às vezes o banco pede que o cliente confirme um pagamento. A Chargezen envia o e-mail e o SMS Bank confirmation, e você pode copiar o link de confirmação na seção Payments da assinatura.
Solução de problemas
Uma cobrança mostra System error
A Chargezen não conseguiu concluir a cobrança por causa de um erro temporário, e nenhum pedido foi criado. Abra a cobrança e selecione Retry charge now.
Muitas cobranças falharam no mesmo dia com o mesmo código
Isso aponta para a sua loja ou para a Shopify, e não para os seus clientes. Confira seu provedor de pagamentos na Shopify e tente as cobranças de novo.
A cobrança diz Retries ran out
Todas as novas tentativas falharam e sua ação final foi executada. Você ainda pode enviar um link para atualizar o pagamento e cobrar o pedido assim que o cliente atualizar o cartão.
Relacionados
- Recuperação de pagamentos recusados: como a Chargezen faz as renovações serem pagas.
- Glossário: código de recusa, cancelamento involuntário, recuperação de pagamentos recusados.
Artigos relacionados
Precisa de mais ajuda? Fale com o suporte