Custom Payment Integration

This process supports both once-off and recurring payments.

Live & Sandbox Endpoints

Live: https://payment.payfast.io/eng/process

Sandbox: https://sandbox.payfast.co.za/eng/process

💡
It’s recommended to create your own Sandbox account to test your integration before going live.

Simple Form Integration (Example)

Here’s a basic HTML form to get you started:

<form action="https://www.payfast.co.za/eng/process" method="post">
  <input type="hidden" name="merchant_id" value="10000100">
  <input type="hidden" name="merchant_key" value="46f0cd694581a">
  <input type="hidden" name="amount" value="100.00">
  <input type="hidden" name="item_name" value="Test Product">
  <input type="submit">
</form>

Replace the values above with your own merchant credentials and item details.

Quick Integration Guide

Form Fields

Details of all form fields required for integration.

Security Signature

How to generate and validate the Payfast security signature.

Pay with Payfast

Redirect customers to the Payfast payment page.

Confirm Payment

Handling Payfast payment confirmation (ITN) securely.

flowchart LR
    A[Form Fields] --> B[Security Signature]
    B --> C[Pay with Payfast]
    C --> D[Confirm Payment]
    style A fill:#e0f7fa,stroke:#00838f,stroke-width:2px
    style B fill:#f1f8e9,stroke:#33691e,stroke-width:2px
    style C fill:#fff8e1,stroke:#ff6f00,stroke-width:2px
    style D fill:#fce4ec,stroke:#880e4f,stroke-width:2px

Watch: Custom Integration Overview

0:00 - Intro

0:33 - Checkout Form Setup

6:47 - Create Security Signature

7:58 - Set Up Payment

11:14 - Set Up Payment Notification

16:00 - Outro