UPI Refunds

Enable merchants to refund payments, either the full amount or parts of the payment.

UPI supports following refund types :

  • Partial Refund
  • Multiple partial refunds
  • Full refund

Merchant Journey

  1. Merchant initiates refund with desired details (refund amount , currency, response code)
  2. Refund request is created with UPI
  3. Refund status is forwarded to merchant

For standard refund handling, check Refund Handling

Specific input parameters for the TRANSACTION call

Field NameM/O/CTypeRegexDescription
reasoncodeMasciiN/Areason code associated with the initiated refund, reason code mapping to reason description is given below

REFUND CALL INPUT

returnmode=urlencodeext
&txtype=REFUND
&login=testclient
&password=test123
&contractid=TESTCONTRACT
&reftxid=123887123
&currency=USD
&amount=100
&specin.reasoncode=1061
&merchantrefundid=MS123R

There needs to be a reason code for each refund , please use the below guide to derive reason code:

Reason CodeReason Description
1061Credit not processed for cancelled or returned goods and services
1062Goods and Services not as described / defective
1063Paid by alternate means
1064Goods or Services Not Provided / Not Received
1065Account debited but transaction confirmation not received at merchant location
1093Credit not Processed
1090Others
1094Beneficiary bank unable to credit their customer account
1092Card holder was charged more than the transaction amount
1091Non Matching account number
1084Duplicate /Multiple Transaction

REFUND CALL OUTPUT

When refund request is successful

STATUS=SUCCEEDED
&RAND12346789=dd69b8124a89415e0390a5a95b087c93a9b7769e
&REFUNDID=223887123
&MERCHANTREFUNDID=MS123R
&ERRMSG=

When refund request is not successful

STATUS=FAILED
&REFUNDID=0
&MERCHANTREFUNDID=MS123R
&ERRMSG=Transaction%20not%20found
&FAILREASON=INPUT_DATA
&RAND4874524632=d3534885f2975b9852970607c054dd2cddbf2c48