PayFast + Rewardful Integration Guide for South African Retail & E-commerce
South African Tool
PayFast
South Africa's most widely used payment gateway, supporting EFT, credit cards, SnapScan, and more.
Referral incentives for developers and platforms — contact PayFast directly
Global Tool
Rewardful
Affiliate and referral program software for SaaS companies. Set up commission tracking in minutes.
25% recurring commission for 12 months (via Friends of Rewardful)
Why this matters in South Africa
South African e-commerce stores face a unique problem: global platforms don't natively support local payment methods like EFT, SnapScan, or Ozow. This disconnect leads to cart abandonment rates 40% higher than the global average.
Compliance note: Online retailers must comply with the Consumer Protection Act (CPA) and the Electronic Communications and Transactions Act (ECTA) for refund and disclosure policies.
South African e-commerce retailers often struggle to scale affiliate programs because global platforms like Rewardful lack native support for local payment gateways like PayFast. When a customer completes a purchase via EFT or SnapScan, PayFast’s Instant Transaction Notification (ITN) does not automatically trigger Rewardful’s referral tracking, leaving affiliate commissions unrecorded. By deploying a custom middleware layer—such as a Pipedream or Zapier workflow—you can intercept PayFast’s ITN payload, normalize the ZAR transaction data, and map it to Rewardful’s `create_conversion` API endpoint. This bridge eliminates manual commission reconciliation, which typically consumes 10–15 hours of administrative time per month. Furthermore, this architecture ensures that your referral data remains compliant with POPIA by stripping sensitive PII before passing transaction metadata to Rewardful, allowing you to scale your affiliate channel without sacrificing the local payment flexibility required to keep cart abandonment rates in check.
Free calculator
Are you still doing admin manually?
Calculate what it's costing your business in rands
How to add PayFast to Rewardful
- 1
1. Provision a middleware instance on a platform like Pipedream to act as the secure bridge between your PayFast ITN endpoint and the Rewardful API. This environment must be configured to handle incoming POST requests from PayFast while ensuring all data processing adheres to POPIA requirements regarding customer privacy.
- 2
Configure your PayFast merchant account to send Instant Transaction Notifications (ITN) to your middleware’s unique webhook URL. Ensure the "ITN" setting is enabled in your PayFast dashboard so that every successful ZAR transaction triggers an immediate data push.
- 3
Write a transformation script within your middleware to parse the PayFast ITN payload, specifically extracting the `m_payment_id` and `amount_gross`. You must normalize these values, as Rewardful expects currency inputs in minor units (cents) and requires a specific format for affiliate attribution.
- 4
Implement a lookup function in your middleware to map the `m_payment_id` against your internal database to retrieve the associated `referral_id` or `visitor_id` stored during the initial site visit. This step is critical because PayFast does not natively pass Rewardful’s tracking cookies, necessitating a persistent session link in your own database.
- 5
Authenticate your middleware with the Rewardful API using your private API key to enable secure data transmission. Ensure this key is stored in an environment variable rather than hardcoded to maintain security standards for your retail operations.
- 6
Execute the `create_conversion` API call to Rewardful, passing the normalized transaction amount and the mapped affiliate identifier. Because Rewardful does not support ZAR natively, you must ensure your script converts the ZAR value to a base unit or a supported currency equivalent if your Rewardful account settings require it.
- 7
Add a validation layer to your middleware to filter out non-successful transactions, such as "cancelled" or "pending" PayFast statuses, to prevent fraudulent or incorrect commission payouts. This ensures that your affiliate payouts remain accurate and align with your refund policies under the Consumer Protection Act.
- 8
Log all successful and failed API interactions within your middleware to facilitate monthly reconciliation for SARS reporting. Since Rewardful does not calculate VAT, you must maintain these logs to accurately report your gross sales and commission expenses in your local tax filings.
Free calculator
Are you still doing admin manually?
Calculate what it's costing your business in rands
Affiliate disclosure
The links below are affiliate links. If you sign up through them, Melamu Tech Ventures earns a commission at no extra cost to you. We only recommend tools we have evaluated.
Frequently asked questions
Is PayFast compatible with Rewardful?
Yes. PayFast and Rewardful can be connected via their APIs or through automation tools like Zapier. This guide covers the exact process for South African retail & e-commerce businesses.
How long does the setup take?
Most businesses complete the initial setup in 1–3 hours. If you already have active accounts on both platforms, you can have a basic automation running in under an hour.
Do I need a developer?
Not for basic Zapier-based integrations. Custom API integrations will need development support. Melamu Tech Ventures builds these — get in touch if you need a tailored solution.