Introduction

Add the BillDesk EDD plugin to any WordPress site and set up payments for the merchant's store in minutes.

Merchant can download the plugin with the following link.

Prerequisites

Merchant needs to install and activate EDD version 3.4.0 Plugin - Easy Digital Downloads Plugin (https://wordpress.org/plugins/easy-digital-downloads/) and PHP version 8.1.

1. Dependency:
   • Set country to India in Downloads → Settings → General → Store. Choose Business Country as India.

2. Set Currency to Indian Rupee in Downloads → Settings → General → Currency.

3. Time zone: From Settings menu of WordPress, select Sub-menu General and change the time zone to Kolkata.

Integration Steps

Installation and Activation

Follow the steps below to install and activate the BillDesk EDD plugin.

Installation

The plugin can be installed in two ways:

• Uploading the plugin from the admin panel in Plugins → Add New → Add Plugins → Upload Plugin.

  • Choose the EDD BillDesk plugin file and click on Install Now.
  

• Manually installing the plugin in WordPress:

  • Extract the shared plugin archive file and copy it to wp-content/plugins/ folder within the WordPress deployment.

Activation

• Click on Activate Plugin.

• Installation Successful!

Plugin Configuration

After the plugin is activated, the merchant will need to configure the plugin to work.

1. Click on Downloads → Settings to configure the plugin.

2. Set Currency:
   1. Go to Settings → General → Currency option.
   2. Set Currency option as Indian currency (INR).

2. Click on Payments tab → Payment Gateways → select BillDesk Payment Integration as the default option.

Ensure that the merchant has obtained the necessary details like Merchant ID, Merchant Key, etc. from BillDesk. The configuration page will be as shown below:

• Merchant Id - string - This is the unique ID created by BillDesk to identify the merchant.

• Client Id - string - A client ID shared by BillDesk for accessing the Payment Gateway APIs.

• Key ID - string - The unique identifier of the public key shared by BillDesk

• Encryption Password - string - An encryption key that is used to protect the communication with Payment Gateway APIs.

• Signing Password - string - A signing key that is used to protect the communication with Payment Gateway APIs.

• Item Code - string - Item Code as shared by BillDesk team.

• Merchant Logo - string - A URL or Base64 encoded logo of the merchant that will be visible on the payment dialog.

• Payment Category - string - Merchant can configure Allowed Payment categories at the BillDesk backend. This ensures that only the configured payment categories enabled for the merchant will be displayed. However, this option also allows the merchant to override the payment category configuration.

  For example, if a merchant wants to show cards as the only payment option, they can configure it using this setting. Merchant must mention all allowed payment methods as comma-separated values.

  Note: Payment methods can have dynamic names. The valid payment category codes are as follows:
  Allowed values: [card, emi, nb, upi, wallets, qr, gpay]

• Retry Count - number - Controls the number of payment re-attempts that should be allowed to users on failed payment.

• Child Window - number - Enables or disables the child window.

  • True/Enabled - If it is enabled, the modal opens the bank's page for processing in another window.
  
  • False/Disable - If it is disabled, the modal redirects the merchant page to bank URLs for processing instead of opening it in another window.
  

• Environment - string - Enables switching between the UAT or Production environments. Depending on this configuration, the plugin will connect to the UAT or production URLs.

• TEST PG CONNECTIVITY - Confirm the successful configuration by clicking on 'Test PG Connectivity'. If the configuration was not successful, check Troubleshooting for error code analysis.

4. Click Save Changes.

👍

Success

At this stage, the BillDesk extension is fully configured. Merchant can now accept payments via the BillDesk payment integration.

Features

Payment

Add New Product

1. Click Add New from the sidebar to create a new page. Add product description and pricing as required.

2. Upload the file.

3. Click Publish.

4. Click Permalink.

5. Easy Digital Downloads Checkout page

Accepting Payments - User Flow

• Customers can initiate payments via BillDesk from the Easy Digital Downloads Checkout page.
• After completing the payment, they will be redirected to the Success page.
• The user flow is shown in the following screenshots:

Refund

Merchant can create a process for managing refunds by following the steps given below.

Refund Process

1. In Downloads, click on Payment History.

2. Click on View Order Details and select any transaction with "Completed" status.
3. In Status, select Refunded from the drop-down list.
4. Select the "Refund Charge in BillDesk" check box.
5. Click on Save Payment.

Order Listing

Merchant can view their order details in Order History. There is an additional menu in EDD.

Payment History

1. Click Payment History to view order information of the plugin.

📘

Note

Merchant will get detailed information about the transactions and their current status.

Troubleshooting

EDD plugin logs are present in logs/edd_billdesk-yyyy-mm-dd.log, where the merchant can check the reason of failure.

To confirm that PG connection is established, go to the Configuration page and click on TEST PG CONNECTIVITY.

Case 1: PG connectivity is successful.

Case 2: PG connectivity is unsuccessful.

If an error occurs during the connection, please refer to the following table: