Configurer un prestataire de paiement

Où

Paramètres → Passerelles de paiement

Forfait

Tous les forfaits

Permission

Payments → Gateway Config

Rien dans le menu Paiements ne peut encaisser tant qu’un prestataire n’est pas configuré ici. Déroutant : cet écran n’est pas dans le menu Paiements — il se trouve dans les Paramètres.

Trois prestataires sont pris en charge : Paystack, Hubtel et PaySwitch (l’API theTeller).

Aucun forfait n’est requis

Contrairement au menu Paiements, cet écran n’exige que la permission. Il n’y a aucun verrou de forfait dessus.

Avant de commencer

Gardez le tableau de bord de votre prestataire ouvert. Vous allez y copier des clés.

• Paystack — votre clé secrète, depuis Settings → API Keys & Webhooks. Elle commence par sk_live_ ou sk_test_.
• Hubtel — votre identifiant client API et votre secret client, ainsi que votre numéro de compte marchand.
• PaySwitch — votre utilisateur API et votre clé API, ainsi que votre ID marchand.

Ajouter un prestataire

1. Allez dans Paramètres, choisissez Passerelles de paiement, puis cliquez sur la ligne Passerelles de paiement à l’intérieur. (Oui — deux fois.)
2. Cliquez sur Nouvelle passerelle.
3. Choisissez la Passerelle — Paystack, Hubtel ou PaySwitch. Cela ne pourra plus jamais être modifié.
4. Saisissez un Nom affiché, n’importe quelle étiquette qui vous aide à la reconnaître.
5. Laissez l’Objet sur Encaissement marchand. Également définitif — et voyez l’avertissement sur Facturation plus bas.
6. Laissez Activé sur Oui.
7. Ne touchez pas à la Priorité, sauf si vous avez deux fois le même prestataire.
8. Sous Identifiants, remplissez les cases de votre prestataire :
   • Paystack — Clé secrète, et éventuellement Clé publique.
   • Hubtel — Nom d’utilisateur, Mot de passe, ID marchand.
   • PaySwitch — Nom d’utilisateur, Mot de passe, ID marchand, et Réseau.
9. Saisissez un Secret du webhook si votre prestataire en délivre un. Lisez d’abord la section plus bas — il fait moins que son nom ne le laisse croire.
10. Laissez Config brute (avancé) vide.
11. Cliquez sur enregistrer. Vous obtenez « Passerelle enregistrée ».

L’en-tête vous avertit à juste titre : « Les clés de votre prestataire sont chiffrées au repos et ne sont plus jamais affichées après l’enregistrement. »

Il n’y a aucun moyen de tester que vos clés sont bonnes

Pas de bouton de test, pas de vérification, rien. Enregistrer prouve seulement que le formulaire a été rempli.

La colonne Identifiants affiche alors un badge vert Défini — ce qui veut dire une valeur est stockée, pas une valeur qui marche. Une clé complètement fausse affiche Défini. Vous le découvrez quand le paiement d’un vrai client échoue.

Faites le premier paiement vous-même, pour un petit montant, avant de laisser des clients s’en approcher.

Rien ne vérifie que vous avez rempli les bonnes cases

Le formulaire accepte qu’une seule case d’identifiant soit remplie. Une entrée Paystack enregistrée avec seulement la clé publique, ou une entrée Hubtel avec seulement un ID marchand, s’enregistre sans broncher et affiche Défini.

Vérifiez chaque case de votre prestataire avant d’enregistrer.

L’URL de rappel dont personne ne vous parle

Il faut indiquer à votre prestataire où prévenir SaleSprint quand un paiement aboutit.

L’écran ne vous montre jamais cette URL, et vous ne pouvez pas la deviner depuis lui

L’adresse dont votre prestataire a besoin est :

https://<votre adresse SaleSprint>/api/v1/webhooks/payments/<provider>?tenant=<id de votre espace de travail>

où <provider> vaut exactement paystack, hubtel ou payswitch.

L’identifiant d’espace de travail à la fin est obligatoire — sans lui, la notification est rejetée purement et simplement. Et cet écran n’affiche ni l’URL ni votre identifiant d’espace de travail nulle part.

Demandez l’URL exacte à qui assure votre support SaleSprint, puis collez-la dans le tableau de bord de votre prestataire.

Sans le rappel, les paiements ne sont pas perdus — SaleSprint revérifie les encaissements en attente auprès du prestataire toutes les quelques minutes et se rattrape. Mais l’argent reste affiché en attente plus longtemps qu’il ne le devrait.

La case Secret du webhook

Ce qu’elle fait dépend entièrement du prestataire que vous avez choisi, et ce n’est pas ce que suggère le texte d’aide (« Sert à vérifier les signatures des webhooks entrants »).

Prestataire	Ce que fait le Secret du webhook
Paystack	Rien. Les notifications Paystack sont vérifiées avec votre clé secrète à la place. Laissez la case vide.
Hubtel	Comparé à la valeur portée par la notification.
PaySwitch	Pareil.

Laissez-la vide sur Hubtel ou PaySwitch et les notifications sont acceptées sans contrôle

Sans secret stocké, SaleSprint accepte n’importe quelle notification arrivant sur votre URL de rappel. C’est délibéré — il revérifie ensuite le paiement directement auprès du prestataire avant de le traiter comme réel, une fausse notification ne peut donc pas inventer de l’argent.

Cela reste une position plus faible que nécessaire. Si Hubtel ou PaySwitch vous donnent un secret, saisissez-le.

Un secret de webhook peut être remplacé mais jamais retiré

Vider la case conserve ce qui est stocké. Il en va de même pour les Remarques.

Quelle configuration est réellement utilisée

Une bannière au-dessus du tableau vous indique l’une de ces deux choses :

• « Votre propre configuration Paystack est actuellement active. »
• « Utilisation de la passerelle par défaut de la plateforme (Paystack). »

La seconde signifie que vous n’avez rien configuré et que SaleSprint se rabat sur un prestataire configuré par votre opérateur.

Aucune bannière du tout signifie que rien n’est configuré

Si ni votre propre configuration ni une valeur par défaut de la plateforme ne se résout, la bannière n’apparaît tout simplement pas. Rien ne vous avertit que l’encaissement va échouer. Un espace vide là où devrait être la bannière est le seul signe.

La liste

Les colonnes sont Nom affiché, Passerelle, Objet, Priorité, Activé et Identifiants. Les actions de ligne sont Modifier et Supprimer.

La suppression vous avertit : « Cela retire votre remplacement et revient à la valeur par défaut de la plateforme. » S’il n’y a pas de valeur par défaut de la plateforme, l’encaissement cesse de fonctionner à la place — rien ne le dit.

Changer les clés plus tard

Ressaisir une seule clé efface les autres

Sur le formulaire de modification, toutes les cases d’identifiants sont vides, avec l’aide « Configuré — laissez vide pour conserver la valeur actuelle. » C’est vrai case par case, mais trompeur dans l’ensemble : saisir dans une seule case remplace tout le jeu stocké, et les cases que vous avez laissées vides sont perdues.

Lorsque vous changez une clé, ressaisissez tous les identifiants de ce prestataire, et pas seulement celui qui a changé.

La Passerelle et l’Objet ne peuvent pas être modifiés du tout. Une erreur sur l’un ou l’autre oblige à supprimer l’entrée et à la recréer.

Deux choses à éviter

Ne choisissez pas Objet = Facturation

C’est proposé dans la liste, cela s’enregistre, et cela affiche un badge vert Défini — et ce n’est jamais utilisé. La facturation de votre abonnement SaleSprint passe par le prestataire de votre opérateur, pas par le vôtre. Laissez toujours sur Encaissement marchand.

La case Réseau de PaySwitch ne fait rien

Tout ce que vous saisissez est jeté, et PaySwitch retombe toujours sur MTN. L’exemple du texte d’aide (mtn, vodafone) n’est même pas au bon format — les codes sont MTN, VDF et ATL.

Si vous avez besoin d’un autre réseau, cela doit passer par Config brute (avancé), ce qui implique d’écrire les réglages à la main sous forme de bloc de code. Demandez de l’aide plutôt que de deviner.

La priorité ne fait pas ce qu’elle annonce

« Les nombres les plus bas sont essayés en premier » ne vaut qu’entre deux entrées du même prestataire. Entre prestataires différents, celui qui est choisi est simplement le premier par ordre alphabétique — Hubtel avant Paystack avant PaySwitch — quelles que soient les priorités que vous fixez.

Voir aussi

• Aperçu des paiements
• Encaisser des paiements
• Être payé en ligne — les liens de paiement sur les factures, et ce que voit le client
• Dépannage des factures et des paiements en ligne