Configuration Superwall

Avant de commencer

Vous devez disposer d'un projet Superwall avec au moins une app iOS ou Android et des abonnements sandbox ou live transitant par Superwall. RedChurn ne remplace pas Superwall. 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 Superwall comme fournisseur de facturation. Lors de l'onboarding, RedChurn génère une URL webhook unique pour votre app. Vous la collerez dans Superwall avec le secret de signature Svix que Superwall génère pour le point de terminaison.

• Un projet Superwall avec les événements d'abonnement activés
• Un compte RedChurn avec une app créée (Superwall 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
• E-mails des abonnés dans les attributs utilisateur Superwall (requis pour la récupération par e-mail)

Transmettre les e-mails des abonnés à Superwall

RedChurn envoie les e-mails de récupération à l'adresse que Superwall inclut dans les payloads webhook sous userAttributes.email. Superwall ne déduit pas les e-mails depuis le store. Votre app doit les définir après la connexion avec setUserAttributes.

Ajoutez une ligne dans votre app mobile lorsque l'utilisateur se connecte. Une fois déployée, les nouveaux webhooks incluent l'e-mail et RedChurn peut livrer automatiquement. Les abonnés existants recevront l'e-mail lors de leur prochaine ouverture de l'app après la mise à jour.

RedChurn vérifie si les e-mails arrivent. Sinon, le tableau de bord affiche l'extrait exact pour votre stack sous Intégrations → E-mails des abonnés.

import SuperwallKit

// After login, when you know the subscriber email
Superwall.shared.setUserAttributes(["email": user.email])

import Superwall from '@superwall/react-native-superwall'

// After login, when you know the subscriber email
await Superwall.shared.setUserAttributes({ email: user.email })

import com.superwall.sdk.Superwall

// After login, when you know the subscriber email
Superwall.instance.setUserAttributes(mapOf("email" to user.email))

Ce que RedChurn lit depuis Superwall

Superwall livre les événements du cycle de vie des abonnements via des webhooks signés Svix. RedChurn normalise chaque événement dans le même modèle de rétention utilisé pour tous les fournisseurs de facturation.

Les événements de problème de facturation déclenchent la récupération des paiements. Les événements d'annulation et d'expiration 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 Red Center.

• billing_issue → récupération des paiements (paiement échoué, relance)
• cancellation → sauvegarde à l'annulation lorsqu'un abonné initie une annulation
• expiration → win back pour les abonnés déjà churnés
• renewal / uncancellation → suivi des résultats et attribution MRR
• initial_purchase / product_change → analytics et état abonné (pas de flux sortant par défaut)

Configuration du webhook

Ouvrez votre tableau de bord Superwall : Integrations → 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/superwall/{your-app-slug}

Secret de signature Svix

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

RedChurn vérifie les signatures Svix sur chaque livraison pour rejeter les requêtes falsifiées. Collez la valeur brute exactement comme Superwall l'affiche. RedChurn ne réaffiche jamais le secret après enregistrement.

Vérifier la connexion

Après avoir enregistré le webhook dans Superwall et collé le secret de signature dans RedChurn, cliquez sur Test connection. RedChurn confirme que le point de terminaison et la vérification de signature sont correctement configurés.

Superwall n'envoie pas de webhooks de test arbitraires. Pour confirmer une livraison live, déclenchez un achat sandbox (TestFlight sur iOS ou compte de test Play sur Android). Le tableau de bord passe à Connected dès la réception du premier webhook authentique.

• Test connection → vérifie le secret enregistré et l'accessibilité du point de terminaison
• Achat sandbox → confirme l'arrivée de payloads Superwall réels
• Tableau de bord → Apps → Intégrations affiche le statut Connected

Sandbox vs production

Les webhooks Superwall incluent un champ environment quand disponible. RedChurn tague les événements SANDBOX ou PRODUCTION pour le filtrage dans votre Red Center.

Tant que vous n'avez pas marqué l'app comme déployée en production dans RedChurn, les événements tagués sandbox sont traités comme sandbox par défaut. Marquez production deployed quand votre build App Store ou Play Store est live pour aligner analytics et flux sur les vrais abonnés.

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 Superwall signale un problème de facturation, RedChurn envoie des e-mails de récupération depuis votre domaine selon le calendrier que vous configurez. Aucune release d'app requise au-delà de setUserAttributes pour les e-mails abonnés.

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'App User ID Superwall, et tous les textes et offres restent modifiables depuis le tableau de bord.

Consultez la documentation 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 Superwall. Il ne modifie pas les droits, ne traite pas les remboursements et ne change pas la logique de votre paywall. Votre app continue de fonctionner normalement si RedChurn est temporairement indisponible.

Les placements Superwall, expériences et templates de paywall continuent de fonctionner exactement comme avant. RedChurn ajoute uniquement l'automatisation de la rétention et l'analytics 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 Svix correspond exactement, et que vous avez déclenché un achat sandbox ou production réel.

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, que Resend est connecté pour les canaux e-mail, et que les e-mails abonnés apparaissent dans les attributs utilisateur Superwall.

• Erreurs 401 / signature : secret incorrect ou mauvaise gestion du préfixe whsec_
• Aucun événement dans le tableau de bord : URL incorrecte ou aucun achat déclenché
• E-mail non envoyé : domaine Resend non vérifié, flux désactivé, ou setUserAttributes email manquant
• In-app non affiché : SDK non installé ou App User ID non transmis à RedChurn