申请退款
接口用途
当用户或商户要进行支付后退款时调用此接口
接口地址
请求参数
参数名 |
说明 |
类型 |
是否必填 |
备注 |
traceNo |
交易流水号 |
String(32) |
是 |
全局唯一,用于标识唯一交易 |
storeId |
商户门店编号 |
String(32) |
是 |
|
originalTraceNo |
原支付流水号 |
String(32) |
是 |
|
originalDate |
原交易日期 |
String(8) |
否 |
传入需要退款的原支付交易日期,不传默认为当天格式为yyyyMMdd |
refundAmount |
本次退款金额 |
Number |
是 |
单位分 |
refundReason |
退款原因 |
String(128) |
是 |
|
请求示例
{
"traceNo": "20240906NJ0070101960163503934",
"storeId": "111301",
"originalTraceNo": "20240906NJ0070101960163406444",
"originalDate": "20240906",
"refundAmount": 13,
"refundReason": "正常退款"
}
返回参数
参数名
|
说明 |
类型 |
是否必填 |
备注 |
data
|
traceNo |
交易流水号 |
String(32) |
是 |
全局唯一,用于标识唯一交易 |
refundNo |
收单机构退款单号 |
String(40) |
否 |
|
transTime |
交易时间 |
datetime |
是 |
|
refundAmount |
退款成功总金额 |
Number |
是 |
单位分 |
storeName |
交易门店名称 |
String(200) |
是 |
|
返回示例
{
"traceNo": "20240906NJ0070101960163503934",
"refundNo": "20240906NJ0070101960163406444",
"transTime": "2024-07-10 11:28:54",
"refundAmount": 13,
"storeName": "xxx昆山首创奥特莱斯店"
}