Guides

PrestaShop

Introduction

PrestaShop helps merchants set up a user-friendly store in minutes. Add the BillDesk PrestaShop plugin to seamlessly accept payments through this store.

Merchant can download the plugin with the following link.

Prerequisites

Ensure that the merchant has downloaded, installed, and configured:

  • Prestashop version 8.1.7 plugin
  • PHP version 8.1

To add currency as 'Indian rupee':

  • Navigate to Dashboard → International → Localization → Currencies.
  • Click on Add new currency button.
  • Enter details and click on Save.
  • Set the default configuration for country, currency, and time zone.

Integration Steps

Follow the steps below to install and activate/ configure the BillDesk PrestaShop plugin.

Installation

To integrate the BillDesk payment integration into the PrestaShop website, the merchant needs to go to Modules → Module manager in the side menu bar and click on the Upload a module button.

  • Choose the PrestaShop BillDesk plugin file to complete installation.

The module has been successfully installed.

  • Click on Configure button to initiate configuration.
  • Alternatively, the merchant can also review the module added by clicking on Modules→ Module Manager → Payment.
  • Click on Configure button to initiate configuration.

Configuration

  • Click on Modules → Module Manager → Payment.
  • Click on the Configure button.

Enter BillDesk Payment Integration details.

The configuration page looks as below:

Note: Make sure the merchant has received the required details such as merchant ID, merchant key, etc. from BillDesk.


  • 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.

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

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

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

  • Payment Category - string - This option allows to configure payment categories. Suppose if a merchant only wants to show cards as a payment option, then it can be controlled using this configuration. All allowed payment methods need to be mentioned separated by a comma. Note that since the payment methods name can be dynamic, there is no validation for this input at this moment. Valid payment category code are as follows:

    • card - Credit/Debit Card
    • emi - EMI
    • nb - Netbanking
    • upi - UPI
    • wallets - Wallets
    • qr - QR Code
    • gpay - Google Pay

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

  • Child Window - number - Modal redirects the merchant page to bank URLs for processing the payment. “Child window” parameter gives an option to control the window in which OTP 2FA (Two factor authentication) screen will open.

    • True - In this case, the new window will open for OTP 2FA screen.
    • False - In this case, the OTP 2FA screen will open in the same window.

  • 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.

👍

Success

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

Features

Payment

To make a successful transaction

  1. Login or Create account.
  2. Go to "Your Store".
  3. Add a product in the cart and click on Checkout for Purchase.
  4. Enter details in Personal Information, Addresses, and Shipping Method, and click on Continue.
  5. In Payment section, select BillDesk Payment Integration and agree to the terms of service.
  6. Click on PAY BY BILLDESK.
  1. BillDesk payment options modal screen will launch.
  1. After the transaction is successful, the below screen will be displayed:

Refund

Product Refund

  • Click on Sell → Orders.
  • Change the status to 'Refunded' from the drop-down list of the particular order for which a refund is required.

Note that the refund can be made for orders with the status 'Payment accepted'.

Order Listing

View Order Details

Merchant can view details of the orders by going to the Your account page and clicking on Order history.

👍

Success

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

Troubleshooting

In Prestashop, logs can be viewed under Configure → Advanced Parameters→ Logs where the merchant can check for failure of reason.

Updated 22 days ago