退款查询接口
功能概述
商户通过退款订单查询接口查询首信易支付平台的订单退款信息
接口地址
https://apis.5upay.com/foreignExchange/refundQuery
| 参数名称 |
参数中文名称 |
类型& 长度 |
参数说明 |
是否必填 |
| merchantId |
商户编号 |
varchar(9) |
商户在首信易系统的唯一id，可在商户后台查看 |
M |
| requestId |
订单号 |
varchar(50) |
退款订单号requestId |
M |
| hmac |
参数签名 |
varchar(500) |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
M |
参数示例
<![CDATA[
{
"merchantId": "100000050",
"requestId": "1527756058867",
"hmac": "UZYjA/bik4TNL9aYSHajULOJxDSJkFyYfDNFxJxYCG1Zyi9s16uvSRmj07M3ax76
JG6STpWc/kyb36mWmg8X8gduvd39NupWK/zJErbgYffOmOd6YpmrvTQhbPioxLN8Ras9J9zkL
7uQ3cTOaLAHOeAQh7Aps3EFJ8MMh+sY4UwIl25h3PEkbBy2sBoug+ZpgLYDXTULrBY7OQ7cLT
czfe5DOxJHLGSMpinHaVFOvQaodR8yZdAygDyfDPm16mKDBBV9NsRsGc0pNXZq+gz0hvTq1dL
w+WygTVH8VPFN01bPVHQjxJd3M041kE9ABF/vAP1ExXtSNCevRrAjyyRi4Q=="
}
]]>
退款查询同步返回参数列表
| 参数名称 |
参数中文名称 |
参数说明 |
| merchantId |
商户编号 |
同请求参数 |
| requestId |
退款订单号 |
同请求参数 |
| serialNumber |
退款流水号 |
首信易系统退款流水号 |
| orderId |
原订单流水号 |
原订单支付流水号 |
| status |
退款状态 |
INIT 初始化 |
| SUCCESS 成功 |
| FAILED 失败 |
| amount |
退款金额 |
单位:分，1 元=100 分 |
| currency |
退款币种 |
参考货币列表 |
| completeDateTime |
完成时间 |
退款完成时间 |
| errorMessage |
错误信息 |
错误信息 |
| hmac |
参数签名 |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
示例
<![CDATA[
{
"merchantId": "100000050",
"requestId": "1506333222530",
"serialNumber": "8a7df26c5e74e383015eb87509ab3b4a",
"orderId": "525b756c0800450b9286fbfd297fdb95",
"amount": "10",
"currency": "CNY",
"completeDateTime": "2017-09-25 18:00:03",
"status": "SUCCESS",
"hmac": "UZYjA/bik4TNL9aYSHajULOJxDSJkFyYfDNFxJxYCG1Zyi9s16uvSRmj07M
3ax76JG6STpWc/kyb36mWmg8X8gduvd39NupWK/zJErbgYffOmOd6YpmrvTQhbPioxLN
8Ras9J9zkL7uQ3cTOaLAHOeAQh7Aps3EFJ8MMh+sY4UwIl25h3PEkbBy2sBoug+ZpgLY
DXTULrBY7OQ7cLTczfe5DOxJHLGSMpinHaVFOvQaodR8yZdAygDyfDPm16mKDBBV9NsR
sGc0pNXZq+gz0hvTq1dLw+WygTVH8VPFN01bPVHQjxJd3M041kE9ABF/vAP1ExXtSNCe
vRrAjyyRi4Q=="
}
]]>