接口地址：https://dms-api.shopoint.cn/shopoint-openapis-web/szyx/apiweb/tranx/createrefund
测试地址：https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb/tranx/createrefund
使用场景：调用3.6订单生成接口的订单支付成功后，可使用本接口请求返回的退款单号refundno，完成退款。
请求参数
|
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
|
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
|
orgid |
机构ID |
实际交易的机构ID |
是 |
11 |
服务商appid调用时必填 |
|
cusid |
商户号 |
实际交易的店铺ID |
否 |
11 |
|
|
version |
版本号 |
接口版本号 |
是 |
2 |
默认填11 |
|
trxamt |
退款金额 |
必须小于等于原订单金额，单位为分 |
否 |
16 |
|
|
reqsn |
商户退款订单号 |
商户的退款交易订单号 |
否 |
64(isv:25) |
商户平台唯一 |
|
oldreqsn |
原交易订单号 |
原交易的商户订单号 |
是 |
64(isv:25) |
|
|
oldtrxid |
原交易流水 |
原交易的收银宝平台流水 |
是 |
20 |
oldreqsn和oldtrxid必填其一 |
|
remark |
备注 |
备注信息 |
是 |
50 |
最大50个字节(25个中文字符) |
|
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
|
signtype |
签名方式 |
|
是 |
8 |
支持MD5、RSA、SM2，不填默认MD5 |
|
sign |
签名 |
|
否 |
32 |
详见交易返回码说明 |
|
notify_url |
退款结果通知地址 |
接收退款结果的通知回调地址，通知url必须为直接可访问的url，不能携带参数。https只支持默认端口 |
是 |
256 |
若使用https,需使用默认443端口。若为空，则默认通知到支付接口上送的通知地址 |
响应参数
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|
retcode |
返回码 |
SUCCESS/FAIL |
否 |
8 |
此字段是通信标识，非交易结果，交易是否成功需要查看trxstatus来判断 |
|
retmsg |
返回码说明 |
|
是 |
100 |
|
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
|
cusid |
商户号 |
实际交易的店铺ID |
否 |
11 |
|
|
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
|
orgid |
机构ID |
实际交易的机构ID |
否 |
11 |
|
|
refundno |
退款单号 |
使用此单号在终端完成退款 |
是 |
20 |
|
|
trxamt |
退款金额 |
请求参数trxamt |
否 |
16 |
|
|
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
|
signtype |
签名类型 |
|
否 |
4 |
MD5、RSA、SM2 |
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |