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.
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: cómo Chargezen logra que se paguen las renovaciones.
- Glosario: código de rechazo, cancelación involuntaria, recuperación de pagos fallidos.
Artículos relacionados
¿Necesitas más ayuda? Contactar con soporte