Skip to main content

申请退款

接口用途

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

接口地址

/payment/refund

请求参数

参数名
 说明 类型 是否必填 备注
bizContent traceNo 交易流水号 String(32) 是 全局唯一，用于标识唯一交易
storeId 商户门店编号 String(32) 是
originalTraceNo 原支付流水号 String(32) 是
originalDate 原交易日期 String(8) 否 传入需要退款的原支付交易日期，不传默认为当天格式为yyyyMMdd
refundAmount 本次退款金额 Number 是 单位分
refundReason 退款原因 String(128) 是

请求示例

"bizContent": {
  "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) 是

返回示例

{
    "data": {
        "traceNo": "20240906NJ0070101960163503934",
        "refundNo": "20240906NJ0070101960163406444",
        "transTime": "2024-07-10 11:28:54",
        "refundAmount": 13,
        "storeName": "xxx昆山首创奥特莱斯店"
    }
}

Back to top