PayFast

PayFast-integratie

PayFast is een Zuid-Afrikaanse betaalgateway. De Post Affiliate Pro-plugin koppelt het aan je affiliate -programma. Na elke betaling stuurt PayFast een Instant Transaction Notification (ITN) naar je Post Affiliate Pro-installatie, en de plugin registreert de verkoop voor de affiliate die de klant heeft doorverwezen. Wanneer de betaling bij een PayFast-abonnement hoort, registreert de plugin in plaats daarvan een terugkerende betaling.

Hoe integreer je PostAffiliatePro met PayFast

Activeren van de plugin

Ga in je merchant panel naar Configuratie > Plugins > PayFast ITN-verwerking > Activeren. Configureer de plugin na het activeren minimaal met het volgende:

• Custom string-veld: het aangepaste PayFast-veld (custom_str1 tot en met custom_str5) dat de trackingwaarde uit je betaalformulier bevat. Standaard is dat custom_str1. Alle andere opties worden beschreven in het gedeelte over plugininstellingen hieronder.
• Signature passphrase: gebruik dezelfde passphrase die je gebruikt in het gedeelte Instellingen van je PayFast-dashboard. PayFast vereist dat de passphrase op je account en op je site identiek is.

Integratie van het betaalformulier

Om de affiliate te volgen die de klant heeft doorverwezen, moet het betaalformulier de trackingwaarde doorgeven aan PayFast, en moet PayFast de melding naar Post Affiliate Pro sturen. Voeg deze onderdelen toe aan je PayFast-betaalformulier:

<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>

Let op: gebruik je custom_str1 al voor iets anders, gebruik dan een andere custom string en selecteer diezelfde in de plugin-configuratie.

Opmerking: Als je meer dan één betaalformulier op een pagina hebt, plaats je het <script>-gedeelte maar één keer per volledige pagina. Elk betaalformulier heeft alleen de <input>-onderdelen nodig.

Voorbeeld

Hier is een voorbeeld van een betaalformulier met de integratiecode toegevoegd:

<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>

Vergeet niet je site te koppelen aan de klik-trackingcode .

Abonnementen

Voor PayFast-abonnementen stuurt PayFast bij elke betaling een melding met een abonnementstoken. De plugin herkent het token en registreert de betaling als terugkerende betaling, met het token als order-ID. Hiervoor moet je in PayFast een passphrase hebben ingesteld en terugkerende facturering hebben ingeschakeld op je PayFast-account. Lees over terugkerende commissies om te zien hoe die aan de Post Affiliate Pro-kant worden ingesteld.

Plugininstellingen

De plugin heeft de volgende opties:

• Custom string-veld: het aangepaste PayFast-veld met de trackingwaarde. Standaard: custom_str1.
• Signature passphrase: de passphrase uit je PayFast-dashboard.
• PayFast-order-ID gebruiken: standaard gebruikt de plugin het unieke betaal-ID van je systeem (m_payment_id) als order-ID. Vink dit aan om in plaats daarvan het PayFast-betaal-ID te gebruiken.
• Discount fee: standaard ingeschakeld. De commissie wordt berekend op het nettobedrag, na de kosten van PayFast. Schakel dit uit om het brutobedrag te gebruiken.
• Nieuwe affiliate registreren bij elke gebeurtenis: maakt een nieuwe affiliate aan op basis van de naam en het e-mailadres van de klant in de betaling.
• Affiliate registreren bij aankoop van deze producten: beperkt de registratie hierboven tot specifieke producten. Laat dit leeg om bij elke aankoop een affiliate te registreren, of voer productnamen in, gescheiden door een puntkomma, bijvoorbeeld product1;perfect product;product3. De productnaam is de itemnaam die naar PayFast is verstuurd.
• Affiliate goedkeuren na geslaagde betaling: een wachtende affiliate wiens e-mailadres overeenkomt met dat van de betalende klant, wordt goedgekeurd na een geslaagde betaling.
• Totale terugkerende kosten uit melding gebruiken: gebruikt voor terugkerende commissies het bedrag uit elke PayFast-melding in plaats van het bedrag van de eerste betaling.
• Extra data 1 tot 5: slaat een gegeven uit de melding op in de extra datavelden van de verkoop. Je kunt kiezen uit het e-mailadres, telefoonnummer, naam, voornaam, achternaam, itemnaam, itembeschrijving of het PayFast-transactie-ID van de klant. Extra data 1 staat standaard op het e-mailadres van de klant.
• IPN opnieuw verzenden naar URL: stuurt de PayFast-melding door naar een ander adres, bijvoorbeeld een ander systeem dat ook de ITN gebruikt. Het adres moet een geldige URL met protocol zijn en mag niet naar dezelfde Post Affiliate Pro-installatie verwijzen.

Hoe werkt de plugin precies?

Wanneer PayFast een melding naar het pluginadres stuurt, doet de plugin het volgende:

1. Leest de betaling: het bedrag, het betaal-ID, het e-mailadres en de naam van de klant, de itemnaam en de trackingwaarde uit je custom string-veld.
2. Controleert de betalingsstatus. Alleen de status COMPLETE wordt verwerkt, elke andere status wordt overgeslagen.
3. Zoekt de affiliate op basis van de trackingwaarde en registreert, indien ingeschakeld, een nieuwe affiliate of keurt een wachtende affiliate goed.
4. Registreert de commissie. Bevat de melding een abonnementstoken, dan wordt die als terugkerende betaling geregistreerd, anders als gewone verkoop.

Levenslange commissies

Wanneer je levenslange commissies gebruikt, heeft de plugin een gegeven nodig dat de klant over meerdere betalingen heen identificeert. Wanneer de plugin Levenslange commissies actief is, stel je het extra dataveld dat hij gebruikt in op het e-mailadres of telefoonnummer van de klant. Kies je iets anders, dan geven de plugininstellingen een foutmelding voor dat veld.

Wat is PayFast?

PayFast is een betaalgateway uit Zuid-Afrika, opgericht in 2007. Het maakt deel uit van Network International, en volgens het bedrijf vertrouwen meer dan 80.000 Zuid-Afrikaanse bedrijven erop. Het stelt online winkels in staat betalingen van klanten te accepteren zonder hun eigen betalingsverwerking te bouwen.

Voor affiliateprogramma’s is dit een logische keuze wanneer je klanten of affiliates in Zuid-Afrika zitten. Klanten betalen dan met de methoden die ze al gebruiken, en elke verkoop kan nog steeds worden teruggevoerd naar de affiliate die de klant heeft doorverwezen.

Belangrijkste functies van PayFast

• Veel betaalmethoden: meer dan 18 methoden, waaronder creditcards, Instant EFT, QR-codes, Mobicred en winkelkaarten.
• Abonnementen: terugkerende facturering voor lidmaatschappen en abonnementsproducten.
• Tokenisatie en gesplitste betalingen: sla betaalgegevens veilig op en splits een betaling tussen partijen.
• Terugbetalingen en facturen: terugbetalingen door de merchant en facturen vanuit je PayFast-account.
• Integraties: het koppelt aan meer dan 70 bestaande platforms en heeft een developer-API.
• Instant Transaction Notification: een melding voor elke betaling. Zo komen verkopen bij Post Affiliate Pro terecht.

Prijsopties van PayFast

PayFast meldt dat de aggregatieoplossing geen maandelijkse kosten heeft en dat je alleen een kleine transactievergoeding betaalt wanneer je een verkoop maakt. De exacte kosten hangen af van de betaalmethode, dus controleer ze op de PayFast-website voordat je een beslissing neemt. Kosten veranderen, dus gebruik de actuele cijfers van PayFast.

Alternatieven voor PayFast

Als PayFast niet bij je bedrijf past, zijn dit betaalgateways die in Zuid-Afrika worden gebruikt:

• Ozow
• Peach Payments
• Yoco
• Netcash

Andere betaalgateway-integraties

Post Affiliate Pro integreert ook met veel andere betaalgateways. Bekijk de handleidingen voor Stripe , PayPal of Worldpay , of blader door alle integraties .