退款查询¶

服务商可通过此接口对交易结果未知的退款交易发起交易查询。

可支持通过 req_seq_id （请求流水号）、hf_seq_id （汇付返回的流水号）、out_ord_id （机具商户外部订单号）、mer_ord_id （商户订单号）来进行查询

请求参数¶

请求地址

https://spin.cloudpnr.com/topqur/refundQuery

公共请求参数

请求报文头HEADER - 「接口规则-参数规定-报文头」，请求报文体BODY - 「接口规则-参数规定-报文体」，响应报文体 - 「接口规则-参数规定-响应报文体」

请求参数(data)

参数	中文名	类型	必填	最大长度	说明
huifu_id	汇付商户号	String	Y	32	汇付分配的商户号
req_date	原始退款请求日期	String	Y	8	请求时间YYYYMMDD
sys_id	系统号	String	Y	32	系统号
mer_ord_id	原退款商户订单号	String	N	128	4选1
req_seq_id	原始退款请求流水号	String	N	128
hf_seq_id	原退款汇付流水号	String	N	128
out_ord_id	原退款商户外部订单号	String	N	32

响应参数¶

响应参数(data)

参数	中文名	类型	必填	最大长度	说明
sub_resp_code	业务返回码	String	Y	8	见附录业务返回码
sub_resp_desc	业务返回描述	String	Y	512	业务返回描述
req_seq_id	请求流水号	String	Y	128	请求流水号
req_date	请求日期	String	Y	8	请求日期
hf_seq_id	汇付流水号	String	Y	128	汇付流水号
product_id	产品号	String	Y	40	产品号
mer_ord_id	商户订单号	String	Y	32	即商户支付订单号，商户传入时保证唯一格式：数字+字母
org_req_seq_id	原交易请求流水号	String	N
org_req_date	原交易请求日期	String	N
trans_date	交易发生日期	String	Y		YYYYMMDD
ord_amt	退款金额	String	Y		单位元，需保留小数点后两位，例如： 1.00
trans_time	交易时间	String	N	12	交易发生时间，HHMMSS
huifu_id	商户号	String	Y	32	汇付分配的商户号
trans_stat	交易状态	String	N	1	S-退款成功 F-退款失败 P-退款处理中
bank_code	通道返回码	String	N	64
bank_message	通道返回描述	String	N	256
bank_type	收单银行	String	N		具体参考双联银行对照表
actual_ref_amt	实际退款金额	String	N		实际退款金额
acct_split_bunch	分账串	JSON	N		见附录返回分账串
trans_finish_time	退款完成时间	String	N	14	时间格式yyyyMMddHHmmss

请求示例¶

{
            "sys_id":"test",
    "sign_type":"RSA2",
    "sign":"TEST_SIGN",
    "data":"{\"sys_id\":\"test\",\"req_date\":\"20200317\",\"huifu_id\":\"6666000001016747\",\"req_seq_id\":\"2540303057457699\",\"mer_ord_id\":\"2540303057457699\",\"hf_seq_id\":\"\"}"
}

响应示例¶

{
    "data": "{\"hf_seq_id\":\"\",\"huifu_id\":\"6666000001016747\",\"mer_ord_id\":\"2540303057457699\",\"req_date\":\"20200317\",\"req_seq_id\":\"2540303057457699\",\"sub_resp_code\":\"20000004\",\"sub_resp_desc\":\"交易不存在\"}",
    "resp_code": "10000",
    "resp_desc": "成功调用",
    "sign": "AJvJd55M3YxEP8oQIl8EcDj0OMHN/30ijcMVwU5LnVqWp5zDZDKr3CqTT4siWsui9MU99Kxki6m2fS2IzMkqKYG4N/LiuzOuxA7f8NyoHrvuLRv+079usESmBJT78LyDJi7mz7iiLL7JAOIDgyTOmUn9jDuLEniHm1IA0WdA3issACWVPb7zkINlHPkw8p0AWiFhn0GC0IgZ/DydC1RAb7MNULtrzKNiIzMctL8BBzEMl37PmNhIuhyVpJPy9k45JVUEFXlJGSCXSS9uFjHywc7ewHrm1QmfysZ74VJi4OmtQGkN7n9EdQUjs/htXY4oaQ6XuICEp+Oaac30VqsYsw=="
}

接口调用实例

Demo参考