Rebill et indisponibilité du site PrestaShop

Astuce

Ce guide explique le comportement de Ciklik lorsque votre site PrestaShop est temporairement inaccessible au moment du renouvellement automatique des abonnements, et les précautions à prendre côté hébergement.

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 :

1. Les rebills ne sont pas marqués en erreur dans l’interface Ciklik
2. Ils n’apparaissent pas comme des échecs classiques
3. Le rebill est retenté automatiquement 24h plus tard
4. L’abonnement reste au statut actif pendant ce temps

Information

Ce comportement est différent des erreurs de paiement CB qui suivent le scénario de tentatives configuré. Voir Tentatives de prélèvements : Rebill.

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

Action critique

Assurez-vous que l’IP du serveur Ciklik est autorisée dans toutes les couches de sécurité de votre hébergement.

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

Pour obtenir l’IP du serveur Ciklik, contactez le support : support@ciklik.co

Mode maintenance PrestaShop

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

Bonne pratique

Lors de l’activation du mode maintenance :

1. Ajoutez l’IP Ciklik à la liste des IP autorisées
2. Ou planifiez la maintenance en dehors de la fenêtre de rebill

Voir aussi : Activer le mode maintenance / Fermer le site aux visiteurs

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
• Aucune erreur visible dans l’interface Ciklik
• 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 les réponses HTTP (devrait être 200)
curl -I https://votre-site.com/module/ciklik/api

Piège courant — Réponse HTTP vide

Une réponse HTTP vide du serveur PrestaShop est plus difficile à diagnostiquer qu’un code d’erreur 500 explicite.

Causes fréquentes :

• memory_limit PHP dépassé
• max_execution_time atteint
• Crash Apache/Nginx pendant le traitement
• Module PrestaShop générant une erreur fatale

Diagnostic : Vérifiez les logs d’accès du serveur web pour identifier les requêtes de Ciklik qui n’obtiennent pas de réponse complète.

Vérifications côté Ciklik

1. Accédez aux erreurs de rebill via l’API :

   GET /api/rebill-errors?filter[created_at_after]=2026-01-01

2. Vérifiez si des erreurs de type “API PrestaShop” apparaissent

3. 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 :

1. Vérifiez que le site est de nouveau accessible depuis l’extérieur
2. Testez l’endpoint API Ciklik : https://votre-site.com/module/ciklik/api
3. Attendez 24h : les rebills seront automatiquement retentés
4. 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.