--- title: "Erros de cobrança: documentação do Subscriptions | Chargezen" description: "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." url: "https://chargezen.com/pt-br/docs/subscriptions/charge-errors" lang: "pt-BR" updated: "2026-10-18" --- Canonical URL: https://chargezen.com/pt-br/docs/subscriptions/charge-errors # 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. Confirmação do banco À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](https://chargezen.com/pt-br/subscriptions/failed-payment-recovery): como a Chargezen faz as renovações serem pagas. * Glossário: [código de recusa](https://chargezen.com/pt-br/glossary/decline-code), [cancelamento involuntário](https://chargezen.com/glossary/involuntary-churn), [recuperação de pagamentos recusados](https://chargezen.com/glossary/dunning-management). ### Artigos relacionados [ #### Pagamentos recusados Calendário de novas tentativas e ações finais ](https://chargezen.com/pt-br/docs/subscriptions/dunning)[ #### Pedidos e cobranças de assinatura Visualizações In dunning e Failed ](https://chargezen.com/pt-br/docs/subscriptions/orders)[ #### Formas de pagamento e moeda Envie um link para atualizar o pagamento ](https://chargezen.com/pt-br/docs/subscriptions/payment-methods) Esta página foi útil? Precisa de mais ajuda? [Fale com o suporte](https://chargezen.com/docs/checkoutos/troubleshooting/support)