提交退款申请后，通过调用该接口查询退款状态。退款有一定延时，建议在提交退款申请后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] 否 附加数据，原样返回
memo 扩展信息 string[1,512] 否 json格式，将如下参数转json

memo

变量 参数名 类型[长度限制] 必填 描述
serviceFee 手续费 string[1,16] 否 交易手续费

公共响应示例

{
"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",
"memo":"jsonStr"
}

交易状态码

状态码 描述
INIT 初始化
PROCESSING 处理中
SUCCESS 成功
FAIL 失败

交易响应码

响应码 描述 解决方案
200004 订单不存在
200007 查询成功
200008 查询失败
200009 查询结果集为空
200021 订单号有误或超过查询期限!
200900 该订单不支持退款
200901 不允许结算前退款
200902 该订单正在退款中，请等待退款完成再发起新的退款
作者：xiaochen  创建时间：2025-03-20 15:20
最后编辑：xiaochen  更新时间：2025-07-11 11:53