Skip to main content

申请退款

接口用途

当用户或商户要进行支付后退款时调用此接口

接口地址

请求参数

参数名 说明 类型 是否必填 备注
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昆山首创奥特莱斯店"
}