Rebill et indisponibilité du site PrestaShop

Prérequis

Module Ciklik installé et configuré sur PrestaShop
Accès à la configuration de l’hébergement (pare-feu, WAF, .htaccess)
Connaissance du fonctionnement des rebills

Comportement en cas d’indisponibilité

Si le site PrestaShop est inaccessible au moment où Ciklik tente de passer les commandes de renouvellement :

Les rebills ne sont pas comptés comme des échecs de paiement : le scénario de tentatives de prélèvement ne s’applique pas
L’erreur est enregistrée dans la rubrique Erreurs de renouvellement (type Appel du module en erreur) et le panneau Situation du renouvellement de l’abonnement indique la cause “Votre boutique n’a pas répondu à Ciklik”
Le rebill est retenté automatiquement 24h plus tard
L’abonnement reste au statut actif pendant ce temps

Causes d’indisponibilité

Maintenance PrestaShop

Mise à jour du CMS PrestaShop
Installation/mise à jour de modules
Migration de base de données
Intervention sur le serveur

Problèmes techniques

Crash du serveur web (Apache, Nginx)
Dépassement de ressources (mémoire, CPU)
Expiration du certificat SSL
Problème DNS

Blocages de sécurité

Pare-feu bloquant l’IP Ciklik
WAF (Web Application Firewall) rejetant les requêtes
Protection anti-DDoS trop restrictive
Règles .htaccess bloquantes

Précautions pour l’hébergement

Whitelist IP Ciklik

Vérifications à effectuer :

Couche	Action
Pare-feu système (iptables, CSF, UFW)	Ajouter l’IP Ciklik en whitelist
WAF (ModSecurity, Sucuri)	Créer une règle d’exception pour l’IP Ciklik
Cloudflare / CDN	Configurer une règle de contournement
Protection anti-DDoS (OVH, etc.)	Ajouter l’IP en liste blanche
`.htaccess`	Vérifier qu’aucune règle ne bloque les requêtes API

Les adresses IP de Ciklik sont indiquées dans l’application Ciklik, rubrique Mon installation. À défaut, demandez-les au support : support@ciklik.co

Mode maintenance PrestaShop

Le mode maintenance de PrestaShop bloque aussi les appels API de Ciklik.

Planification des maintenances

Les rebills sont généralement processés la nuit. Pour minimiser l’impact :

Recommandations :

Planifier les maintenances PrestaShop en journée
Éviter les mises à jour critiques les jours de rebill (souvent le 1er du mois)
Si une maintenance doit avoir lieu pendant la fenêtre de rebill, contacter le support Ciklik pour planifier un rebill manuel après la maintenance

Diagnostic des problèmes

Symptômes d’une indisponibilité

Abonnements actifs avec end_date qui ne se met plus à jour
Des lignes Appel du module en erreur dans la rubrique Erreurs de renouvellement de l’abonnement ou de votre site
Aucune nouvelle commande dans PrestaShop depuis plusieurs jours

Vérifications côté serveur

# Vérifier les logs d'accès pour les requêtes Ciklik
grep "IP_CIKLIK" /var/log/apache2/access.log

# Vérifier les logs d'erreur
tail -100 /var/log/apache2/error.log

# Vérifier que les deux chemins appelés par Ciklik répondent.
# Sans clé, la réponse attendue est 401 (accès refusé par PrestaShop ou par le module).
# Un 403, un 503, une redirection ou une absence de réponse signalent un blocage.
curl -I https://votre-site.com/api
curl -I https://votre-site.com/ciklik/gateway

Vérifications côté Ciklik

Accédez aux erreurs de rebill via l’API :
Fenêtre de terminal
```
GET /api/rebill-errors?filter[created_at_after]=2026-01-01
```
Vérifiez si des erreurs de type “API PrestaShop” apparaissent
Contactez le support Ciklik si vous suspectez un problème de communication

Actions correctives

Après une indisponibilité

Si votre site a été indisponible pendant une fenêtre de rebill :

Vérifiez que le site est de nouveau accessible depuis l’extérieur
Testez les deux chemins appelés par Ciklik : https://votre-site.com/api et https://votre-site.com/ciklik/gateway (réponse 401 attendue sans clé), ou consultez la ligne Ciklik joint votre boutique de la rubrique Mon installation
Attendez 24h : les rebills seront automatiquement retentés
Ou contactez le support pour déclencher un rebill manuel immédiat

Prévention

Configurez une supervision (UptimeRobot, Pingdom, etc.) sur l’endpoint API Ciklik
Activez les alertes en cas d’indisponibilité
Documentez les IP à whitelister pour les équipes techniques

FAQ

Q : Les clients seront-ils prélevés deux fois si le rebill est retenté ?

Non. Le système vérifie si le rebill a déjà été effectué avec succès avant de retenter. Aucun double prélèvement n’est possible.

Q : Combien de fois Ciklik retente-t-il en cas d’indisponibilité ?

Le rebill est retenté toutes les 24h jusqu’à ce que le site soit de nouveau accessible. Il n’y a pas de limite de tentatives pour les erreurs d’accessibilité (contrairement aux erreurs de paiement CB).

Q : Comment savoir si mon site a été inaccessible pendant un rebill ?

Vérifiez les logs d’accès de votre serveur web à la date/heure du rebill prévu. L’absence de requêtes de l’IP Ciklik ou des codes de réponse autres que 200 indiquent un problème.

Q : Le mode maintenance de PrestaShop affecte-t-il les rebills ?

Oui. Le mode maintenance bloque toutes les requêtes, y compris celles de Ciklik. Ajoutez l’IP Ciklik à la liste des exceptions ou désactivez le mode maintenance avant les rebills.

Voir aussi

Installer le module Ciklik

Renouvellements PrestaShop expliqués

Comprendre les erreurs de renouvellement (rebill errors)