EFT Pro via PayU

Accept EFT Pro payments from customers in South Africa with PayU as the payment service provider (PSP). The customer selects EFT Pro, confirms the transfer from their bank on the PayU payment page and returns to your site.

Supported workflows

Before you begin

Complete these steps before you send your first EFT Pro payment through PayU:

Set up a PayU integration in your workspace. Contact your Payrails account team if PayU isn’t listed in your Payrails Portal yet.
Ask PayU to enable EFT Pro on your PayU merchant account.
In the Payrails Portal, go to Settings → Integrations, open your PayU integration, select EFT Pro under Payment methods, and save.
Add EFT Pro as a payment option in your workflow.

Request fields for PayU

Send these fields in the authorize request, in addition to the standard authorize fields. Required fields must be present for the payment to succeed. Payrails sends Optional fields to the PSP when you include them.

Field	Status	Description
`amount.currency`	Required	Must be `ZAR`. Payrails rejects EFT Pro requests to PayU in any other currency.
`meta.customer.name`, `meta.customer.lastName`	Optional	Sent to PayU as the customer’s first and last name.
`meta.customer.email`	Optional	Sent to PayU as the customer email.
`meta.customer.phone.number`	Optional	Sent to PayU as the customer’s mobile number.
`meta.customer.birthDate`	Optional	Sent to PayU as the customer’s date of birth.
`holderReference`	Optional	Sent to PayU as your user ID for the customer.
`returnInfo.cancel`	Optional	Sent to PayU as the page the customer returns to when they cancel the payment.

Authorize an EFT Pro payment

Call authorize a payment with eftPro as the paymentMethodCode. The response includes the redirect to the PayU payment page.

Authorize request

{
  "amount": {
    "value": "450.00",
    "currency": "ZAR"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "eftPro",
      "amount": {
        "value": "450.00",
        "currency": "ZAR"
      }
    }
  ],
  "meta": {
    "customer": {
      "name": "Lerato",
      "lastName": "Mokoena",
      "email": "lerato.mokoena@example.com",
      "phone": {
        "countryCode": "+27",
        "number": "821234567"
      }
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "cancel": "https://example.com/cancel",
    "error": "https://example.com/error"
  }
}

After the customer confirms the transfer, PayU returns them to your success or error URL. Confirm the result through webhook notifications or the execution status before you fulfill the order.

How PayU handles EFT Pro

PayU processes EFT Pro as a one-step payment, so Payrails sends it with instant capture.
PayU notifies Payrails of the final result. When the customer returns, Payrails also fetches the transaction from PayU to confirm it.
To return funds after a successful payment, refund it.

Getting Started

Payment Orchestration

Token Vault

Analytics & Reporting

Fraud Management

Chargebacks

Monitoring

Resources

Use Cases

Supported workflows

Before you begin

Request fields for PayU

Authorize an EFT Pro payment

How PayU handles EFT Pro

​Supported workflows

​Before you begin

​Request fields for PayU

​Authorize an EFT Pro payment

​How PayU handles EFT Pro

Supported workflows

Before you begin

Request fields for PayU

Authorize an EFT Pro payment

How PayU handles EFT Pro