Onsite Payments (Beta)

Integrate Payfast’s secure payment engine directly into your checkout page using the Onsite Payments feature.

Other payment processors commonly call this a Hosted Payment Page or Embedded Checkout.

What is Onsite Payments?

Onsite Payments allows you to embed Payfast’s payment flow inside your website’s checkout experience via a secure modal popup. This keeps your customers on your site, offering a seamless payment experience without redirecting to an external page.

Important Security Notice

For security reasons, your application must be served over HTTPS to use Onsite Payments.

Onsite Payments Integration Guide

Step 1: Get Payment Identifier

Send payment details and receive a unique payment identifier (UUID) from Payfast.

Step 2: Trigger Payment Modal

Use the UUID to open the payment modal and complete the transaction seamlessly.

📘
Security & PCI: read the PCI page

flowchart TD
    A[Start Checkout] --> B[Post payment details to Payfast]
    B --> C{Receive UUID?}
    C -- Yes --> D[Trigger payment modal with UUID]
    C -- No --> E[Handle error]
    D --> F{Payment Completed?}
    F -- Yes --> G[Redirect to Success page]
    F -- No --> H[Close modal or Cancel]

Watch: Onsite Payments Integration Guide