Configurer le paiement pour Adapty Mail

Chaque e-mail envoyé par Adapty Mail contient un lien de paiement unique pour le destinataire. Lorsqu’il clique, il arrive sur un tunnel de paiement web qui l’identifie par profil, lui présente votre offre et traite le paiement. Les tunnels de paiement se trouvent dans Web Paywalls dans Adapty Mail et sont modifiés dans le web paywall builder intégré.

Prérequis

  • Un fournisseur de paiement web avec vos produits d’abonnement configurés. Generate with AI ne prend en charge que Stripe et la connexion se fait directement dans le builder. Use your own hosted paywall accepte n’importe quel fournisseur — Stripe, Paddle, PayPal ou autre — puisque le paiement est géré de votre côté.

Vous n’avez pas besoin d’un compte séparé pour le web paywall builder. Il est intégré à Adapty Mail : un espace de travail est provisionné automatiquement lors de votre première connexion, et vous êtes connecté à l’éditeur avec vos identifiants Adapty. Cela est indépendant de tout paywall web que vous avez pu configurer sur la page paywall du tableau de bord Adapty principal — les paywalls web d’Adapty Mail sont des entités distinctes, gérées entièrement depuis Adapty Mail.

Configurer votre tunnel de paiement

Dans Adapty Mail, accédez à Web Paywalls → Create. Deux options s’offrent à vous :

  • Generate with AI : le créateur de paywall web intégré à Adapty Mail génère le tunnel pour vous. Stripe uniquement — pour Paddle ou PayPal, utilisez la deuxième option.
  • Use your own hosted paywall : connectez un paywall que vous hébergez déjà, quel que soit le prestataire de paiement.

Générer avec l’IA

La page de création affiche un panneau Prerequisites en haut avec des boutons d’action intégrés qui vous guident à travers chaque condition préalable — état de la marque, connexion au builder, connexion Stripe, produits, et une étape finale de révision et publication. Parcourez-les dans l’ordre ; le panneau se met à jour à mesure que chaque étape est complétée.

Panneau Prerequisites sur la page de création du Web Paywall avec une liste de vérification et des boutons d'action intégrés

Lorsque les prérequis sont au vert, cliquez sur Generate pour ouvrir la boîte de dialogue de génération. Deux choix à faire :

  • Environment : Choisissez Production ou Sandbox. Sandbox utilise vos produits Stripe en mode test et constitue l’option par défaut recommandée pour le développement et les environnements locaux — son compte est isolé de la production, donc les transactions de test n’affectent jamais les données live.
  • Plans : Choisissez jusqu’à 3 plans Stripe. Chaque plan est une combinaison produit + prix. Le paywall présente ces plans comme les offres disponibles au moment du paiement. Si vous en sélectionnez moins de 3, le paywall affiche uniquement les plans choisis.
Web paywall generation dialog with Environment toggle and Stripe plan selector

Cliquez sur Generate pour lancer la compilation. Une fois terminée, ouvrez l’éditeur dans le builder pour vérifier le résultat et le publier. Ensuite, cliquez sur Save.

Important

Le paywall doit être publié avant de pouvoir traiter le trafic de paiement. Les paywalls non publiés renvoient une erreur lorsque les utilisateurs cliquent sur les liens de paiement envoyés par e-mail.

Pour les détails concernant le fournisseur de paiement dans le builder (comptes Stripe, mode test ou live, configuration des produits), consultez Configuration du paywall web.

Utiliser votre propre paywall hébergé

  1. Sur la page Create, sélectionnez Enter URL manually.

  2. Collez l’URL de votre paywall hébergé avec des paramètres de substitution en tant que paramètres de requête. Adapty Mail les remplace pour chaque destinataire afin que la page puisse identifier le visiteur. Exemple :

    https://example.com/paywall?email={email}&adapty_profile_id={adapty.external_profile_id}
  3. Enregistrez.

La page Create liste les paramètres de substitution disponibles et coche chacun de ceux qu’elle détecte dans l’URL que vous collez. Voici ceux à privilégier :

PlaceholderValue
{email}L’adresse e-mail du destinataire.
{adapty.external_profile_id}L’ID de profil du destinataire dans Adapty.
{custom.external_profile_id}L’ID utilisateur que vous avez envoyé via l’API Mail Adapty.
{scheduled_email_id}L’ID de l’e-mail qui contenait le lien.

La page propose également un placeholder par source de profil, elle peut donc lister des sources depuis lesquelles votre projet n’envoie pas de données. Un placeholder pour lequel le destinataire n’a aucune valeur est résolu en chaîne vide, donc il n’atteindra jamais votre page sous forme de texte brut.

Ce chemin fonctionne avec n’importe quel fournisseur de paiement — Adapty Mail gère uniquement la redirection et la substitution de paramètres ; le paiement et la personnalisation se font entièrement de votre côté.

À quoi ressemble le processus de paiement

Lorsqu’un utilisateur clique sur un lien de paiement, il arrive sur la Main conversion page. Après avoir tenté un paiement, il voit soit Payment success, soit Payment failed — une seule page s’affiche par tentative.

Main conversion page Une page de vente complète. L’IA génère le texte et les images pour chaque section :

SectionCe que l’IA génère
Titre principalTitre accrocheur axé sur les bénéfices
Sous-titreProposition de valeur complémentaire
Badge d’offreBadge d’urgence (sans prix inventés — utilise un langage promotionnel vague)
Bouton CTATexte orienté action, 2 à 5 mots
Bénéfices3 à 6 cartes bénéfices avec emoji et texte
Fonctionnalités3 à 8 descriptions de fonctionnalités avec titre et sous-titre
ForfaitsTitre de sélection du forfait et texte du minuteur d’offre
Preuve socialeTexte de preuve communautaire et 3 à 5 avis d’utilisateurs réalistes
FAQ3 à 6 questions-réponses courantes
GarantieTexte de garantie satisfait ou remboursé

Paiement réussi Un message de félicitations avec les prochaines étapes et une image générée par IA.

Paiement échoué Un message bienveillant invitant l’utilisateur à réessayer. L’état du paiement est conservé.

Comment fonctionne la personnalisation

Le lien CTA de chaque e-mail pointe vers une URL de paiement construite pour son destinataire. Avant l’envoi, Adapty Mail remplace chaque espace réservé dans votre URL de paywall par les valeurs propres à ce destinataire :

https://example.com/paywall?email=jane@example.com&adapty_profile_id=6f2a...c91

Les paramètres d’un paywall généré sont définis automatiquement — aucune configuration dans le Paywall Builder en ligne n’est requise. Pour un paywall ajouté par URL, vous choisissez les paramètres à inclure. Lorsque l’utilisateur clique, la page de paiement lit ces paramètres pour l’identifier. Une fois l’achat effectué, Adapty associe le revenu à l’adresse e-mail précise qui a déclenché la conversion. Ces données apparaissent dans Analytique des campagnes.

Résolution des problèmes

ProblèmeSolution
Le lien de paiement ne s’ouvre pasVérifiez que le paywall est publié dans le web paywall builder
L’utilisateur n’est pas identifié au moment du paiementConfirmez que Adapty.identify() a bien été appelé avec l’identifiant utilisateur correct avant l’envoi de l’e-mail
L’achat n’est pas attribué à l’e-mailVérifiez que le paramètre cid est présent dans l’URL de paiement — contactez le support si des paramètres sont manquants