Paiements : Stripe, Mercado Pago, Pagar.me et Hotmart

Sans passerelle connectée, l’écran de paiement de l’app existe mais l’achat n’aboutit pas. L’argent va directement sur votre compte chez le fournisseur : la plateforme n’intervient pas dans le paiement et ne facture pas de crédit d’intégration pour cela.

Avant de commencer

• Plan : Builder ;
• Compte chez le fournisseur : Stripe, Mercado Pago ou Pagar.me (créer un compte et utiliser le mode test est gratuit chez les trois ; les frais par vente sont ceux de chaque fournisseur) ;
• Une passerelle par app. Stripe, Mercado Pago et Pagar.me partagent la même place : en enregistrer une remplace l’autre. Hotmart est à part et peut coexister avec elles ;
• Ne sert pas à l’intérieur de l’app des stores. Dans l’app installée depuis l’App Store ou Google Play, c’est le store qui encaisse. C’est un autre sujet, traité dans Vendre des abonnements dans l’app.

Toutes se trouvent dans l’onglet Intégrations, catégorie Paiements.

Testez avant de vendre

Aucune des trois passerelles n’a de bouton d’environnement sur la carte : l’environnement est celui de la clé que vous collez. Commencez toujours par les clés de test, faites un achat de test et seulement ensuite passez à celles de production.

Lors du changement, saisissez les clés de production dans leurs champs. Un champ laissé vide conserve sa valeur enregistrée : une clé de test dans un champ que vous n’avez pas saisi reste donc en vigueur.

Lorsque vous changez de passerelle (par exemple, de Stripe à Mercado Pago), les clés de la précédente ne passent pas à la nouvelle : remplissez les champs de la carte de la nouvelle passerelle.

Stripe

Champs de la carte : Clé publiable (pk_), Clé secrète (sk_) et Secret du webhook (whsec_).

1. sur dashboard.stripe.com, activez le mode test ;
2. dans Développeurs → Clés API, copiez la clé publiable (pk_test_…) et la clé secrète (sk_test_…) ;
3. sur la carte Stripe, collez les deux et laissez le Secret du webhook vide ;
4. cliquez sur Enregistrer et activer.

La plateforme teste la clé secrète et crée le webhook toute seule dans votre compte Stripe. La carte affiche le bloc URL du webhook avec le badge Automatique et la liste des événements : il n’y a rien à faire dans le tableau de bord Stripe.

Pour la production, recommencez avec le mode test désactivé (pk_live_… et sk_live_…).

Mercado Pago

Champs de la carte : Public Key, Access Token et Clé secrète du webhook.

Mercado Pago ne permet pas de créer le webhook par API, c’est donc la seule des trois avec une étape manuelle.

1. sur mercadopago.com.br/developers/panel, créez une application ;
2. dans Identifiants de test, copiez la Public Key et l’Access Token ;
3. sur la carte Mercado Pago, collez les deux et cliquez sur Enregistrer et activer ;
4. la carte affiche alors le bloc URL du webhook avec le badge Manuel, l’URL avec un bouton Copier et les Événements à activer ;
5. dans le tableau de bord Mercado Pago, sous Vos intégrations → Webhooks, collez l’URL, cochez les événements listés et enregistrez ;
6. copiez la clé secrète que Mercado Pago a générée pour ce webhook ;
7. revenez à la carte, remplissez la Clé secrète du webhook et cliquez de nouveau sur Enregistrer et activer. Public Key et Access Token peuvent rester vides : la valeur enregistrée est conservée.

Sans la clé secrète du webhook, la plateforme ne peut pas confirmer les avis de paiement, et l’achat ne débloque rien dans l’app.

Pagar.me

Champs de la carte : Clé d'API (secret) et Clé publique (encryption).

1. dans le tableau de bord Pagar.me, allez dans Paramètres → Clés API et choisissez l’environnement de test ;
2. copiez la clé secrète (sk_…) et la clé publique (pk_…) ;
3. sur la carte Pagar.me, collez les deux et cliquez sur Enregistrer et activer ;
4. la carte affiche le bloc URL du webhook avec le badge Manuel. L’URL contient déjà un identifiant et un mot de passe générés par la plateforme : traitez-la comme un secret ;
5. dans le tableau de bord Pagar.me, sous Paramètres → Webhooks, collez cette URL et cochez les Événements à activer que la carte liste.

Il n’y a pas de champ de secret de webhook à remplir pour Pagar.me : l’authentification est déjà incluse dans l’URL.

Hotmart

Hotmart n’est pas une passerelle de l’app. Elle vend sur son propre site, et l’intégration permet à l’app de reconnaître qui a déjà acheté et de débloquer l’accès toute seule.

Champs de la carte : Client ID, Client Secret, Hottok (du Webhook), Code(s) du produit qui débloque l'app et l’option Utiliser l'environnement de test (sandbox).

1. sur Hotmart, dans Outils > Identifiants Developers, créez l’identifiant et copiez le Client ID et le Client Secret ;
2. dans Outils > Webhook, copiez le hottok ;
3. sur la carte Hotmart, remplissez les champs. Dans Code(s) du produit qui débloque l'app, indiquez le code du produit (séparez par des virgules s’il y en a plusieurs) ;
4. cochez Utiliser l'environnement de test (sandbox) uniquement si les identifiants sont de test ;
5. cliquez sur Enregistrer et activer. La plateforme demande à Hotmart à qui appartient le compte et affiche « Connecté à Hotmart (nom). », avec le nom du compte, ce qui confirme que vous avez connecté le bon compte ;
6. copiez l’URL du webhook affichée par la carte et collez-la dans le panneau Hotmart, sous Outils > Webhook, en choisissant les événements d’achat et d’abonnement.

Dans l’app publiée sur les stores, la vente ne peut pas avoir lieu : l’app débloque seulement ce qui a été acheté sur le site.

Faire le premier paiement de test

1. connectez la passerelle avec les clés de test ;
2. si l’app n’a pas encore d’écran d’achat, demandez-le dans le chat (par exemple : « crée la page des offres avec un bouton d’abonnement »). Cette partie consomme des crédits d’IA, comme toute construction ;
3. ouvrez l’app et faites un achat. Chez Stripe, la carte de test est 4242 4242 4242 4242, avec n’importe quelle date future et n’importe quel code de sécurité. Chez Mercado Pago et Pagar.me, utilisez les cartes de test de la documentation de chacun ;
4. vérifiez l’achat dans le tableau de bord du fournisseur, en mode test, et regardez si l’app a débloqué ce qui a été acheté.

Ne passez aux clés de production qu’après que ce cycle complet a fonctionné.

Savoir que cela a fonctionné

• la carte affiche Connectée. Pour les trois passerelles et Hotmart, ce badge vient d’un vrai test auprès du fournisseur, pas seulement du formulaire enregistré ;
• chez Stripe, le bloc du webhook porte le badge Automatique ;
• chez Mercado Pago, la clé secrète du webhook a été enregistrée après la création du webhook dans le tableau de bord ;
• l’achat de test apparaît dans le tableau de bord du fournisseur et l’app débloque l’accès.

Problèmes courants

• Erreur de configuration dès l’enregistrement. La clé secrète a été refusée : vérifiez que vous avez copié la secrète (et non la publiable) et qu’il ne reste pas d’espace au début ou à la fin ;
• Le paiement est approuvé chez le fournisseur et l’app ne débloque rien. C’est le webhook. Chez Mercado Pago, il manque la clé secrète ou un événement. Chez Pagar.me, l’URL collée n’est pas celle affichée par la carte ou il manque un événement ;
• J’ai changé de passerelle et l’ancienne s’est arrêtée. C’est attendu : une seule reste active par app ;
• Le bouton d’abonnement n’apparaît pas dans l’app installée depuis le store. Dans l’app des stores, la passerelle n’est jamais utilisée. Voir Vendre des abonnements dans l’app.