跳转至

申请退款

请求方式 body 编码 接口地址
POST application/json UTF-8 集测:https://mchapitest.shengpay.com/olbank/refund
生产:https://mchapi.shengpay.com/olbank/refund

请求参数

变量名 类型 必填 示例值 描述
mchId String(16) Y 93751497 商户号
mchOrderNo String(50) Y 退款订单号/请求号(只允许使用数字、字母,确保在商户系统唯一)
oriMchOrderNo String(50) Y 商户订单号(原交易订单号)
amount int Y 退款金额(单位:分)
backUrl String(256) Y 服务端通知地址
nonceStr String(32) Y pWUVWVYWNQhnTXpQzhIzMGCwqBkZclzg 随机字符串
signType String(8) Y RSA 签名类型
sign String (1024) Y 签名

请求示例

1
2
3
4
5
6
7
8
9
{
    "amount":"1",
    "mchId":"88021534",
    "mchOrderNo":"20211023070252",
    "nonceStr":"XKAOTCDRKTHR",
    "oriMchOrderNo":"1617846686368",
    "sign":"C+ir1eMWvMn4FGYOstIuXHhjp1JiJs5ZIHmRn2cK57nkkrzLpXbmyTP7GSroeuz0h1mWBNegNWzkrVAgHyA1gQp+T3DiK8AYQEFS5uXOLEwW44vXajZEkZ7I2c7Q/wL6uLA11jVbQd/RIb/YlI7QYIVL/NgCoIHDe0iyj2321Uc=",
    "signType":"RSA"
}

响应参数

变量名 类型 必填 示例值 描述
returnCode String Y SUCCESS 返回码(SUCCESS/FAIL)
returnMsg String N 返回消息(当returnCode为FAIL时使用)
resultCode String Y SUCCESS 业务结果(SUCCESS/FAIL)
errorCode String N 错误代码(当resultCode为FAIL时使用)
errorCodeDes String N 错误描述(当resultCode为FAIL时使用)
mchId String(16) Y 93751497 商户号
transactionId String(32) Y 盛付通订单号
refundAmount int Y 退款金额(单位:分)
transTime String(14) Y 20110808112233 交易完成时间(格式:yyyyMMddHHmmss)
nonceStr String(32) Y 随机字符串
signType String(8) Y RSA 签名方式
sign String (1024) Y 签名

响应示例

1
2
3
4
5
6
7
8
{
    "nonceStr":"TVBQsuWQLhIoNfrCgVeJkASFQGZzorzq",
    "refundAmount":"1",
    "resultCode":"SUCCESS",
    "returnCode":"SUCCESS",
    "signType":"RSA",
    "transactionId":"T648780750531330049"
}
Back to top