线上退款查询接口¶

本 API为后台版，用于查询单笔线上退款状态及明细。

线上交易指：快捷支付页面版、网银支付页面版、手机网页支付接口。

请求参数¶

请求地址

https://spin.cloudpnr.com/top-online-ser/refundQuery

公共请求参数

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

请求参数(data)

参数中文名称	参数名称	数据格式	是否必须	说明
商户号	huifu_id	变长32位String	必须
原请求日期	req_date	定长8位String	必须	YYYYMMDD
原请求流水号	req_seq_id	变长64位String	可选	req_seq_id、hf_seq_id 至少填一
原汇付流水号	hf_seq_id	变128位String	可选	req_seq_id、hf_seq_id 至少填一

响应参数¶

同步响应参数（data）

参数	中文名	类型	必填	最大长度	说明
sub_resp_code	返回码	String	Y	8	业务返回码
sub_resp_desc	返回描述	String	Y	512	业务返回描述
req_seq_id	请求流水号	String	Y	64
req_date	请求日期	String	Y	8
product_id	产品号	String	Y	32
huifu_id	商户号	String	Y	32
hf_seq_id	汇付流水号	String	N	128
org_req_seq_id	原交易请求流水号	String	N	64
org_req_date	原交易请求日期	String	N	8
org_ord_amt	原交易订单金额	String	N	14	单位元，需保留小数点后两位，例如： 1.00
org_fee_amt	原交易订单手续费金额	String	N	14	单位元，需保留小数点后两位，例如： 1.00
ref_cnt	累计退款次数	String	N	11
ref_amt	累计退款金额	String	N	14
ref_fee_amt	累计退款手续费	String	N	14
ord_amt	退款金额	String	N	14	单位元，需保留小数点后两位，例如： 1.00
trans_date	交易发生日期	String	N	8
bank_code	通道返回码	String	N	8
bank_message	通道返回描述	String	N	128
trans_stat	交易状态	String	N	1	P：处理中，S：成功，F：失败
actual_ref_amt	实际退款金额	String	N	14	单位元，需保留小数点后两位，例如： 1.00
mer_priv	商户私有域	String	N	1024
trans_type	交易类型	String	N		TRANS_REFUND
acct_split_bunch	分账串	JSON	N		返回分账串

请求示例¶

{
    "sign": "gV+Cvn4joqjQweXIPC4ZPGUC4rrPnb92viI7y0QOVOurbVUuyextemZXwysL5+TmtGzTfv1f5C7mR2p36LfHkuj2VdNbt8GgCWafNvWDn5kKej82mRPPBZA0qtVd0F+s6ndw2OkeqV3wUSj7yXg9khPblMZyMcqLP0gzSEtKYAnVvsWQBub7+5ZHmhf2q8u6/QkvPPEWMVe6W5SX0RqJYxbMASIf9EVBEbs0XGrpGuVxmCPRpHnpJmulPWPucdgixZKkfL6X2tebYAHCjn0DC+Yv7nr4jv1tOZGtzB/DuLNtq5g/pW2Pip9T9In/ZQYPkYYby2xRNXT0tQcghi9mZA==",
    "sign_type": "RSA2",
    "sys_id": "TEST",
    "data": "{\"req_seq_id\":\"refund20201215wap0001\",\"req_date\":\"20201215\",\"huifu_id\":\"6666000103124174\"}"
}

响应示例¶

{
    "data": "{\"acct_date\":\"20201215\",\"acct_split_bunch\":{\"acct_infos\":[{\"acct_date\":\"20201215\"\"div_amt\":\"200.00\",\"huifu_id\":\"6666000103124174\"}],\"fee_acct_date\":\"\",\"fee_amt\":\"16.00\",\"fee_huifu_id\":\"6666000103124174\"},\"actual_ref_amt\":\"\",\"bank_code\":\"\",\"bank_message\":\"\",\"hf_seq_id\":\"0032default201215100215P715c0a855d100000\",\"huifu_id\":\"6666000103124174\",\"mer_name\":\"\",\"mer_ord_id\":\"20201215refund20201215wap0001\",\"ord_amt\":\"200.00\",\"org_fee_amt\":\"16.00\",\"org_hf_seq_id\":\"0032default201215095956P220c0a855d100000\",\"org_ord_amt\":\"200.00\",\"org_ord_id\":\"20201215095955defaultL2920807189\",\"org_req_date\":\"20201215\",\"org_req_seq_id\":\"20201215wap0001\",\"product_id\":\"HUIFENQI\",\"ref_amt\":\"200.00\",\"ref_cnt\":\"1\",\"ref_fee_amt\":\"16.00\",\"req_date\":\"20201215\",\"req_seq_id\":\"refund20201215wap0001\",\"sub_resp_code\":\"00000000\",\"sub_resp_desc\":\"成功\",\"sys_id\":\"TEST\",\"trans_date\":\"20201215\",\"trans_stat\":\"S\",\"trans_type\":\"TRANS_REFUND\"}",
    "resp_code": "10000",
    "resp_desc": "成功调用",
    "sign": "g2+IVQMAN3b7iQPDv26DFoG403dEtElCXSrMg8EUGol9Siq7zjEbI25hoLz/uH+QzmerEf+UFNR8LaQSw+JFDWkDOsT4DROTN5DJ3jcMiNdiN+t3nCWmTlLfAbJu9rNvq3y1VLPvxLgL46DD7Dh5VTDiaWoaWZgfG5gY/NGd/aUFesuhGeSAJCP1s7wOc+Mv78dQGEXKUgqtaTStUw1K3vzx3/OVfufHy0RmnFKLrhuiE8Q8qjdgbtZGP1Hi36O8cAE/MyytMIQlDDTY2/yWKcgq41z0LwA912MOSbQ0fmQ6K3tNGmLOk4anljpvaERTbStywNn7jgaP/NEf39fUeg=="
}

接口调用示例¶

Demo参考