Connect PhonePe

Use this guide to connect PhonePe Payment Gateway to the School ERP. The card is called PhonePe Payment Gateway. PhonePe can be connected in two ways, chosen in the Integration box:

• The school's own PhonePe merchant credentials: PhonePe issued the Client ID, secret and version to the school.
• Through JPRAXC as PhonePe technical service provider (TSP): the school is a PhonePe merchant with its own merchant ID, connected through JPRAXC. See Your own account or through JPRAXC.

Either way, PhonePe settles the fees to the school's own bank account.

Before you start#

• The school has a PhonePe merchant account (or, for the JPRAXC route, JPRAXC support has arranged it with PhonePe and you have the school's PhonePe merchant ID).
• You have the school administrator's login for the School ERP.
• Read Set up a gateway in Payment Configuration once.

PhonePe's screens change from time to time. If a menu below looks different, follow PhonePe's own documentation for Standard Checkout credentials and webhooks.

Option A: the school's own PhonePe credentials#

Get the credentials from PhonePe#

1. Sign in to the PhonePe Business dashboard.
2. Open the developer settings and find the Standard Checkout credentials for the test (UAT) environment. PhonePe may also send them to the registered e-mail during onboarding.
3. Note the Client ID, the Client secret and the Client version. The client version is a number PhonePe issues with the client ID. Enter exactly what PhonePe gives you; do not assume it is 1.

Enter them in the School ERP#

1. Open General Settings › Payment Configuration.
2. Set Environment to Test / sandbox, then select Configure on the PhonePe Payment Gateway card.
3. Check that Test environment is selected.
4. In Integration, choose The school's own PhonePe merchant credentials.
5. Paste Client ID, Client secret and Client version.
6. In Webhook authentication, choose SHA username and password.
7. Make up a Webhook username and a strong Webhook password. You will type the same pair in PhonePe.
8. Leave Merchant server IP (partner integrations, optional) blank.
9. Select Save settings, then Test connection.

Register the webhook in PhonePe#

1. In the ERP, select Copy Webhook URL below the form.
2. In the PhonePe dashboard, open the webhook page in the developer settings and create a webhook.
3. Paste the address, choose SHA as the authentication type, and type the same username and password you entered in the ERP.
4. Select the order completed, order failed, refund completed and refund failed events.
5. Save it.

Option B: PhonePe through JPRAXC#

1. Ask JPRAXC support to set up PhonePe through JPRAXC. Keep the school's PhonePe merchant ID ready.
2. Open General Settings › Payment Configuration, set Environment to Test / sandbox and select Configure on the PhonePe Payment Gateway card.
3. In Integration, choose Through JPRAXC as PhonePe technical service provider (TSP).
4. Client ID, Client secret and Client version take the connection details JPRAXC provides for this arrangement. JPRAXC support can fill these in with you.
5. In End merchant ID (X-MERCHANT-ID), enter the school's own PhonePe merchant ID exactly as PhonePe issued it.
6. Leave Merchant server IP (partner integrations, optional) blank unless JPRAXC support asks you to fill it.
7. In Webhook authentication, choose SHA username and password, and make up a Webhook username and Webhook password.
8. Select Save settings, then Test connection. For this route, the test also checks that PhonePe recognises your merchant ID.
9. Select Register webhook with PhonePe. The ERP registers its own webhook address with PhonePe for order and refund events. If it is already registered, the ERP says so and adds nothing.

Test, then go live#

1. Select Start sandbox payment and complete a test payment. See Test a payment end to end.
2. Get the production credentials from PhonePe (or, through JPRAXC, confirm the production merchant ID with JPRAXC support).
3. In the ERP panel select Live environment, fill in the live values the same way, tick Enable and use this gateway for fee payments and select Save settings.
4. Register the live webhook: in PhonePe's dashboard for Option A, or with Register webhook with PhonePe for Option B.
5. Select Test connection for the live settings.

Good to know#

• PhonePe is the one gateway whose settlements the ERP can fetch. In Fees › Online fee collection, open Bank settlements and use Fetch settlements from PhonePe. See Reconciliation and settlements.
• The ERP confirms every PhonePe payment by checking its status with PhonePe. The webhook only makes the check happen sooner.
• A PhonePe order that the parent abandons expires after a while and shows as failed. Nothing is recorded for it.
• Refund from the ERP, not from the PhonePe dashboard. See Refund an online payment.

Troubleshooting#