Body
Merchant Refund 360
This api can be used to trigger a refund against a successful merchant transaction. There are two types of refunds supported - ONLINE and OFFLINE.
Refund360 will be used for initiating a new refund or getting the status of an existing refund. If the "refundRequestId" is present with the PSP, then the latest status of the existing refund will be returned. If not present, then a new refund will be triggered.
ONLINE refunds get credited to remitter account instantly, whereas OFFLINE refunds take around 2-3 working days.
Note
This is an idempotent api.
Request
Response
API Endpoints
Production Link
POST
{{host}}/api/{{uri}}/merchants/transactions/refund360
Headers
jpupi-routing-id
*
String
Mandatory
For a Refund on a mandate execution related transactions, the Header value should be same as of originalMandateMerchantRequestId sent in request body.
For a Refund on other transactions, the Header value should be same as of originalMerchantRequestId sent in request body
Basic Params
originalMerchantRequestId
String
Optional But Mandatory For New Integration
merchantRequestId of the original transaction against which refund is being initiated.
refundRequestId
*
String
Mandatory
Merchant generated unique id for the refund.
Constraints: Max 35 characters alphanumeric, can also contain hyphen(-), dot(.) & underscore(_)
refundType
*
String
mandatory
Type of refund being initiated.
Constraints: OFFLINE, ONLINE
refundAmount
*
String
Mandatory
The amount to be refunded
Constraints:String with mandatory two decimals
merchantRefundVpa
String
Conditional
Merchant refund vpa that is to be used for online refund.
Constraint: mandatory for refundType = ONLINE
remarks
*
String
Mandatory
Remarks or reason for the refund.
Constraints: The transaction note must be alphanumeric, with a minimum length of 1 character and a maximum length of 50 characters.
originalTransactionTimestamp
String
Optional
Timestamp of the original transaction. Passing this parameter will help PSP to optimize the refund request to reduce the latency of this api.
Formate: YYYY-MM-DDTHH:MM:SS+05:30
iat
*
String
Mandatory
Current Epoch Unix timestamp string. Has to be of 13 digit in Milliseconds.
Example: 1496918882000.
udfParamters
Stringified JSON
Optional
Merchant Defined Parameters
Example: "{\"udf1\":\"value1\",\"udf2\":\"value2\",…}"
Note: Few special characters are not allowed. Regex for the characters which are not allowed : ^[^/#-()*!%~`]+$
Split Settlement Params
splitSettlementDetails
json String
optional
Split Settlement details of merchant and partners for this transactions
splitType
*
String
Mandatory
The type of split for this transaction. Can be AMOUNT, PERCENTAGE, DEFAULT, LATER.
merchantSplit
String
Optional
Split share for merchant pool account.
partnersSplit
String
Conditional
List of partners for which the split needs to be divided with the value.
partnerId
*
String
Mandatory
The LSP id provided by the bank.
value
*
String
Mandatory
Split share for LSP account. Decimal Value
Dynamic VPAs
upiRequestId
*
String
Mandatory
In case of dynamic Vpa resolution, pass this field.
200 : Success
Response Body
status
*
String
Mandatory
PSP status of the API.
Values: SUCCESS | FAILURE.
responseCode
*
String
Mandatory
PSP response code for the API.
Values: Refer Codes Guide in Resource Section.
responseMessage
*
String
Mandatory
PSP response message for the API.
Values: Refer Codes Guide in Resource Section.
payload
*
Json
Mandatory
merchantChannelId
*
String
Mandatory
Unique id for the merchant channel.
Values:As passed in request headers.
gatewayResponseStatus
*
String
Mandatory
Response status returned by gateway for the refund.
Values:String (SUCCESS, PENDING, DEEMED, FAILURE).
merchantId
*
String
Mandatory
Unique id for the merchant.
Values:As passed in request headers.
gatewayRefundReferenceId
*
String
Mandatory
Reference id returned by the gateway for the refund.
gatewayResponseMessage
*
String
Mandatory
Response message for code returned by gateway for the refund.
merchantRequestId
String
optional
merchant request id of original transaction.
Mandatory for x-api-version > 0.
gatewayResponseCode
*
String
Mandatory
Response code returned by gateway for the refund.
gatewayTransactionId
*
String
Mandatory
UPI request id returned by gateway for the transaction.
Values:Same as originalUpiRequestId passed in request.
refundAmount
*
String
Mandatory
The amount to be refunded.
Values:As passed in the request body.
refundRequestId
*
String
Mandatory
Merchant generated unique id for the refund.
Values:As passed in the request body.
transactionAmount
*
String
Mandatory
The total amount for which original transaction was performed.
Values:String with mandatory two decimals.
refundTimestamp
*
String
Mandatory
Timestamp of when refund request was initiated.
Formate: String (YYYY-MM-DDTHH:MM:SS+05:30).
refundType
*
String
Mandatory
Type of refund being initiated.
Values:As passed in the request body.
splitSettlementDetails
json String
optional
Split Settlement details of merchant and partners for this transactions.
partnersSplit
String
Conditional
List of partners for which the split needs to be divided with the value.
partnerId
*
String
Mandatory
The LSP id provided by the bank.
value
*
String
Mandatory
Split share for LSP account. Decimal Value.
splitType
*
String
Mandatory
The type of split for this transaction. Can be AMOUNT, PERCENTAGE, DEFAULT, LATER.
merchantSplit
String
Optional
Split share for merchant pool account.
riskScore
String
Optional
RiskScore shared by NPCI or Bank
gatewayRefundTransactionId
String
Optional
UpiRequestId for the refund
Example:- Values: As passed in the request body in refundUpiRequestId.
udfParameters
stringified JSON
optional
Merchant Defined Parameters
Example: "{\"udf1\":\"value1\",\"udf2\":\"value2\",…}"