This allows the merchant to show a confirmation (or failure) page to the customer. You can use the returned data to display a message or initiate final internal workflows (such as sending a receipt or updating an order status).

📘
Unlike the Notify response, this return is client-initiated. It should not be trusted for final reconciliation. Always use the Notify or Query for confirmation.

Redirect Details

PayWeb will append the transaction outcome to the RETURN_URL you supplied during the Initiate step.

Example:

https://yourdomain.com/return-handler?PAY_REQUEST_ID=23B785AE-C96C-32AF-4879-D2C9363DB6E8&TRANSACTION_STATUS=1&CHECKSUM=abcdef1234567890

Returned Fields

Field	Description	Type
PAY_REQUEST_ID	The same unique request ID returned in the initial `/initiate.trans` call.	`varchar(36)`
TRANSACTION_STATUS	Final status of the transaction. Refer to Transaction Status Codes	`tinyint(3)`
CHECKSUM	MD5 hash based on `PAYGATE_ID`, `PAY_REQUEST_ID`, `TRANSACTION_STATUS`, `REFERENCE`, and your key.	`varchar(32)`

You must validate the CHECKSUM to ensure the data hasn’t been tampered with.