Payfast est une passerelle de paiement sud-africaine qui permet à votre organisation d'accepter des dons en Rand sud-africain, par carte bancaire, virement bancaire instantané, codes QR, Mobicred et plus d'une douzaine d'autres méthodes déjà utilisées par les donateurs sud-africains.
Ce guide vous accompagne dans l'installation du module complémentaire, l'activation de la passerelle, la définition de votre devise sur Rand, l'ajout de vos identifiants marchand, les tests en bac à sable et la mise en production.
Ce que contient ce guide ?
Avant de commencer
- L'intégration de paiement Payfast est disponible dans les plans Basic et supérieurs du plugin Charitable Pro. Si vous n'êtes pas encore sur Pro, vous pouvez créer votre compte maintenant » Voici un guide pour vous aider à installer Charitable Pro »
- Ensuite, vous devrez installer le module complémentaire Charitable Payfast. Nous vous montrerons comment faire ensuite. Le module complémentaire Payfast est inclus avec le plugin Charitable Pro. Après avoir acheté un plan, vous pouvez l'installer, ainsi que tout autre module complémentaire inclus, depuis le menu des modules complémentaires sans frais supplémentaires.
- Vous aurez besoin de votre propre compte marchand Payfast avant de commencer. Si vous n'en avez pas encore un, inscrivez-vous sur payfast.io.
Payfast est conçu pour le marché sud-africain et règle sur des comptes bancaires sud-africains. Charitable se connecte à votre propre compte Payfast, de sorte que les détails de vos donateurs et vos transactions restent entre vous et Payfast.
Payfast ne facture aucun frais d'installation ni frais mensuels. Vous payez par transaction, et le taux dépend de la méthode choisie par votre donateur. Consultez payfast.io pour connaître les tarifs actuels.
Le module complémentaire nécessite Charitable 1.3 ou supérieur et PHP 5.3 ou supérieur. Toute version actuellement prise en charge de PHP est largement supérieure à ce minimum.
Commençons.
Installation du module complémentaire Payfast
Allez dans Charitable » Modules complémentaires et trouvez Payfast dans la liste. Cliquez sur « Installer le module complémentaire », puis sur « Activer » une fois l'installation terminée.
Si vous préférez installer à partir d'un fichier zip, vous pouvez télécharger le module complémentaire et l'installer vous-même.
- Dans votre compte Charitable, allez dans l'onglet Téléchargements et faites défiler jusqu'au module complémentaire Payfast. Téléchargez le module complémentaire ici.
- Dans votre tableau de bord WordPress, allez dans Plugins » Ajouter un nouveau » Téléverser un plugin.
- Choisissez le fichier zip, cliquez sur « Installer maintenant », puis sur « Activer l'extension ».
Si vous n'êtes pas sûr de la manière d'installer le module complémentaire Payfast, nous vous recommandons d'abord de lire notre guide sur l'installation des extensions Charitable »
Activation de la passerelle
Allez dans Charitable » Paramètres » Passerelles de paiement. Vous verrez Payfast listé avec les autres passerelles. Activez son interrupteur, puis cliquez sur « Enregistrer les modifications ».
Un bouton vert « Paramètres » apparaîtra à côté de Payfast. C'est là que vous ajouterez vos identifiants marchand dans un instant.
Remarque : L'interrupteur « Activer le mode test » en bas de cette même page est ce que vous utiliserez plus tard pour tester Payfast avant la mise en production.
Définir votre devise sur Rand
Payfast règle en Rand sud-africain, donc le Rand doit être votre devise de base dans Charitable. Une fois la passerelle activée, Charitable vérifie cela pour vous et affiche un avis si votre devise est définie sur autre chose.
Cliquez sur « Changer maintenant » et la devise est définie pour vous. Vous n’avez rien d’autre à faire. Vous pouvez le confirmer sous Charitable » Paramètres » Général » Configuration, où le menu déroulant des devises affichera le Rand sud-africain (R).
Remarque : Le fait que le Rand soit votre devise de base n’empêche pas les donateurs internationaux de donner. La fonctionnalité Multi-Currency Pricing de Payfast permet à un donateur de choisir sa propre devise lors du paiement sur Payfast, et Payfast la convertit et vous paie en Rand. Cela fonctionne avec Visa et Mastercard, mais pas avec American Express. Activez-la depuis votre compte Payfast, pas depuis Charitable.
Ajouter vos identifiants Payfast
Cliquez sur le bouton vert « Paramètres » à côté de Payfast pour ouvrir les paramètres de la passerelle. Vous trouverez les 3 identifiants dans la zone des paramètres de votre compte Payfast.
- Libellé de la passerelle est le nom que les donateurs lisent sur votre formulaire de don. Laissez-le tel quel « Payfast », ou changez-le pour quelque chose que vos supporters reconnaîtront.
- Identifiant marchand est votre identifiant marchand Payfast.
- Clé marchand est la clé associée à cet identifiant marchand.
- Phrase de passe est la valeur que Payfast utilise pour signer la requête. Définissez la même phrase de passe dans votre compte Payfast et dans Charitable, sinon vos dons seront rejetés. Les anciens guides l'appellent le sel.
Cliquez sur « Enregistrer les modifications » lorsque vous avez terminé.
Important : Si vous effectuez des tests, utilisez ces détails depuis sandbox.payfast.co.za plutôt que depuis votre compte Payfast réel. Les identifiants sandbox et réels ne sont pas interchangeables.
Vidéo de configuration
Ce court tutoriel couvre l'installation du module complémentaire, l'ajout de vos identifiants Payfast et la réception d'un don.
Méthodes de paiement disponibles avec Payfast
Payfast offre à vos donateurs un large éventail d'options de paiement populaires en Afrique du Sud, y compris les suivantes.
- Paiements par carte (Visa, Mastercard)
- Cartes de débit (Maestro, Visa Electron)
- EFT instantané
- SiD Secure EFT
- Paiements par code QR
- Apple Pay
- Google Pay
- Samsung Pay
- Capitec Pay
- Absa Pay
- Mobicred
- MoreTyme (par TymeBank)
- Payflex
- MukuruPay
- MTN MoMoPay
- SnapScan
- Zapper
- Scan to Pay
- SCode
- Cartes de magasin (RCS)
- PayPal
Remarque : Les méthodes de paiement changent de temps en temps, et celles que vous pouvez proposer dépendent de ce qui est activé sur votre propre compte Payfast. Consultez la page des méthodes de paiement de Payfast pour la liste actuelle.
Accepter les dons récurrents avec Payfast
Payfast fonctionne avec la fonctionnalité de Dons récurrents de Charitable, de sorte qu'un donateur peut configurer un don répété une fois et Charitable facture chaque renouvellement par la suite. Dons récurrents est disponible sur les plans Plus et supérieurs, tandis que la passerelle Payfast commence sur Basic. Ainsi, sur un plan Basic, vous pouvez accepter des dons Payfast ponctuels mais pas récurrents.
Tests avant la mise en ligne
Nous recommandons toujours de tester une nouvelle passerelle avant d'accepter de vrais dons. Payfast dispose d'un environnement sandbox séparé, donc tester signifie utiliser les identifiants sandbox plutôt que vos identifiants réels.
- Connectez-vous sur sandbox.payfast.co.za et récupérez-y l'Identifiant marchand, la Clé marchand et la Phrase de passe.
- Allez dans Charitable » Paramètres » Passerelles de paiement et activez « Activer le mode test » en bas de la page. Cliquez sur « Enregistrer les modifications ».
- Ouvrez les paramètres de votre passerelle Payfast, collez les identifiants sandbox et cliquez sur « Enregistrer les modifications ».
- Effectuez un don sur votre propre site web et choisissez Payfast comme méthode de paiement. Vous serez redirigé vers la page de paiement hébergée par Payfast.
- Une fois que vous avez terminé, vous revenez sur votre site web. Allez dans Charitable » Donations et vérifiez que le don est présent et marqué comme Payé.
- Lorsque le don de test semble correct, désactivez le mode test, remplacez les identifiants sandbox par vos identifiants réels, et cliquez à nouveau sur « Enregistrer les modifications ».
Important : Vos dons de test ont été effectués sur un compte Payfast différent, alors supprimez-les de Charitable » Donations avant de passer en production si vous ne souhaitez pas qu'ils apparaissent dans vos rapports.
Faire de Payfast la passerelle par défaut
Si vous avez plusieurs passerelles activées, la passerelle par défaut est celle sélectionnée pour vos donateurs lorsque votre formulaire de don se charge. Allez dans Charitable » Paramètres » Passerelles de paiement, choisissez Payfast dans la colonne « Défaut », et cliquez sur « Enregistrer les modifications ».
Astuce de pro : Si la plupart de vos donateurs sont en Afrique du Sud, faire de Payfast la passerelle par défaut leur présente immédiatement les options Instant EFT et les cartes locales, plutôt que de les laisser les chercher dans une liste.
Sécurité et données des donateurs
Chaque don Payfast est effectué sur un formulaire de paiement conforme PCI hébergé sur le site web de Payfast. Les donateurs y accèdent après avoir soumis votre formulaire de don, et les numéros de carte ne touchent jamais votre site web ni votre base de données.
Payfast est un nom que les donateurs sud-africains reconnaissent, ce qui signifie qu'ils peuvent donner sans craindre de savoir qui gère leurs informations de carte.
FAQ sur Payfast
Ai-je besoin de mon propre compte Payfast pour utiliser ce module complémentaire ?
Oui. Le module complémentaire se connecte à un compte marchand que vous ouvrez directement auprès de Payfast. Si vous n'en avez pas encore, inscrivez-vous sur payfast.io avant de commencer.
Quelle devise dois-je utiliser ?
Rand sud-africain. Payfast règle en Rand, donc le Rand est votre devise de base dans Charitable. Lorsque vous activez la passerelle, Charitable affiche une notification avec un bouton « Changer maintenant » qui la configure pour vous.
Les donateurs internationaux peuvent-ils donner dans leur propre devise ?
Oui, grâce à la fonctionnalité Multi-Currency Pricing de Payfast. Votre donateur choisit sa devise lors du paiement sur Payfast, voit le montant converti, et Payfast vous paie en Rand. Cela couvre Visa et Mastercard mais pas American Express, et vous l'activez dans votre compte Payfast plutôt que dans Charitable.
Où trouver mon ID marchand, ma clé marchand et ma phrase secrète ?
Les 3 proviennent de la zone de paramètres de votre compte Payfast. L'ID marchand et la clé marchand identifient votre compte. La phrase secrète est utilisée pour signer chaque requête, et elle doit correspondre des deux côtés, donc définissez la même valeur dans Payfast et dans Charitable. Les anciens guides l'appellent le sel.
Où les donateurs saisissent-ils les détails de leur carte ?
Sur un formulaire de paiement conforme PCI hébergé par Payfast, auquel les donateurs accèdent après avoir soumis votre formulaire de don. Les numéros de carte n'atteignent jamais votre site web ni votre base de données.
Quel plan me faut-il pour Payfast ?
Basic et supérieur. Les dons récurrents via Payfast nécessitent la fonctionnalité Dons récurrents, qui commence avec le plan Plus.
Quels sont les frais de Payfast ?
Il n'y a pas de frais d'installation ni de frais mensuels. Payfast facture par transaction, et le taux dépend de la méthode de paiement choisie par votre donateur. Consultez payfast.io pour les tarifs actuels.
Comment tester Payfast sans prendre d'argent réel ?
Utilisez le bac à sable Payfast sur sandbox.payfast.co.za. Il délivre son propre identifiant marchand, sa clé marchand et sa phrase secrète, distincts de votre compte réel. Entrez-les dans Charitable avec l'option « Activer le mode test » activée.
Mes donateurs atteignent Payfast mais le don ne revient jamais comme Payé. Que dois-je vérifier ?
Vérifiez d'abord la phrase secrète, car une phrase secrète définie dans Payfast mais pas dans Charitable, ou vice versa, est la cause la plus fréquente. Confirmez ensuite que votre identifiant marchand et votre clé marchand proviennent du même compte et du même mode, car un identifiant marchand réel associé à une clé de bac à sable échouera.
