Dans cette histoire
Emplacement : Paramètres → Lecteurs et revenus → Connexions → Paiements
Ouvrez cette page : admin.<your-site>/settings/connections/payments (remplacez <your-site> par l'adresse de votre site)
Avant de commencer
- Connectez d'abord Razorpay, Stripe ou PayPal. Consultez Paiements.
- Vous devez être le propriétaire du site.
Étapes à suivre
Stripe et PayPal : Keynate configure automatiquement ces messages de paiement dès que possible. La carte indique alors « Les messages de paiement sont configurés pour vous dans Stripe. » Si ce n'est pas possible, la mention « Encore une étape » s'affiche avec un bouton Terminer la configuration. Suivez les étapes ci-dessous.
Razorpay : la configuration automatique n'est pas possible. La carte Razorpay propose un encadré d'aide en 3 étapes avec vérification en direct : En attente du premier message de Razorpay… devient Nous avons bien reçu le premier message de Razorpay. après votre tout premier paiement, test ou réel. Cliquez sur Vérifier maintenant pour vérifier à nouveau. Consultez Connecter Razorpay.
Voici les étapes pour chaque passerelle :
- Ouvrez Paramètres → Lecteurs et revenus → Connexions → Paiements.
- Sur la carte de votre passerelle, repérez le bloc Webhook.
- Cliquez sur Ouvrir les webhooks (le bouton indique le nom de votre passerelle). Le tableau de bord du service s'ouvre dans un nouvel onglet.
- Dans votre passerelle de paiement, cliquez sur Ajouter.
- Revenez dans Keynate, cliquez sur Copier à côté de l'adresse URL du webhook, puis collez-la dans la passerelle.
- Cochez les événements indiqués dans l'encadré Keynate.
- Razorpay : cliquez sur Copier pour copier le code secret et collez-le dans le champ secret. Utilisez un secret différent pour le mode test et le mode réel.
- Enregistrez dans votre passerelle.
- Stripe et PayPal affichent un code après l'enregistrement. Stripe l'appelle le secret de signature (il commence par
whsec_). PayPal l'appelle le Webhook ID. Copiez-le et collez-le dans le champ correspondant dans Keynate. - Cliquez sur Tester la connexion.
Bon à savoir
- Le mode test et le mode réel ont chacun besoin de leur propre webhook.
- Si vous perdez le secret, créez un nouveau webhook dans la passerelle et collez le nouveau code.
Problèmes fréquents
- « Collez le secret du webhook saisi dans Razorpay. » Le champ dans Keynate est vide. Collez le même secret que celui fourni à Razorpay.
- « Utilisez un secret de webhook différent pour le test et le réel. » Créez un nouveau secret pour le second mode.
- « Collez le secret de signature du webhook. Il commence par whsec_. » Copiez-le depuis Stripe après avoir ajouté l'endpoint.
- « Collez le Webhook ID (lettres et chiffres uniquement). » Copiez l'ID depuis la liste des webhooks de votre compte PayPal.
- Razorpay affiche toujours « En attente du premier message de Razorpay… ». Effectuez un petit paiement de test. Le message arrive après le premier paiement. Cliquez ensuite sur Vérifier maintenant.
- Une commande reste impayée alors que le lecteur a payé. Le webhook est manquant ou incorrect. Chaque nuit, Keynate compare vos commandes avec votre passerelle et régularise celles qui ont été manquées.
Questions
Questions fréquemment posées
Est-ce la même chose qu'une clé API ?
Non. Les clés permettent à Keynate de communiquer avec la passerelle. Le webhook permet à la passerelle de répondre à Keynate.
Faut-il un webhook pour le mode test et le mode réel ?
Oui. Le mode test et le mode réel ont chacun besoin du leur.
Que faire si je perds le secret ?
Ajoutez un nouveau webhook dans la passerelle et collez le nouveau code dans Keynate.
Que faire si une commande reste impayée alors que le lecteur a payé ?
Le webhook est manquant ou incorrect. Chaque nuit, Keynate compare vos commandes avec votre passerelle et régularise celles qui ont été manquées.