Prerequisites
- You need an active PayU account with the necessary payment methods activated. Please get in touch with your PayU account manager to enable the missing payment methods if required.
- Configure the required webhooks.
- Generate Merchant Key and Salt on the PayU Dashboard.
- Log in to the PayU Dashboard.
- Select Payment Gateway under Collect Payments from the menu on the left navigation.
- Scroll down to Key Salt Details section.
Handy TipsMerchant Key and Salt values are generated automatically for the first time.
Integration Requirements
Before you go live with PayU Instant (beta) on Optimizer, configure the webhooks:To configure a webhook:
- Log in to the PayU Dashboard.
- Navigate to Settings → Webhook.
- Click Create Webhook on the top-right corner of the Create Webhooks page.
- Select the webhook type (Payments or Payouts) and Event type.
- Enter the webhook URL in the Webhook URL field and click Create.
Handy TipsMake sure you configure the webhooks for both successful and failed payment events.
Add PayU as a Payment Provider
To add PayU Instant (beta) as a payment provider:
- Log in to your Razorpay Dashboard.
- Go to the PAYMENT PRODUCTS section and click Optimizer.
- In the top-right section, click Add Provider.
- Select PayU and Instant (beta) in the list of gateways available and click Next.
- Enter the provider name and description and click Next.
- Enter your PayU key and Salt key.
- Select the payment methods you want to enable for PayU and click Submit.
Supported Payment Methods
Payment Methods | Availability
Netbanking | Live
Cards | Live
UPI | Live
Wallet | Live
EMI | Coming Soon
Settlements | Live
Refunds | Live
Emandate | Coming Soon
Sodexo | Coming SoonSend Receipt/Order ID to External Gateway
You might be generating a unique Order ID or Receipt for every order which can be passed to PayU viaOrders API. To make your order id to be visible on the PayU Dashboard:1
Step 1
In Razorpay’s Orders API, use the
receipt parameter to send your unique Order ID or Receipt.2
Step 2
Razorpay passes this value to PayU in the
udf1 parameter.3
Step 3
Write to your PayU Relationship Manager to show the parameter
udf1 in the Dashboard and reports as per your use case.Best Practices
Before routing all traffic or some traffic to a new gateway via Optimizer, the following best practices are recommended:Live and Test Mode Rules
All rules configured on live or test mode on the Razorpay Dashboard will reflect on live mode. However, credentials added on test mode will not be automatically replicated in live mode.Sanity Test at Razorpay
You can reach out to Razorpay for basic sanity testing of the integration. Razorpay will try a test payment of small value and ensure that the credentials are correct.Perform Self Sanity Test
We recommend configuring a rule on live mode to route payments lesser than a set value (for example, ₹2) to the PayU gateway. This helps to test on production whether small value payments are being routed to PayU and working successfully, thus helping to avoid any direct impact on production traffic. To configure a rule in live mode:- Log in to your Razorpay Dashboard.
- In the left navigation, click Optimizer.
- Click +Add Rule and enter the Rule name and Description.
-
Click Next and enter the following rule:
- In Parameter field, select Amount (In Rupees).
- In Select Connection field, select Less Than.
- In Enter Amount field, enter the value 2 and click Next.
- Enter the value 100 in the Route field, select PayU in the Payment Via field, and click Next.
- Click Publish Rule.