How to configure Cashfree payment gateway?

Cashfree Payment Gateway allows you to accept online payments from customers. Enter the required Cashfree credentials, activate the gateway, and configure the BuildMyStore webhook to receive payment status updates.

Prerequisites

• You need an active Cashfree account.
• You need the credentials provided by Cashfree.
• Online Payment must be enabled before configuring the gateway.

Step-by-Step Guide

Web App

1. Open Payments: Log in to BuildMyStore Web App, open Settings, and click Payments.
2. Enable Payment Gateways: Turn on the Payment Gateways toggle.
3. Open Cashfree: Find Cashfree and click Configure.
4. Enter Cashfree Credentials: Enter the App ID and Secret Key.
5. Save Credentials: Click Save Credentials.
6. Activate Cashfree: Click Activate.

Cashfree is now activated for your store.

Mobile App

1. Open Payment Methods: Log in to BuildMyStore Mobile App, open More, and select Payments & Tax → Payment Methods.
2. Enable Online Payment: Turn on the Online Payment toggle.
3. Open Cashfree: Find Cashfree and tap Setup.
4. Enter Cashfree Credentials: Enter the App ID and Secret Key.
5. Save Credentials: Tap Save Credentials.
6. Activate Cashfree: Turn on the Cashfree toggle.

Cashfree is now activated for your store.

Configure the BuildMyStore Webhook in Cashfree

Configure the BuildMyStore webhook from the Cashfree Dashboard to receive payment status updates.

Step-by-Step Guide

1. Open Webhooks: Log in to the Cashfree Dashboard, open Developers, and select Webhooks.
2. Add a webhook endpoint: Click Add Webhook Endpoint.
3. Enter the BuildMyStore webhook URL: In Endpoint URL, enter:
   https://api.buildmystore.io/api/pg-webhook/update-cashfree-payment-status
4. Select the webhook version: Select the latest Webhook Version from the dropdown.
5. Add the policy: Under Add Policy, use the Default retry policy.
6. Select payment events: Select these payment events: Success payment, Failed payment, Refund, and User dropped payment.
7. Save the webhook: Complete the webhook setup and save the configuration.

The BuildMyStore webhook is now configured in Cashfree.

Frequently Asked Questions

You need the App ID and Secret Key provided by Cashfree.

No. After saving the credentials, you must activate Cashfree from the payment gateway settings.

Yes. Use Configure on Web App or Edit on Mobile App to update the credentials.

Troubleshooting

Cause

Payment Gateways may be turned off on Web App, or Online Payment may be turned off on Mobile App.

Solution

Turn on the required payment option and check for Cashfree again.

Cause

The required credentials may not have been saved successfully.

Solution

Enter the App ID and Secret Key, save the credentials, and then activate Cashfree.