退款结果通知

请求方式 body 编码
POST application/json UTF-8

通知确认:直接response返回SUCCESS,如果返回非SUCCESS,将会持续接收相同通知,累计10次,逐步增加步长

字段名 变量名 必填 类型 示例值 描述
returnCode 返回码 Y String(32) SUCCESS SUCCESS/FAIL 此字段为业务交互通信标志
returnMsg 返回消息 Y String(32) OK 当returnCode为FAIL时,返回错误信息
resultCode 业务结果 Y String(32) SUCCESS SUCCESS/FAIL
errorCode 错误代码 N String(32) 当resultCode为FAIL时,errorCode必填
errorCodeDes 错误描述 N String(64) 当resultCode为FAIL时,errorCodeDes必填
appId appId N String(32) 当resultCode为SUCCESS时,appId必填
mchId 商户号 N String(32) 当resultCode为SUCCESS时,mchId必填
transactionId 连尚支付订单号 Y String(32) 当returnCode和resultCode为SUCCESS时,transactionId必填
outTradeNo 商户订单号 Y String(32) 当returnCode和resultCode为SUCCESS时,outTradeNo必填
outRefundNo 商户退款订单号 N String(32) 当returnCode和resultCode为SUCCESS时,outRefundNo必填
refundId 连尚退款订单号 N String(32) 当returnCode和resultCode为SUCCESS时,refundId必填
refundFee 退款金额 N Int 当returnCode和resultCode为SUCCESS时,refundFee必填
settlementRefundFee 实际退款金额 N Int 当returnCode和resultCode为SUCCESS时,settlementRefundFee必填
totalFee 支付订单金额 N Int 当returnCode和resultCode为SUCCESS时,totalFee必填
settlementTotalFee 实际结算金额 N Int 当returnCode和resultCode为SUCCESS时,settlementTotalFee必填
refundStatus 退款状态 N String(16) 当returnCode和resultCode为SUCCESS时,refundStatus必填 SUCCESS-退款成功, REFUND_CLOSE-退款关闭, PROCESSING-退款处理中, CHANGE-退款异常,退款到银行发现用户的卡作废或者冻结了,导致原路退款银行卡失败
refundSuccessTime 退款成功时间 N String(14) 当returnCode和resultCode为SUCCESS时,并且退款成功时,refundSuccessTime必填 时间格式:yyyyMMddHHmmss
refundRequestSource 退款发起来源 N String(30) API
nonceStr 随机字符串 Y String(32)
signType 加签方式 Y String(10) RSA 目前只支持RSA
sign 签名 Y String(500)