Settlement

1. Introduction

The BillDesk Settlement API allows merchant to query for the settlement and its related details. BillDesk shares the settlement report with the merchant that has details about the transactions (successful, refunded and chargebacks).

To retrieve details on the settlement amount for transactions done their website/ app, merchant needs to usee Retrieve Settlement API. Merchant can retrieve the settlement report by simply providing merchant id & date range. Another option is to retrieve settlement report by sending the payment voucher number along with merchant id.

Merchant can retrieve individual records of a settlement by using the Retrieve Settlement Details API by providing the merchant id and the unique payment voucher number.

2. Salient Features

  • Allows merchant to automate the process of settlement within their system without needing operations team to do this through the dashboard

3. API Orchestration

Depending on the settlement process, the orchestration of the APIs/ workflow has been explained below:

API Reference

Description

Retrieve Settlement API

(Settlement)

Merchant can retrieve the settlement through the Retrieve Settlement API by providing:

• Merchant id & required date range.
• Merchant id & payment voucher number.

Understanding the various Retrieve Transaction Status codes

StatusStatus CodeDescription
SUCCESSFUL0300A transaction which has been initiated at BillDesk is marked as successful.
PENDING0002A transaction which has been initiated but is in pending status.
FAILED0399A transaction which has been initiated but is in failed state

4. Reports

Merchant can download the reports from the dashboard provided to by the designated BillDesk RM. The details of the report are mentioned here.