After successfully initiating a transaction using the /initiate.trans endpoint, the merchant must redirect the client to PayWeb to complete the payment.
This is done by submitting a form with the PAY_REQUEST_ID and CHECKSUM to the /process.trans endpoint.
Both field names must be posted in uppercase, and theCHECKSUMmust be calculated correctly to ensure the transaction is accepted.
Redirect Endpoint
POST https://secure.paygate.co.za/payweb3/process.transExample redirect form:
<form action="https://secure.paygate.co.za/payweb3/process.trans" method="POST">
<input type="hidden" name="PAY_REQUEST_ID" value="23B785AE-C96C-32AF-4879-D2C9363DB6E8">
<input type="hidden" name="CHECKSUM" value="b41a77f83a275a849f23e30b4666e837">
<input type="submit" value="Continue to PayWeb">
</form>
Required Fields
| Field | Description | Type | Required |
|---|---|---|---|
| PAY_REQUEST_ID | The unique transaction reference returned by PayWeb during the /initiate.trans step. | varchar(36) | ✅ |
| CHECKSUM | MD5 hash of PAYGATE_ID + PAY_REQUEST_ID + REFERENCE + encryption key. | varchar(32) | ✅ |
Make sure your CHECKSUM includes all required values from the original request. For help calculating it, see the Security section.
Redirect Errors
If the redirect fails or the CHECKSUM is invalid, an error message will be displayed to the client. For a list of possible error messages, refer to the Error Codes section.
What's Next?
Once the client completes their payment, PayWeb will:
Send a Notify POST to your NOTIFY\_URL (if specified)
Redirect the customer to your RETURN\_URL