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) 全局唯一,用于标识唯一交易
transactionNo 易百交易号 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昆山首创奥特莱斯店"
    }
}