BILLmanager 6 Startup, Advanced
Documentation
/
BILLmanager 6 Startup, Advanced
/
Finances
/
Payment gateways
/
PayFast

PayFast

To use the PayFast payment module, register in the payment system and configure the module on the BILLmanager side.

Payment methods support
Bank cardsCashE-walletsMobile paymentsOnline banking
Mastercard,
Visa.
MasterPass.
Instant EFT.
Supported features

Payments return

Recurring payments

Subscriptions

Configuring BILLmanager

The module is installed from the latest available version of the product and requires an update of the BILLmanager platform, because the module version cannot be higher than the platform version.
Note:
PayFast payment notifications are sent to server ports 80, 8080, 8081 и 443. Make sure BILLmanager runs on one of those ports.

To create a payment module, enter Provider → Payment methods → click Add. The payment module adding wizard consists of the following steps:

  1. Select a payment methods: "PayFast".
  2. Integration settings. Specify the data for integration:
    Activate the Add New Client option to display a link to register with the handlers system.
    Complete the form using the details of an existing client in the handlers system:
    1. Client — select the existing account or register a new one. If you choose "Use existing", enter the following details: 
    2. Merchant ID — merchant unique identifier in PayFast. 
    3. Merchant key — merchant key in PayFast. 
    4. Passphrase — secret word that will be used for creating a security signature.
    5. Payment gateway URL — enter the gateway URL for payments. Use https://sandbox.payfast.co.za/eng/process for tests.
    6. Payment method — select a payment method that will be available to clients.
    7. Recurring payments — select the check box to enable recurring payments (it is used for Debit Card). 
    8. Payment amount — payment amount for automatic payment activation. The system will charge a client only once when setting up recurring payments.  Funds will be added to the clients account as an advanced payment.
    9. Test mode — select the check box to activate a test mode for this payment method. The system wont charge client, but will process the payments correctly.
  3. Payment method settings. Configure internal (within BILLmanager) parameters of the service payment module. For more details, see How to add a payment gateway module.

Additional information

Refund

Refunds are not supported.

Logging

PayFast has the following log files:

  • /usr/local/mgr5/var/pmpayfast.log — configuration details of the payment method and auto-payments.
  • /usr/local/mgr5/var/payfastpayment.log — configuration details of the payment method.
  • /usr/local/mgr5/var/payfastresult.log — payment check  upon receiving an IPN message 
  • /usr/local/mgr5/var/payfastrecurring.log — auto-payment activation. 
  • /usr/local/mgr5/var/payfastrecurringresult.log — auto-payment activation.