Return to Merchant

After PayWeb has processed the payment and (optionally) sent a response to the NOTIFY_URL, the client is redirected back to the merchant’s RETURN_URL.

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

FieldDescriptionType
PAY_REQUEST_IDThe same unique request ID returned in the initial /initiate.trans call.varchar(36)
TRANSACTION_STATUSFinal status of the transaction. Refer to Transaction Status Codestinyint(3)
CHECKSUMMD5 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.