Set up PayU India
The PayU gateway takes payments in Indian rupees (INR) on PayU India’s own payment page: cards, UPI, net banking and wallets. Card and bank details never reach your portal.
Before you start
Section titled “Before you start”- Key and salt. In the PayU dashboard, open Developers → Key and Salt and copy the merchant key and the salt. PayU has separate test and live values.
- Currency. PayU India’s payment page charges rupees only. On an invoice in another currency, the gateway shows a note instead of a payment button: set Accepted Currencies to INR so clients with other currencies do not choose it.
Set it up
Section titled “Set it up”- Install PayU on System → Payment Gateways and open it.
- Copy the merchant key and salt into the Live fields.
- Turn on Enabled and select Update Gateway.
- Copy the gateway’s IPN Callback URL (
https://your-portal/ipn.php?gateway_id=…). In the PayU dashboard, open Developers → Webhooks and add it for the Successful and Failed payment events.
The webhook records a payment even when the client closes the browser before PayU sends them back. Without it, such a payment is recorded only when staff process it again.
Test it first
Section titled “Test it first”Turn on Test mode, fill in the Test merchant key and Test merchant salt from PayU’s test dashboard, and pay an invoice with one of PayU’s test cards or test UPI IDs.
How payments are recorded
Section titled “How payments are recorded”ClientFence checks PayU’s signature (the reverse hash) on every return and webhook, then reads the payment back from PayU before it pays the invoice. Only a payment PayU reports as successful, for the invoice’s amount, pays it, and each payment is recorded once.
A payment PayU still shows as pending, such as some net banking and UPI payments, waits on its transaction. ClientFence asks PayU again every few minutes and pays the invoice once PayU reports it successful.
Refunds
Section titled “Refunds”When you refund an invoice paid with PayU, choose Send it back through PayU (see Refunds). The refund is recorded only when PayU accepts the request; PayU then sends the money back to the client.

