扫码交易退款退票
API说明：支持最大退款期限360天，不支持部分退款，退款成功后会开具红票，仅对蓝票在平台开具的发票生效
调用方式：HTTP协议
API编码：shdzfp.smjytktp
调用方法：POST
数据格式：json
请求报文规范
{
"requestTime": "2025-11-25 08:37:47",
"requestSerialNumber": "退款请求流水号",
"taxCode": "税号",
"refundAmount": "1.00",
"transRequestSerialNumber": "需退款的交易流水号",
"remark": "原样返回"
"riskCheckDataDTO": {
"ipAddr": "192.68.34.22",
"baseStation": "460001039217563",
"latitude": "+37.12",
"longitude": "-121.213"
},
"terminalDeviceInfoDTO": {
"deviceType": "1",
"deviceIp": "10.10.0.1",
"deviceMac": "F0E1D2C3B4A5",
"deviceImei": "460030912121001",
"deviceImsi": "460030912121001",
"deviceIccId": "898600680113F0123014",
"deviceWifiMac": "968778695A4B",
"deviceGps": "20.346790,-4.654321"
}
}
字段说明
| 数据项 |
名称 |
类型 |
长度 |
必须 |
说明 |
| requestTime |
请求时间 |
varchar |
19 |
是 |
yyyy-MM-dd HH:mm:ss |
| requestSerialNumber |
请求流水号 |
varchar |
50 |
是 |
退款请求流水号 |
| taxCode |
税号 |
varchar |
50 |
是 |
|
| refundAmount |
申请退款金额 |
varchar |
14 |
是 |
与原交易请求流水号的订单金额一致 |
| transRequestSerialNumber |
原交易请求流水号 |
varchar |
50 |
是 |
riskCheckDataDTO安全信息
| 数据项 |
名称 |
类型 |
长度 |
必须 |
说明 |
| ipAddr |
ip地址 |
varchar |
32 |
|
IP地址、经纬度、基站地址最少要送其中一项；示例值：192.68.34.22 |
| baseStation |
基站地址 |
varchar |
32 |
|
IP地址、经纬度、基站地址最少要送其中一项； 【mcc】+【mnc】+【location_cd】+【lbs_num】 - mcc:移动国家代码，460代表中国；3位长 - mnc:移动网络号码；2位长； - location_cd：位置区域码，16进制，5位长 - lbs_num：基站编号，16进制，5位长 - 注意若位数不足用空格补足； 示例值：460001039217563,460（mcc),00(mnc),10392(location_cd),17563(lbs_num) |
| latitude |
纬度 |
varchar |
32 |
|
纬度整数位不超过2位，小数位不超过6位；格式：+表示北纬，-表示南纬。示例值：+37.12；IP地址、经纬度、基站地址最少要送其中一项 |
| longitude |
经度 |
varchar |
32 |
|
经度整数位不超过3位，小数位不超过5位；格式：+表示东经，-表示西经。示例值：-121.213；IP地址、经纬度、基站地址最少要送其中一项 |
terminalDeviceInfoDTO设备信息
| 据项 |
名称 |
类型 |
长度 |
必须 |
说明 |
| deviceType |
设备类型 |
varchar |
2 |
|
1:手机，2:平板，3:手表，4:PC；示例值：1 |
| deviceIp |
交易设备IP |
varchar |
64 |
|
用于标识交易设备IP地址，绑卡设备所在的公网IP，可用于定位所属地区，不是wifi连接时的局域网IP。示例值：10.10.0.1（IPv4）；目前暂传IPv4格式。ABCD:EF01:2345:6789:ABCD:EF01:2345:6789（IPv6）； |
| deviceMac |
交易设备MA |
varchar |
64 |
|
示例值：F0E1D2C3B4A5 |
| deviceImei |
交易设备IMEI |
varchar |
64 |
|
移动终端设备的唯一标识；示例值：460030912121001 |
| deviceImsi |
交易设备IMSI |
varchar |
64 |
|
示例值：460030912121001 |
| deviceIccId |
交易设备ICCID |
varchar |
64 |
|
示例值：898600680113F0123014 |
| deviceWifiMac |
交易设备WIFIMAC |
varchar |
64 |
|
示例值：968778695A4B |
| deviceGps |
交易设备GPS |
varchar |
64 |
|
示例值：20.346790,-4.654321 |
返回报文规范
{
"respCode": "00000000",
"respDesc": "交易成功",
"requestTime": "2025-11-25 08:37:47",
"requestSerialNumber": "退款流水号",
"transRequestSerialNumber": "需退款交易的流水号",
"refundFinishTime": "2025-11-25 08:37:48",
"refundState": "S",
"refundAmount": "1.00",
"actualRefAmt": "1.00",
"remark": "原样返回",
"bankMessage": "SUCCESS",
"unconfirmAmt": "1.00",
"fundFreezeStat": "UNFREEZE",
"payChannel": "T"
}
返回字段说明
| 数据项 |
名称 |
类型 |
长度 |
必须 |
说明 |
| respCode |
业务响应码 |
varchar |
8 |
是 |
00000000 交易成功
00000100 交易处理中 |
| respDesc |
业务响应信息 |
varchar |
512 |
是 |
|
| requestTime |
请求时间 |
varchar |
19 |
是 |
yyyy-MM-dd HH:mm:ss |
| requestSerialNumber |
请求流水号 |
varchar |
50 |
是 |
退款流水号，原样返回；示例值：rQ2021121311173944134649875651 |
| transRequestSerialNumber |
原交易请求流水号 |
varchar |
50 |
|
需退款交易的流水号 |
| refundFinishTime |
退款完成时间 |
varchar |
19 |
|
yyyy-MM-dd HH:mm:ss |
| refundState |
退款状态 |
varchar |
1 |
|
P：处理中、S：成功、F：失败； |
| refundAmount |
退款金额（元） |
varchar |
14 |
|
需保留小数点后两位 |
| actualRefAmt |
实际退款金额（元） |
varchar |
14 |
|
需保留小数点后两位 |
| remark |
备注 |
varchar |
84 |
|
原样返回；示例值：备注 |
| bankMessage |
通道返回描述 |
varchar |
256 |
|
示例值：SUCCESS |
| unconfirmAmt |
待确认金额 |
varchar |
14 |
|
待确认金额；单位元。示例值：1.00 |
| fundFreezeStat |
资金冻结状态 |
varchar |
16 |
|
FREEZE：冻结；UNFREEZE：解冻；示例值：UNFREEZE，退款发生时，对应原交易的资金冻结状态 |
| payChannel |
交易通道 |
varchar |
1 |
|
枚举值：A-支付宝、T-微信、U-银联二维码、D-数字货币 |