提交退款申请后,通过调用该接口查询退款状态。退款有一定延时,建议在提交退款申请后1分钟发起查询退款状态,一般来说余额支付的退款5分钟内到账,银行卡支付的退款1-3个工作日到账。
接口说明
测试请求URL:https://test-api.huishouqian.com/api/acquiring
生产请求URL:https://api.huishouqian.com/api/acquiring
请求方式:POST
公共请求参数
变量 | 参数名 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
method | 方法名 | string[1,32] | 是 | POLYMERIZE_REFUND_QUERY |
version | 版本 | string[1,16] | 是 | 接口版本:1.0 |
format | 请求格式 | string[1,16] | 是 | 业务请求参数格式,支持:JSON |
merchantNo | 商户号 | string[1,16] | 是 | 商户在慧收钱的商户号,由慧收钱生成并下发 |
signType | 加密类型 | string[1,16] | 是 | RSA2:签名机制查看说明 |
signContent | 业务数据 | string | 是 | 业务请求参数 |
sign | 签名数据 | string[1,128] | 否 | 签名数据 |
业务请求参数
变量 | 参数名 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
transNo | 商户订单号 | string[1,64] | 是 | 原退款交易对应的商户订单号 |
公共请求示例
{method=POLYMERIZE_REFUND_QUERY, format=json, signType=RSA2, signContent=【参考业务请求示例】,sign=7ecbad9cb113bd54e6ee45f7fe76883a40428d548b7294ce8f7ba30f211881073820d3ec7a54d3406dcf7a4d3f87f0994c24db54bab430777425147378dbf01afe0491a1c287e5ce380454b0e228a5a20d541874c14addd4100199660e6c4a857fa080ceb4601a0ee21e3fab9d87016198f151a3b16f60a254c1e8b4cd42cdf7, version=1.0, merchantNo=814000473149}
业务请求示例
{
"transNo":"DD20210812103012841"
}
公共响应参数
变量 | 参数名 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
success | 响应状态 | string[1,32] | 是 | 服务端响应状态,如果为true,则可以调用result;如果为false,则调用errorCode来获取出错信息 |
errorCode | 错误码 | string[1,32] | 否 | 响应码 |
errorMsg | 错误描述 | string[1,128] | 否 | 响应描述 |
result | 响应内容 | string | 否 | 业务响应参数 |
sign | 签名数据 | string[1,128] | 否 | 响应验签数据 |
业务响应参数
变量 | 参数名 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
merchantNo | 商户号 | string[1,16] | 是 | 商户在慧收钱的商户号,由慧收钱生成并下发 |
transNo | 商户订单号 | string[1,64] | 是 | 退款请求的商户订单号 |
origTransNo | 原商户订单号 | string[1,64] | 是 | 原支付交易对应的商户订单号 |
tradeNo | 交易订单号 | string[1,32] | 是 | 慧收钱系统交易订单号 |
orderAmt | 退款金额 | string[1,16] | 是 | 退款金额,单位:分 |
orderStatus | 退款状态 | string[1,16] | 是 | 退款状态,详见交易状态码 |
finishedDate | 完成时间 | string[1,14] | 否 | 退款完成时间,格式[yyyyMMddHHmmss] 示例:20190101140908 |
respCode | 响应码 | string[1,32] | 是 | 详见交易响应码 |
respMsg | 响应描述 | string[1,128] | 是 | 详见交易响应码 |
extend | 附加字段 | string[1,128] | 否 | 附加数据,原样返回 |
公共响应示例
{
"success":true,
"result":"【业务响应示例】",
"errorCode":null,
"errorMsg":null,
"sign":"88faca1f2511cc194367ffd96aa78a4cdf25a8284b0cd74b75e331b37c642b26aaeb46f2e4be38080eeb2b78575abd715d58fd30bbf59e167d64d0b714487f9462381e499a48524b1704694f256fa8f6e917d33cd413e365872ef2c7eede37ab4b23f67dcf6f34ec0daf65a34502123f792a646bea6447c126a612087825b17b91e585f74e56220328b198982e62a734387cd8556927e6881878b821969b6e784a20771cf55fad70a4368b8650c0ece0a7903678e1ad6134f6c711329a3e3e456c28ffbfc607fa6bf1f969a4d38b35ca3bf9ad81f71b2d2ad816502d579c0c4fc1f1fccec74a861c4679c5217be0176bf1eebcb57aea381f922fcf920aa471198be972f0c4f9fab10f7885b9c09eda977351b40e9058247ec30da55dd4c0be4a9de7d996e186e9f9ff2693f564f0eaddca9d7ff9f3b813d0c70bdba75b2a1bf9bd4ddf28ff66c45d6ce31e188d8606c82078d842008a9a1b4c1b64b7b2d3632087e46bbc4322181a9832cecd852682fdb72d336b32512bde94e81ba322fe9d2d"
}
业务响应示例
{
"extend":"自定义参数",
"finishedDate":"",
"merchantNo":"814000473149",
"orderAmt":"1",
"orderStatus":"PROCESSING",
"origTransNo":"DD20210812102555029",
"respCode":"100201",
"respMsg":"交易处理中,请稍后查询",
"tradeNo":"12000020210812102438004012382163",
"transNo":"DD20210812103012841"
}
交易状态码
状态码 | 描述 |
---|---|
INIT | 初始化 |
PROCESSING | 处理中 |
SUCCESS | 成功 |
FAIL | 失败 |
交易响应码
响应码 | 描述 | 解决方案 |
---|---|---|
200004 | 订单不存在 | |
200007 | 查询成功 | |
200008 | 查询失败 | |
200009 | 查询结果集为空 | |
200021 | 订单号有误或超过查询期限! |
作者:xiaochen 创建时间:2023-05-15 11:12
最后编辑:admin 更新时间:2024-10-21 15:45
最后编辑:admin 更新时间:2024-10-21 15:45