Who should use this guideThis guide is intended for merchants who:
- Use Payrails as a payment orchestrator
- Use PayJustNow to offer buy now, pay later in South Africa
- Have an active PayJustNow merchant account
Create a PayJustNow 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 PayJustNow.
- Continue to the next step.
Step 3: Configure your PayJustNow 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_payjustnow.
Account details
In Payrails
Credentials
In Payrails
Payrails sends requests to the PayJustNow sandbox in test mode and to the live environment in live mode, so use the key for the matching environment.
Payment methods
In Payrails- Select Payjustnow.
Webhooks or notifications
Payrails uses provider webhooks or notifications to receive asynchronous
payment status updates.
- Copy the Notification URL shown under Account configuration at the top of the integration form.
- Send the Payrails notification URL to PayJustNow, and ask them to set it as the callback URL for your merchant account.
- PayJustNow then notifies Payrails when an order is paid, cancelled or refunded.
Request fields for PayJustNow
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 PayJustNow when you include them. For more about meta fields, refer to Meta fields.Enable the integration
In Payrails- Select Save account to enable the integration.
- Confirm the integration shows as Enabled.
Next steps
- Run a test PayJustNow payment in ZAR in the PayJustNow sandbox.
- Verify that:
- The order appears in PayJustNow.
- The payment status updates correctly in Payrails.
- Once verified in test mode, repeat the setup in live mode.