Refunds

1. Introduction

When the merchant wants to return the funds to their customer, for example, if the customer returned an item, merchant can initiate a refund. Merchant can either do a full refund or a partial refund.

❗️

Important Information

• The refund amount cannot be greater than the transaction amount.

• Merchant can perform multiple partial refunds, as long as the sum of partial refunds does not exceed the original transaction amount.

Understanding the various Refund Status codes:

Refund StatusStatus CodeDescription
CANCELLED0699A transaction which has been initiated for a full refund before it was settled at BillDesk is marked as cancelled. A cancelled transaction does get processed for a refund back to the customer.
REFUND0799When a transaction has been partially refunded before/after settlement or a full refund after settlement is marked as refund.

Refund of Transaction - Validity:

Transaction FlowRefund Applicability on Transactions with Date as
Token based TransactionCurrent Date - Transaction Date <= 180 Days
Guest Checkout TransactionCurrent Date - Transaction Date <= 90 Days

2. Salient Features

  • A single Refund API to initiate refunds across various payment methods i.e. cards/ netbanking/ wallets etc.
  • Allows merchant to automate the process of initiating refunds from their system without needing operations team to do this through the dashboard

3. API Orchestration

The orchestration of the APIs/ workflow has been explained below:

Refund Use Cases:

API Reference

Description

Create Refund

Use the API to invoke the refund workflow. The transaction amount must be less than or equal to the original transaction amount.

For sample code click here.

Retrieve Refund

Use the API to retrieve refund details based on refund id or merchant refund reference number.

For sample code click here.