Documentation · Cartnorm Subscriptions

Failed payments and retries

Cartnorm Subscriptions is not on WordPress.org yet. These pages describe version 1.0.0, the version that will be published. Pro features are planned and marked as such.

When a renewal payment fails, Cartnorm Subscriptions decides from Stripe’s answer what to do next. Every attempt, its result and the reason are written to the subscription’s history.

Cards: temporary declines are retried

For declines that can still succeed (for example insufficient funds or a temporary bank problem), the payment is retried automatically:

AttemptWhen
1st retry1 day after the failed payment
2nd retry3 days after the 1st retry
3rd retry5 days after the 2nd retry

After each failure the customer gets the Subscription payment needs attention email with the date of the next retry and a Pay now button. While a payment is open, the subscription waits for payment, and the customer sees the same information in My Account. In the free plugin the retry schedule is fixed; configurable retries and a grace period are planned for Pro.

Cards that cannot be charged again

Some declines are final for that card, for example a lost or stolen card. These are not retried, because retrying would only fail again. The customer is asked to change the payment method and pay the open renewal.

The bank asks for confirmation

Sometimes the customer’s bank wants the customer to confirm a payment (strong customer authentication). The customer gets an email with a Pay now link and confirms the payment there. My Account shows Please confirm your payment.

Errors that are not declines

If Stripe does not answer clearly (a timeout or a temporary Stripe error), the payment is not treated as failed. The plugin checks the result again with the same request, so a payment that actually went through is never charged a second time.

SEPA Direct Debit

Bank debits fail differently and later than cards. They have their own rules: see SEPA Direct Debit.

Other gateways

With gateways other than the WooCommerce Stripe Gateway, nothing is charged automatically. The customer gets a pay link for each renewal, and the renewal waits until it is paid.

Where to see it

  • WooCommerce › Subscriptions › Overview counts subscriptions that need attention.
  • The subscription page in WooCommerce › Subscriptions › Subscriptions shows every attempt, the Stripe result and the next retry.

Something unclear or missing? Write to [email protected].