---
title: "Errores de cobro: documentación de Subscriptions | Chargezen"
description: "Cada motivo por el que puede fallar un cobro de suscripción en Chargezen, si se reintenta, dónde lo ves y qué hacer para que se pague la renovación."
url: "https://chargezen.com/es/docs/subscriptions/charge-errors"
lang: "es"
updated: "2026-10-18"
---

Canonical URL: https://chargezen.com/es/docs/subscriptions/charge-errors

# Errores de cobro

Cada motivo por el que puede fallar un cobro de suscripción en Chargezen, si se reintenta, dónde lo ves y qué hacer para que se pague la renovación.

Última actualización: 2026-10-18

Cuando falla un cobro de renovación, Shopify devuelve un código de error. Chargezen clasifica cada código en un grupo que decide si se reintenta, si se avisa al cliente y si tienes que intervenir. Usa esta página para buscar un código y su solución.

## Dónde ves el motivo

*   **Subscriptions → Manage → Orders**, en las vistas **In dunning** y **Failed**, en **Last failure**. Muestra el mensaje propio de Shopify o el código.
*   La página del cobro, que muestra **Last failure** y un aviso como “This charge failed. Chargezen retries it automatically on” y una fecha, o “Needs your action” con lo que hay que solucionar.
*   Los **Logs** de la suscripción, en palabras sencillas, por ejemplo “Payment failed: Insufficient funds”.
*   **Analytics → Dashboards → Order Errors**, agrupados en **Errors by type**.

## Motivos y soluciones

### Problema con el pago del 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`
*   **Qué significa:** El banco o la billetera rechazó el pago, o el método guardado ya no funciona.
*   **¿Se reintenta?** Sí, según tu calendario de Dunning, con mensajes al cliente. Tu acción final se aplica si fallan todos los reintentos.
*   **Qué hacer:** Envía al cliente un enlace para actualizar el pago, para que agregue una tarjeta que funcione. Si son fondos insuficientes, un reintento posterior suele completarse por sí solo.

### Problema de configuración de la tienda

*   **Códigos:** `payment_provider_is_not_enabled, payment_provider_not_enabled, payment_provider_disabled`
*   **Qué significa:** El proveedor de pagos de Shopify de tu tienda está desactivado.
*   **¿Se reintenta?** No. El cobro muestra Needs your action y te espera.
*   **Qué hacer:** Vuelve a activar el proveedor de pagos en Shopify. Los reintentos se reanudan cuando se soluciona.

### Shopify rechazó la solicitud

*   **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`
*   **Qué significa:** Shopify rechazó la solicitud de cobro, así que no se intentó ningún pago.
*   **¿Se reintenta?** No. El cobro muestra Needs your action.
*   **Qué hacer:** Revisa la suscripción en Shopify (por ejemplo, si se pausó o terminó ahí) y luego cóbrala desde Chargezen con Process order now.

### Producto agotado

*   **Códigos:** `insufficient_inventory, inventory_allocations_not_found`
*   **Qué significa:** Un producto del pedido no está disponible.
*   **¿Se reintenta?** Sí, según tu calendario de Dunning. Al cliente no se le dice que su pago falló y no gasta sus reintentos.
*   **Qué hacer:** Repón el producto o cámbialo. Activa Inventory guard para retener los cobros hasta que vuelva a haber inventario.

### Error temporal de Shopify

*   **Códigos:** `rate_limit, throttled, timeout, network_error, service_unavailable, transient_error, unexpected_error`
*   **Qué significa:** Shopify estaba ocupado o no estuvo disponible por un momento.
*   **¿Se reintenta?** Sí, sin avisar. No gasta los reintentos del cliente. Si sigue ocurriendo, el cobro muestra System error.
*   **Qué hacer:** Normalmente nada. Si un cobro termina en System error, reintenta con Retry charge now.

### Cualquier otro

*   **Códigos:** `Any other code Shopify sends`
*   **Qué significa:** Se trata como un problema con el pago del cliente.
*   **¿Se reintenta?** Sí, como un problema con el pago del cliente.
*   **Qué hacer:** Lee el mensaje de Last failure del cobro y sigue la solución correspondiente de arriba.

Confirmación del banco

A veces el banco pide al cliente que confirme un pago. Chargezen envía el email y el SMS Bank confirmation, y puedes copiar el enlace de confirmación desde la sección **Payments** de la suscripción.

## Solución de problemas

### Un cobro muestra System error

Chargezen no pudo completar el cobro por un error temporal y no se creó ningún pedido. Abre el cobro y elige **Retry charge now**.

### Muchos cobros fallaron el mismo día con el mismo código

Eso apunta a tu tienda o a Shopify, no a tus clientes. Revisa tu proveedor de pagos en Shopify y luego reintenta los cobros.

### El cobro dice Retries ran out

Fallaron todos los reintentos y se aplicó tu acción final. Todavía puedes enviar un enlace para actualizar el pago y cobrar el pedido cuando el cliente actualice su tarjeta.

## Relacionado

*   [Recuperación de pagos fallidos](https://chargezen.com/es/subscriptions/failed-payment-recovery): cómo Chargezen logra que se paguen las renovaciones.
*   Glosario: [código de rechazo](https://chargezen.com/es/glossary/decline-code), [cancelación involuntaria](https://chargezen.com/glossary/involuntary-churn), [recuperación de pagos fallidos](https://chargezen.com/glossary/dunning-management).

### Artículos relacionados

[

#### Pagos fallidos

Calendario de reintentos y acciones finales



](https://chargezen.com/es/docs/subscriptions/dunning)[

#### Pedidos y cobros de suscripción

Vistas In dunning y Failed



](https://chargezen.com/es/docs/subscriptions/orders)[

#### Métodos de pago y moneda

Envía un enlace para actualizar el pago



](https://chargezen.com/es/docs/subscriptions/payment-methods)

¿Te resultó útil esta página?

¿Necesitas más ayuda? [Contactar con soporte](https://chargezen.com/docs/checkoutos/troubleshooting/support)
