Magento 2.x Integration with PayFast

Magento 2.x Integration

PayFast integrates directly into the Magento checkout flow, allowing merchants to process payments without building a custom payment gateway integration.

Installation Requirements

Before installing the PayFast module, ensure that:

• You are running Magento 2.x

• Your server meets Magento’s system requirements

• You have administrator access to your Magento store

• You have an active PayFast merchant account

📘

PayFast no longer supports Magento 1.x due to security updates.

Installing and Testing the PayFast Module

1. Set up ZAR as a currency in your Magento store

   • Navigate to Stores → Currency Symbols and Rates

   • Add South African Rand (ZAR)

2. Download the PayFast module compatible with your Magento version:

   • Magento 2.0

   • Magento 2.1–2.2

   • Magento 2.3+

3. Copy the PayFast module folder into your Magento root directory.

4. Run the following commands in your Magento installation directory:

php ./bin/magento module:enable Payfast_Payfast
php ./bin/magento setup:di:compile
php ./bin/magento setup:static-content:deploy
php ./bin/magento cache:clean

5. Log in to the Magento Admin panel.

6. Navigate to:
   Stores → Configuration → Sales → Payment Methods

7. Select PayFast from the list.

Sandbox Configuration

To test payments in the sandbox environment:

• Enable the PayFast module

• Set the Server field to: test

• Use the sandbox credentials:

Merchant ID: 10000100
Merchant Key: 46f0cd694581a
Passphrase: (leave blank)

Configure any additional options as required, then click Save Config.

You can now perform test transactions.

Go-Live Configuration

When ready to process real payments:

1. Change the Server field to: live

2. Enter your actual PayFast Merchant credentials

3. Disable debug logging

4. Adjust additional settings as required

5. Click Save Config

Your Magento store will now process live payments through PayFast.

FAQ — PayFast Integration for Magento