Connect PayU

Use this guide to connect the school's own PayU India merchant account to the School ERP. The card is called PayU India. It needs two values: Merchant Key (key) and Salt (salt). PayU gives separate test and live values.

Before you start#

• The school has a standard PayU India merchant account in Indian rupees. For live payments, PayU must have completed its onboarding and website checks.
• You have the school administrator's login for the School ERP.
• Student records carry the father's mobile number and an e-mail address. PayU needs a name, e-mail and 10-digit mobile number for every payer.
• Read Set up a gateway in Payment Configuration once.

PayU's screens change from time to time. If a menu below looks different, follow PayU's own documentation for merchant key and salt, and for webhooks.

Get your key and salt from PayU#

1. Sign in to the PayU dashboard and switch to test mode.
2. Open the page in the developer settings that shows your merchant key and salt.
3. Copy the Key and the Salt. If PayU shows more than one salt version, copy the Salt version 2 value.

Enter them in the School ERP#

1. Open General Settings › Payment Configuration.
2. Set Environment to Test / sandbox, then select Configure on the PayU India card.
3. Check that Test environment is selected.
4. Paste into Merchant Key (key) and Salt (salt).
5. Select Save settings.

PayU has no Test connection button in the ERP. You prove the keys with a sandbox payment instead.

Register the webhook in PayU#

1. In the ERP, select Copy Webhook URL below the form.
2. In the PayU dashboard, open the webhooks page and add a webhook for successful payments and one for failed payments, both with this address.
3. Save them.

The ERP sends PayU the address to return the parent to with every payment, so you do not type the Return URL into PayU. It is shown on the ERP screen for reference.

Test, then go live#

1. Select Start sandbox payment and complete a test payment. See Test a payment end to end.
2. When PayU has approved the account for live payments, copy the live key and salt.
3. In the ERP panel select Live environment, paste them, tick Enable and use this gateway for fee payments and select Save settings.
4. Copy the live Webhook URL and register it in PayU's live webhooks.

Good to know#

• The ERP confirms every PayU payment with PayU before posting a receipt.
• Full and partial refunds can be started from the ERP. See Refund an online payment.
• PayU settlements are not fetched into the ERP. Record each bank settlement by hand. See Reconciliation and settlements.
• The ERP uses PayU's standard hosted checkout in rupees. Split payments, mandates (auto-debit) and foreign-currency payments are not used.

Troubleshooting#