Configuration Polar

Avant de commencer

Vous devez disposer d'une organisation Polar avec au moins un produit et des abonnements actifs. RedChurn ne remplace pas Polar. Il ajoute la récupération automatique des paiements, la sauvegarde à l'annulation et le win back sur les canaux de votre choix.

Créez d'abord votre app dans le tableau de bord RedChurn et sélectionnez Polar comme fournisseur de facturation. Lors de l'onboarding, RedChurn génère une URL webhook unique pour votre app. Vous la collerez dans Polar avec le secret de signature que Polar génère.

• Une organisation Polar avec des abonnements actifs
• Un compte RedChurn avec une app créée (Polar sélectionné comme fournisseur)
• Point de terminaison webhook HTTPS (fourni par RedChurn)
• Compte Resend connecté si vous souhaitez des flux e-mail dès le premier jour

Ce que RedChurn lit depuis Polar

RedChurn réagit aux événements du cycle de vie des abonnements transmis via les webhooks Polar. Chaque type d'événement Polar correspond à l'un des trois flux de rétention.

Les abonnements en retard déclenchent la récupération des paiements. Les événements d'annulation et de révocation alimentent la sauvegarde à l'annulation et le win back. Les événements de renouvellement et de réactivation confirment les abonnés récupérés afin que l'impact MRR s'affiche correctement dans votre tableau de bord.

• subscription.past_due → récupération des paiements (paiement échoué, relance)
• subscription.canceled → flux de sauvegarde à l'annulation lorsqu'un abonné initie une annulation
• subscription.revoked → win back pour les abonnés déjà churnés
• subscription.active / subscription.updated → suivi des résultats et attribution MRR

Configuration du webhook

Ouvrez votre tableau de bord Polar : Settings → Webhooks → Add endpoint.

Copiez l'URL webhook depuis l'onboarding RedChurn ou depuis Tableau de bord → Apps → Intégrations. L'URL suit ce modèle et doit utiliser HTTPS :

https://app.redchurn.io/api/webhooks/polar/{your-app-slug}

Secret de signature

Après la création du point de terminaison, Polar affiche un secret de signature (commence par polar_whs_). Copiez-le depuis Polar et collez-le dans RedChurn sous Tableau de bord → Apps → Intégrations.

RedChurn utilise la vérification de signature Standard Webhooks pour rejeter les requêtes falsifiées. Collez la valeur brute du secret exactement telle que Polar l'affiche.

Événements et format de livraison

Abonnez-vous aux événements subscription et order. Nous recommandons d'activer tous les événements d'abonnement afin que RedChurn puisse réagir aux problèmes de facturation, annulations et renouvellements sans lacunes.

Définissez le format de livraison sur Raw JSON. RedChurn normalise les charges utiles Polar côté serveur et les mappe aux mêmes flux de rétention utilisés pour tous les fournisseurs de facturation.

• Events : all subscription events (recommended)
• Delivery format : Raw JSON
• Environment : configurez les points de terminaison de production pour les abonnements live

Vérifier la connexion

Après avoir enregistré le webhook dans Polar et collé le secret de signature dans RedChurn, cliquez sur Test connection. RedChurn confirme que le point de terminaison est prêt à recevoir les livraisons.

Si le test réussit mais qu'aucun événement live n'est encore arrivé, déclenchez un abonnement de test ou un événement de facturation dans Polar. Le tableau de bord passe à Connected dès la réception du premier webhook authentique.

Commencer avec l'e-mail uniquement

Vous n'avez pas besoin du SDK pour lancer la récupération des paiements par e-mail. Suivez le guide de configuration Resend, vérifiez votre domaine d'envoi, puis activez les séquences e-mail sous Scenarios → Email.

Lorsque Polar signale un abonnement en retard, RedChurn envoie des e-mails de récupération depuis votre domaine selon le calendrier que vous configurez. Aucune release d'app requise.

Ajouter les flux in-app plus tard

La sauvegarde à l'annulation, la relance in-app des paiements et les invites win back nécessitent le SDK React Native ou Swift. Installez-le une fois, passez votre clé SDK et l'identifiant abonné, et tous les textes et offres restent modifiables depuis le tableau de bord.

Consultez la documentation du SDK React Native ou Swift pour l'installation et les trois scénarios in-app.

Ce qui reste inchangé

RedChurn est en lecture seule sur les données de facturation Polar. Il ne modifie pas les droits, ne traite pas les remboursements et ne change pas la logique de votre checkout. Votre app continue de fonctionner normalement si RedChurn est temporairement indisponible.

Les produits Polar, le checkout et les abonnements clients continuent de fonctionner exactement comme avant. RedChurn ajoute uniquement l'automatisation de la rétention par-dessus.

Dépannage

Si les événements n'arrivent pas, vérifiez que l'URL webhook est en HTTPS, que le secret de signature correspond exactement, et que le point de terminaison Polar est activé pour les bons types d'événements.

Si le test de connexion réussit mais que les flux ne se déclenchent pas, confirmez que le flux concerné est activé dans le tableau de bord RedChurn et que Resend est connecté pour les canaux e-mail.

• Erreurs 401 : secret de signature incorrect
• Aucun événement dans le tableau de bord : mauvais point de terminaison ou événements d'abonnement manquants
• E-mail non envoyé : domaine Resend non vérifié ou flux désactivé
• In-app non affiché : SDK non installé ou identifiant abonné non défini