Get Started

Before merchant starts with understanding of the API integration, BillDesk would like merchant(s) to go through the steps/pre-requisites included to complete the onboarding process with BillDesk.

Step 1: Get merchant BillDesk credentials

Please reach out to the designated BillDesk Relationship Manager to raise a request for UAT access.

Merchant will receive the following two values as part of UAT setup confirmation:

Parameters	Description
mercid	BillDesk assigned Merchant ID (mercid) for the UAT setup. mercid is a mandatory parameter in all APIs.
clientid	clientid is an unique value shared with merchant by BillDesk.
encryption key	encryption key is an unique value to merchant's integration and are needed to encrypt and decrypt API requests.
signing key	signing key is an unique value generated by BillDesk and is needed to sign an encrypted request.

❗️
Important Information
• The clientid, encryption key and signing key are confidential, must only be shared with authorized personnel.
• One webhook URL can be configured for a particular merchant id.

Step 2: Whitelist the merchant IP addresses

All API calls to BillDesk can only be initiated through whitelisted IP addresses (multiple allowed) which are used by merchant systems. These IP addresses can be whitelisted instantly on the BillDesk UAT portal.

Designated BillDesk Relationship Manager will assist with whitelisting of the IP addresses.

Step 3: Configure a URL to receive webhooks

Once the end customer completemerponse to this Webhook URL, which can be used to update the status of the transaction at merchant end.

Designated BillDesk Relationship Manager will assist the merchant with configuring this webhook URL.