PayFast

Intégration PayFast

PayFast est une passerelle de paiement sud-africaine. Le plugin Post Affiliate Pro la relie à votre programme d’affiliation. Après chaque paiement, PayFast envoie une notification instantanée de transaction (ITN) à votre installation de Post Affiliate Pro, et le plugin enregistre la vente pour l’affilié qui a recommandé le client. Lorsque le paiement fait partie d’un abonnement PayFast, le plugin enregistre à la place un paiement récurrent.

Comment intégrer Post Affiliate Pro à PayFast

Activation du plugin

Dans votre panneau marchand, allez dans Configuration > Plugins > PayFast ITN handling > Activer. Après l’activation, configurez au minimum le plugin avec les éléments suivants :

• Champ de chaîne personnalisé : le champ personnalisé PayFast (custom_str1 à custom_str5) qui transporte la valeur de suivi depuis votre formulaire de paiement. Par défaut, il s’agit de custom_str1. Toutes les autres options sont décrites dans la section consacrée aux paramètres du plugin, plus bas.
• Phrase secrète de signature : utilisez la même phrase secrète que dans la section Paramètres de votre tableau de bord PayFast. PayFast exige que la phrase secrète de votre compte et celle de votre site soient identiques.

Intégration du formulaire de paiement

Pour suivre l’affilié qui a recommandé le client, le formulaire de paiement doit transmettre la valeur de suivi à PayFast, et PayFast doit envoyer la notification à Post Affiliate Pro. Ajoutez ces éléments à votre formulaire de paiement PayFast :

<input type="hidden" name="custom_str1" value="" id="pap_dx8vc2s5" />
<input type="hidden" name="notify_url" value="https://URL_TO_PostAffiliatePro/plugins/PayFast/payfast.php" />
<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/notifysale.php" type="text/javascript">
</script>

Rappelez-vous : si vous utilisez déjà custom_str1 pour autre chose, utilisez une autre chaîne personnalisée et sélectionnez cette même chaîne dans la configuration du plugin.

Remarque : Si vous avez plus d’un formulaire de paiement sur une page, vous pouvez placer la partie <script> une seule fois sur l’ensemble de la page. Chaque formulaire de paiement n’a besoin que des parties <input>.

Exemple

Voici un exemple de formulaire de paiement avec le code d’intégration ajouté :

<form action="https://www.payfast.co.za/eng/process" method="post">
  <input type="hidden" name="merchant_id" value="YOUR_MERCHANT_ID" />
  <input type="hidden" name="merchant_key" value="YOUR_MERCHANT_KEY" />
  <input type="hidden" name="amount" value="100.00" />
  <input type="hidden" name="item_name" value="Product 1" />

<input type="hidden" name="custom_str1" value="" id="pap_dx8vc2s5" />
<input type="hidden" name="notify_url" value="https://URL_TO_PostAffiliatePro/plugins/PayFast/payfast.php" />
<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/notifysale.php" type="text/javascript">
</script>

  <input type="submit" value="Pay now" />
</form>

N’oubliez pas d’intégrer votre site au code de suivi des clics .

Abonnements

Pour les abonnements PayFast, PayFast envoie une notification pour chaque paiement, accompagnée d’un jeton d’abonnement. Le plugin reconnaît ce jeton et enregistre le paiement comme un paiement récurrent, en utilisant le jeton comme ID de commande. Pour que cela fonctionne dans PayFast, une phrase secrète doit être définie et la facturation récurrente activée sur votre compte PayFast. Pour savoir comment les commissions récurrentes se configurent côté Post Affiliate Pro, consultez la page dédiée.

Paramètres du plugin

Le plugin propose les options suivantes :

• Champ de chaîne personnalisé : le champ personnalisé PayFast qui transporte la valeur de suivi. Par défaut : custom_str1.
• Phrase secrète de signature : la phrase secrète de votre tableau de bord PayFast.
• Utiliser l’ID de commande PayFast : par défaut, le plugin utilise l’identifiant unique de paiement défini par votre système (m_payment_id) comme ID de commande. Cochez cette case pour utiliser plutôt l’identifiant de paiement PayFast.
• Déduire les frais : activé par défaut. La commission est calculée sur le montant net, après les frais de PayFast. Désactivez cette option pour utiliser le montant brut.
• Enregistrer un nouvel affilié à chaque événement : crée un nouvel affilié à partir du nom et de l’e-mail du client figurant dans le paiement.
• Enregistrer l’affilié à l’achat de ces produits : limite l’enregistrement ci-dessus à des produits précis. Laissez ce champ vide pour enregistrer un affilié à chaque achat, ou saisissez les noms de produits séparés par un point-virgule, par exemple produit1;produit parfait;produit3. Le nom du produit est le nom d’article envoyé à PayFast.
• Approuver l’affilié après un paiement réussi : un affilié en attente dont l’e-mail correspond à celui du client qui paie est approuvé après un paiement réussi.
• Utiliser le total récurrent de la notification : pour les commissions récurrentes, utilise le montant de chaque notification PayFast au lieu du montant du paiement initial.
• Données supplémentaires 1 à 5 : enregistre un détail de la notification dans les champs de données supplémentaires de la vente. Vous pouvez choisir l’e-mail, le numéro de téléphone, le nom, le prénom ou le nom de famille du client, le nom ou la description de l’article, ou encore l’ID de transaction PayFast. Le champ Données supplémentaires 1 est défini par défaut sur l’e-mail du client.
• Renvoyer l’IPN à l’URL : transmet la notification PayFast à une autre adresse, par exemple à un autre système qui utilise également l’ITN. L’adresse doit être une URL valide avec le protocole, et elle ne peut pas pointer vers la même installation de Post Affiliate Pro.

Fonctionnement exact du plugin

Lorsque PayFast envoie une notification à l’adresse du plugin, le plugin :

1. Lit le paiement : le montant, l’ID du paiement, l’e-mail et le nom du client, le nom de l’article et la valeur de suivi issue de votre champ de chaîne personnalisé.
2. Vérifie le statut du paiement. Seul le statut COMPLETE est traité ; tout autre statut est ignoré.
3. Retrouve l’affilié à partir de la valeur de suivi et, si ces options sont activées, enregistre un nouvel affilié ou approuve un affilié en attente.
4. Enregistre la commission. Si la notification contient un jeton d’abonnement, elle est enregistrée comme paiement récurrent, sinon comme vente classique.

Commissions à vie

Si vous utilisez les commissions à vie , le plugin a besoin d’un détail qui identifie le client d’un paiement à l’autre. Lorsque le plugin Commissions à vie est actif, définissez le champ de données supplémentaires qu’il utilise sur l’e-mail ou le numéro de téléphone du client. Si vous choisissez autre chose, les paramètres du plugin affichent une erreur pour ce champ.

Qu’est-ce que PayFast ?

PayFast est une passerelle de paiement basée en Afrique du Sud, fondée en 2007. Elle fait partie de Network International et affirme être utilisée par plus de 80 000 entreprises sud-africaines. Elle permet aux boutiques en ligne d’accepter les paiements de leurs clients sans avoir à mettre en place leur propre traitement des paiements.

Pour les programmes d’affiliation, c’est un choix naturel lorsque vos clients ou vos affiliés se trouvent en Afrique du Sud : les clients paient avec les moyens qu’ils utilisent déjà, et chaque vente peut toujours être rattachée à l’affilié qui l’a recommandée.

Principales fonctionnalités de PayFast

• Nombreux moyens de paiement : plus de 18 méthodes, dont les cartes de crédit, l’Instant EFT, les codes QR, Mobicred et les cartes de magasin.
• Abonnements : facturation récurrente pour les adhésions et les produits par abonnement.
• Tokenisation et paiements fractionnés : conservez les données de paiement en toute sécurité et répartissez un paiement entre plusieurs parties.
• Remboursements et facturation : remboursements et factures émis depuis votre compte PayFast.
• Intégrations : elle se connecte à plus de 70 plateformes existantes et dispose d’une API pour les développeurs.
• Notification instantanée de transaction : une notification pour chaque paiement, qui permet aux ventes d’arriver dans Post Affiliate Pro.

Options tarifaires de PayFast

PayFast indique que sa solution d’agrégation ne comporte aucun frais mensuel et que vous ne payez qu’une petite commission sur chaque transaction. Les frais exacts dépendent du moyen de paiement ; vérifiez-les donc sur le site de PayFast avant de vous décider. Les frais évoluent, utilisez donc les chiffres actuels fournis par PayFast.

Alternatives à PayFast

Si PayFast ne convient pas à votre activité, voici des passerelles de paiement utilisées en Afrique du Sud :

• Ozow
• Peach Payments
• Yoco
• Netcash

Autres intégrations de passerelles de paiement

Post Affiliate Pro s’intègre aussi à de nombreuses autres passerelles de paiement. Consultez les guides pour Stripe , PayPal , Worldpay , ou parcourez toutes les intégrations .