Aller au contenu principal

Connecter Paystack

Paystack permet d'encaisser des paiements par carte et des paiements locaux pour les entreprises de cinq pays. Si votre entreprise se trouve dans l'un d'eux, vous connectez votre propre compte Paystack, et vos clients paient directement sur votre solde Paystack, dans la devise de votre pays.

Votre paysLes clients paient enMoyens de paiement possibles
Afrique du SudZARcarte, Apple Pay, Capitec Pay et virement EFT
NigeriaNGNcarte, virement bancaire, USSD et Apple Pay
GhanaGHScarte, mobile money et virement bancaire
KenyaKEScarte, M-PESA, Airtel Money et virement bancaire
Côte d'IvoireXOFcarte, mobile money et Apple Pay

Les moyens de paiement que vos clients voient dépendent des canaux de paiement activés dans votre compte Paystack. En Côte d'Ivoire, Paystack ouvre les comptes via son inscription en accès anticipé.

Si votre entreprise est située ailleurs, utilisez plutôt Stripe.


Avant de commencer​

  • Le pays de votre entreprise EquipDash doit être l'un des cinq pays ci-dessus. Vous le définissez sous Paramètres -> Informations sur l'entreprise.
  • Votre devise sous Paramètres -> Localisation doit être celle de votre pays, indiquée dans le tableau. Par exemple, si une boutique nigériane affiche ses prix en USD, un avertissement apparaît sur la carte Paystack et les clients ne peuvent pas payer par carte tant que la devise n'est pas le NGN.
  • Il vous faut un compte Paystack pour votre entreprise. Vous pouvez en créer un sur paystack.com -- c'est gratuit.
  • Vous devrez trouver votre clé secrète et votre clé publique dans le tableau de bord Paystack (nous vous montrons où).

Une boutique kényane aux prix en AUD voit un avertissement sur la carte Paystack

Si vous avez déjà reçu des réservations, votre devise est verrouillée. L'avertissement contient alors un lien vers un ticket d'assistance, afin que nous puissions la modifier pour vous.


Étape 1 -- Trouver vos clés Paystack​

  1. Connectez-vous à votre tableau de bord Paystack.
  2. Dans la barre latérale gauche, cliquez sur Settings.
  3. Sélectionnez l'onglet API Keys & Webhooks.
  4. Vous verrez quatre clés : une Test Secret Key et une Test Public Key (pour les essais), ainsi qu'une Live Secret Key et une Live Public Key (pour les vrais paiements de vos clients).
  5. Décidez si vous voulez d'abord faire un essai (recommandé) ou passer directement en mode réel.
  6. Copiez la Secret Key (elle commence par sk_test_ en mode test ou sk_live_ en mode réel) et la Public Key (elle commence par pk_test_ ou pk_live_).

Important : gardez votre clé secrète confidentielle. Traitez-la comme un mot de passe -- ne la partagez jamais et ne la publiez nulle part.


Étape 2 -- Connecter Paystack dans EquipDash​

  1. Dans EquipDash, cliquez sur Paramètres dans la barre latérale.
  2. Sélectionnez Paiements dans le menu des paramètres.
  3. Dans la section Connexion Paystack, en haut de la page, vous verrez une carte intitulée Paystack avec un bouton Connecter Paystack. Cliquez dessus.

La page des paramètres de paiement avec la carte Paystack et le bouton Connecter Paystack

  1. Collez votre Clé secrète et votre Clé publique dans les champs qui s'affichent.
  2. Cliquez sur Enregistrer et connecter.

La fenêtre Connecter Paystack avec les champs Clé secrète et Clé publique

EquipDash effectue une rapide vérification de connexion auprès de Paystack pour s'assurer que les clés sont valides. Si c'est le cas, un message de confirmation s'affiche et la carte Paystack passe à « Connecté ».

Si les clés sont incorrectes ou expirées, EquipDash affiche le message d'erreur renvoyé par Paystack. Copiez alors une nouvelle paire de clés depuis le tableau de bord et réessayez.


Les webhooks permettent à Paystack d'informer EquipDash qu'un remboursement a été réglé. Sans eux, les paiements fonctionnent quand même, mais les remboursements restent « en attente » tant que vous ne les marquez pas manuellement.

Après votre premier paiement Paystack, EquipDash affiche une bannière jaune Action requise : configurez l'URL de votre webhook si Paystack ne nous a pas encore envoyé de webhook. C'est le signal pour terminer cette étape.

La carte Paystack connectée avec l'URL du webhook et le rappel Action requise

  1. Copiez l'URL du webhook affichée sur la carte Paystack dans EquipDash.
  2. Dans votre tableau de bord Paystack, allez dans Settings -> API Keys & Webhooks.
  3. Faites défiler la page jusqu'à la section Webhooks.
  4. Collez l'URL dans le champ Test Webhook URL (ou Live Webhook URL, selon les clés que vous avez connectées).
  5. Cliquez sur Save Changes.

Paystack envoie désormais une notification à EquipDash chaque fois qu'un paiement réussit ou échoue, ou qu'un remboursement est traité. La bannière jaune d'EquipDash disparaît automatiquement dès que nous avons reçu le premier webhook valide de votre compte.


Après la connexion​

Une fois Paystack connecté :

  • Les paiements en ligne sont activés pour votre widget de réservation. Vos clients voient la fenêtre Paystack au moment du paiement.
  • Les remboursements peuvent être effectués depuis la page de détail de la réservation. Ils reviennent au client par Paystack, dans la devise avec laquelle il a payé, et arrivent en 3 à 10 jours ouvrés. Au Kenya, Paystack rembourse un paiement M-PESA par l'intermédiaire de son équipe d'assistance, et non automatiquement : si le remboursement d'un paiement M-PESA échoue, écrivez à support@paystack.com en indiquant la référence du paiement, le montant et la date.
  • Les liens de paiement fonctionnent. Envoyez-en un depuis une réservation (Ajouter un paiement -> Lien de paiement) et le client le règle dans la fenêtre de paiement Paystack. Voir Liens de paiement ci-dessous.
  • Les fonds sont versés directement sur votre solde Paystack, selon le calendrier de versement habituel de Paystack -- EquipDash ne détient jamais votre argent.
  • Frais de traitement. Si vous répercutez les frais de carte sur vos clients, EquipDash démarre avec le tarif local publié par Paystack pour les cartes de votre pays : 2,9 % + 1 R en Afrique du Sud, 1,5 % + 100 NGN au Nigeria, 1,95 % au Ghana, 2,9 % au Kenya et 3,2 % en Côte d'Ivoire. Modifiez-le sous Paramètres -> Paiements -> Frais de traitement si votre tarif Paystack est différent.

Sur une réservation, cliquez sur Ajouter un paiement, choisissez Lien de paiement, vérifiez le montant, puis cliquez sur Créer le lien de paiement. EquipDash envoie le lien par e-mail au client, et vous pouvez aussi le copier pour l'envoyer par SMS.

La page de lien de paiement que voit un client d'une boutique Paystack, avec le bouton Payer

Quand le client ouvre le lien et clique sur Payer, la fenêtre de paiement Paystack s'ouvre. Dès que Paystack confirme le paiement, le lien apparaît comme payé et le paiement s'affiche sur la réservation. Si le client ferme la page avant la confirmation, le paiement arrive quand même sur la réservation dès que Paystack envoie son webhook (étape 3).

Pour envoyer les liens automatiquement avant chaque réservation, choisissez Envoyer automatiquement le lien de paiement avant la réservation sous Paramètres -> Paiements -> Paramètres du paiement en ligne.

Paystack ne peut pas bloquer un montant sur une carte, dans aucun de ses pays. Un dépôt de garantie réglé par lien est donc débité, et vous le remboursez après le retour du matériel : ouvrez la réservation et cliquez sur Rembourser le dépôt dans la carte de paiement. Vous pouvez en garder une partie pour couvrir des dommages et rembourser le reste. Le remboursement revient sur la carte du client par Paystack.


Passer de Stripe à Paystack​

Si vous avez accès à la fois à Stripe et à Paystack, les options Choisissez votre processeur de paiement de la section Frais de traitement vous permettent de choisir celui qui gère le paiement de votre widget. Un seul est actif à la fois. (Ce choix n'apparaît que tant qu'aucun processeur n'est connecté. Une fois qu'un processeur est connecté, vous devez d'abord le déconnecter pour changer.)

Pour choisir un processeur, changez le bouton radio et cliquez sur Mettre à jour.


Déconnecter Paystack​

  1. Allez dans Paramètres -> Paiements.
  2. Repérez la carte Paystack et cliquez sur Déconnecter.
  3. Confirmez l'action.

Vos clés enregistrées sont supprimées. Les réservations déjà payées par Paystack ne sont pas touchées : l'historique des paiements est conservé. Pour accepter de nouveaux paiements en ligne après la déconnexion, connectez un autre prestataire.


Dépannage​

ProblèmeSolution
« Paystack rejected the connectivity probe » à l'enregistrement des clésVérifiez que vous avez copié la clé en entier, y compris le préfixe sk_test_ / sk_live_. Assurez-vous que les deux clés viennent du même mode (toutes deux en test, ou toutes deux en réel).
Le paiement du client a réussi, mais la réservation n'apparaît pasVérifiez que l'URL du webhook dans votre tableau de bord Paystack est bien https://app.equipdash.com/paystack/webhook. Si le client a fermé la fenêtre avant la confirmation, contactez l'assistance en indiquant la référence Paystack.
Un lien de paiement affiche « This payment link is not available »Le lien a été envoyé alors que Paystack utilisait des clés de test, et vous êtes passé depuis aux clés réelles (ou l'inverse). Envoyez un nouveau lien.
Les remboursements restent « en attente »Le remboursement est réglé quand Paystack envoie le webhook refund.processed. Vérifiez que l'URL du webhook est configurée (étape 3) et que les envois récents de webhooks réussissent dans le tableau de bord Paystack.
Je veux utiliser un autre compte PaystackCliquez sur Déconnecter, puis reconnectez-vous avec les nouvelles clés.

Questions fréquentes​

EquipDash prélève-t-il une commission sur les paiements Paystack ?

Non. Les réservations payées par Paystack sont entièrement versées sur votre solde Paystack. Votre abonnement EquipDash continue d'être facturé séparément via Stripe.

Puis-je utiliser Paystack en dehors de ces cinq pays ?

Pas pour l'instant. Paystack ouvre des comptes pour les entreprises d'Afrique du Sud, du Nigeria, du Ghana, du Kenya et de Côte d'Ivoire. Si Paystack s'ouvre dans votre pays, contactez-nous et nous étudierons son ajout.

Puis-je encaisser des paiements en dollars américains ?

Non. Les comptes Paystack du Nigeria et du Kenya ne peuvent accepter l'USD qu'une fois que Paystack l'a activé pour le compte. EquipDash encaisse donc dans la devise de votre pays.

Puis-je utiliser Stripe et Paystack en même temps ?

Vous pouvez connecter les deux, mais un seul est actif à la fois pour le widget. Le sélecteur Choisissez votre processeur de paiement de la section Frais de traitement détermine celui que voient les nouveaux clients au moment du paiement.

Mes clients verront-ils « Paystack » ou « EquipDash » sur leur relevé ?

C'est le nom de votre entreprise (tel qu'il apparaît sur votre compte Paystack) que vos clients voient sur leur relevé de carte, et non EquipDash.