Understanding renewal errors (rebill errors)

Tip

This guide is intended for PrestaShop developers and integrators who want to understand the different types of errors that can occur during automatic subscription renewals, and how to diagnose them via the Ciklik API.

Prerequisites

• Access to the Ciklik API (API documentation)
• Familiarity with rebill (automatic renewal) concepts
• Ciklik module installed and configured on PrestaShop

Rebill Errors API Endpoint

The Ciklik API exposes a dedicated endpoint for rebill errors: /api/rebill-errors

Important

This endpoint does not list credit card payment errors (card declined, insufficient funds, etc.). These errors are handled separately through the payment retry mechanism.

For credit card payment errors, see:

• Payment retries: Rebill
• Payment errors

Error Types

The rebill-errors endpoint covers exclusively the following errors:

Complete stock error (failed)

No products from the subscription were available at the time of renewal. No order is generated.

{
  "id": 1,
  "type": "failed",
  "created_at": "2026-01-08T06:00:00Z",
  "subscription_id": "uuid-de-l-abonnement",
  "message": "All items out of stock"
}

Behavior:

• No order is created in PrestaShop
• The subscription remains active
• The error is logged and accessible via the API
• The rebill will be automatically retried the next day, then every following day until stock is restored. Once stock is available again, the renewal is processed and the date of that payment becomes the new due date (the cycle restarts from that date)

Partial stock error (partial)

At least one product from the subscription was out of stock, but the order was placed with the available products.

{
  "id": 432,
  "type": "partial",
  "created_at": "2026-01-08T06:00:00Z",
  "subscription_id": "uuid-de-l-abonnement",
  "message": "Partial stock availability"
}

Behavior:

• The order is created with only the available products
• The out-of-stock product is not listed in the error response (known limitation)
• To identify the missing product, compare the content of the generated order with the expected content of the subscription

Common pitfall — Stock shortage detection

PrestaShop does not explicitly report stock shortage information to the Ciklik module. Detection works as follows:

1. Ciklik attempts to add the product to the PrestaShop cart
2. If the product does not appear in the cart after the add attempt, it is considered out of stock

This is a behavior specific to the PrestaShop integration.

PrestaShop API error

The PrestaShop site returned an unexpected response (empty HTTP response, 500 error, 401, timeout…).

Behavior:

• The error is captured
• The rebill is automatically retried 24 hours later
• The subscription remains in active status

Common pitfall — Empty HTTP response

When Ciklik attempts to create the cart via the PrestaShop module and receives an empty HTTP response, this can generate a silent bug.

Checks to perform:

• The Ciklik server IP is properly whitelisted on the hosting side
• The firewall (iptables, CSF) allows connections
• The WAF (ModSecurity, Sucuri, Cloudflare) is not blocking requests
• .htaccess rules are not interfering

See also: Rebill and PrestaShop site unavailability

Filtering by date

You can filter errors by date to analyze a specific period:

GET /api/rebill-errors?filter[created_at_after]=2026-01-07&filter[created_at_before]=2026-01-09

Historical data

Information

Data from the rebill-errors API is only available from December 2025 (endpoint activation date).

Before this date, errors were temporarily stored, sent via email report, then purged. There is therefore no prior history.

Practical use cases

Diagnosing recurring errors

A subscription has been consistently failing for several months:

1. Retrieve errors for this subscription:

   GET /api/rebill-errors?filter[subscription_id]=uuid-abonnement

2. Analyze the error type:

   • failed → Check the product stock in PrestaShop
   • partial → Compare the generated order with the subscription
   • API error → Check PrestaShop server logs

Daily error report

To identify yesterday’s issues:

GET /api/rebill-errors?filter[created_at_after]=2026-01-07&filter[created_at_before]=2026-01-08

FAQ

Q: Why doesn’t my credit card payment error appear in this endpoint?

Credit card payment errors (card declined, insufficient funds, etc.) are not handled by this endpoint. They go through the payment retry system. See Payment retries: Rebill.

Q: How do I know which product was out of stock during a partial error?

The out-of-stock product is not listed in the error. Compare the content of the generated order (via the orders API) with the expected content of the subscription (via the subscriptions API).

Q: Are errors kept indefinitely?

Yes, since the endpoint was activated in December 2025. Earlier errors were not retained.