Who should use this guideThis guide is intended for merchants who:
- Use Payrails as a payment orchestrator
- Use PayU South Africa for cards or EFT Pro
- Have an active PayU South Africa merchant account
Create a PayU integration in Payrails
- Log in to the Payrails portal.
- Go to Settings → Integrations.
- Select Add instance to create a new integration configuration.
- Select the workspaces where this integration should be available.
About workspacesWorkspaces determine where this integration is available. They let you isolate provider setups by region or business line, or share the same configuration across multiple workspaces.
Step 1: Choose the integration type
- Select Payment.
- Continue to the next step.
Step 2: Choose the provider
- Select Payu.
- Continue to the next step.
Step 3: Configure your PayU integration
Integration instance name
An integration instance is a specific payment provider setup in Payrails. You can create multiple instances for different regions, currencies, or business needs. Choose a clear, consistent name, as it is used in routing.In Payrails
- Enter an Instance name for your integration, for example
merchant_payu.
Account details
In Payrails
Credentials
In Payrails
Payrails sends requests to the PayU staging environment in test mode and to the live environment in live mode, so use the credentials for the matching environment.
Payment methods
In Payrails- Select Card, EFT Pro or both.
Webhooks or notifications
Payrails sends its notification URL to PayU with every payment, so you don’t need to set one up in the PayU dashboard. Payrails confirms each notification by fetching the transaction from PayU with your credentials.Request fields for PayU
Send these fields in the authorize request for card payments, in addition to the standard authorize fields. Required fields must be present for the payment to succeed. Payrails sends Optional fields to PayU when you include them. For more about meta fields, refer to Meta fields.
PayU payments are captured straight away, so use instant capture in your workflow.
Enable the integration
In Payrails- Select Save account to enable the integration.
- Confirm the integration shows as Enabled.
Next steps
- Run a test card payment in ZAR in the PayU staging environment.
- Verify that:
- The payment appears in PayU.
- The payment status updates correctly in Payrails.
- Once verified in test mode, repeat the setup in live mode.