How to configure PhonePe payment gateway?

PhonePe Business allows you to accept online payments from customers through your store. Enter the required PhonePe credentials, activate the payment gateway, and configure the BuildMyStore webhook in the PhonePe Business Dashboard.

Prerequisites

• You must have an active PhonePe Business account.
• You must have the required PhonePe credentials.
• Online Payment must be enabled before configuring the payment gateway.

Step-by-Step Guide

Web App

1. Open Payments: Log in to BuildMyStore Web App, open Settings from the sidebar, and click Payments.
2. Enable Payment Gateways: Make sure the Payment Gateways toggle is turned on.
3. Open PhonePe Business: Find the PhonePe Business card and click Configure.
4. Enter PhonePe Credentials: Enter the Client ID, Client Secret, Seller ID, Client Version, Username, and Password.
5. Save Credentials: Click Save Credentials.
6. Activate PhonePe Business: After the credentials are saved successfully, click Activate.

PhonePe Business is now activated for your store.

Mobile App

1. Open Payment Methods: Log in to the BuildMyStore Mobile App, tap More, then tap Payments & Tax and Payment Methods.
2. Enable Online Payment: Make sure the Online Payment toggle is turned on.
3. Open PhonePe Business: Find the PhonePe Business card and tap Setup.
4. Enter PhonePe Credentials: Enter the Client ID, Client Secret, Seller ID, Client Version, Username, and Password.
5. Save Credentials: Tap Save Credentials.
6. Activate PhonePe Business: After the credentials are saved successfully, turn on the toggle next to PhonePe Business.

PhonePe Business is now activated for your store.

Configure the BuildMyStore Webhook in PhonePe

After setting up your PhonePe Business account, configure the BuildMyStore webhook in the PhonePe Business Dashboard.

Step-by-Step Guide

1. Open Webhooks: Log in to the PhonePe Business Dashboard, go to Developer Settings, and open Webhooks.
2. Create a Webhook: Click Create New Webhook.
3. Enter the BuildMyStore Webhook URL: Enter the following URL in the Webhook URL field:
   https://api.buildmystore.io/api/pg-webhook/update-phonepe-payment-status
4. Select Authentication Type: Under Select Authentication Type, select SHA.
5. Enter Webhook Credentials: Enter your Username and Password.
6. Select Active Events: Under Active Events, select checkout.order.completed, pg.order.completed, checkout.order.failed, and pg.order.failed.
7. Add a Description: The Description field is optional. You can enter BuildMyStore Payment Webhook.
8. Save the Webhook: Click Create or Save.

The BuildMyStore webhook is now configured in PhonePe.

Frequently Asked Questions

You need:

• Client ID
• Client Secret
• Seller ID
• Client Version
• Username
• Password

Yes. PhonePe Business can be configured from both Web App and Mobile App.

No. After saving the credentials successfully, you must activate PhonePe Business.

Troubleshooting

Cause

Online Payment or payment gateways may be disabled.

Solution

On Web App, go to Settings → Payments and turn on Payment Gateways. On Mobile App, go to More → Payments & Tax → Payment Methods and turn on Online Payment.

Cause

The required credentials may not have been saved successfully.

Solution

Open the PhonePe Business configuration, verify the required credentials, save them, and then activate the gateway.

Cause

You want to update your PhonePe credentials.

Solution

Use Configure on Web App or Edit on Mobile App to update the credentials and save the changes.