交易查询¶

当发起一笔支付订单后，可通过交易查询接口查询订单交易状态及支付详细信息。

服务商可通过此接口对交易结果未知的支付交易发起交易查询。说明：可支持通过 out_trans_id （微信、支付宝的商户单号）、party_order_id （支付凭证号）、req_seq_id （原始请求流水号）、out_ord_id （商户外部订单号）、hf_seq_id （汇付流水号）来进行查询。

请求参数¶

请求地址

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

公共请求参数

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

请求参数(data)

参数	中文名	类型	必填	最大长度	说明
huifu_id	商户号	String	Y	32	汇付分配的商户号
req_date	原始请求日期	String	Y	8	请求时间YYYYMMDD
sys_id	系统号	String	Y	32	系统号
req_seq_id	原始请求流水号	String	N	128	正向订单5选1
party_order_id	支付凭证号	String	N	64
out_trans_id	微信支付宝的订单号	String	N	64
out_ord_id	商户外部订单号	String	N	32
hf_seq_id	汇付流水号	String	N	128

响应参数¶

响应参数(data)

参数	中文名	类型	必填	最大长度	说明
sub_resp_code	业务返回码	String	Y	8	业务返回码00000000交易成功
sub_resp_desc	业务返回描述	String	Y	512	业务返回描述
req_seq_id	业务请求流水号	String	Y	128	交易时传入，原样返回
req_date	业务请求时间YYYYMMDD	String	Y	8	交易时传入，原样返回
mer_ord_id	商户订单号	String	Y	128	商户生成
acct_stat	到账状态	String	N	1	P/S/F
trans_stat	交易状态	String	N	1	P/S/F
hf_seq_id	汇付流水号	String	N	40	汇付流水号
huifu_id	汇付商户号	String	Y	32	汇付分配的商户号
trans_type	交易类型	String	Y
wx_response	微信返回的响应报文	JSON	N		以下字段当业务返回码=00时有返回
alipay_response	支付宝返回的响应报文	JSON	N		以下字段当业务返回码=00时有返回
unionpay_response	银联返回的响应报文	JSON	N		以下字段当业务返回码=00时有返回
trans_amt	交易金额	String	Y	12	交易金额
settlement_amt	结算金额	String	Y	16	结算金额
fee_amount	手续费金额	String	Y	16	手续费金额
acct_split_bunch	分账串	jsonobject	N	4000	见附录返回分账串
notify_type	通知类型	String	Y	1	1：通道通知，2：账务通知
fee_flag	手续费扣款标志	int	Y		1-外扣 2-内扣
is_delay_acct	是否延时交易	String	N	1	1：延时交易 ; 0：非延时交易；
is_div	是否分账交易	String	N	1	1：分账交易 ; 0：非分账交易；
acct_date	账务日期	String	Y	8
bank_code	通道返回码	String	N	32
bank_message	通道返回描述	String	N	200
out_trans_id	微信支付宝订单号	String	N	64
party_order_id	支付凭证号	String	N	64
end_time	支付完成时间	String	N	14	支付完成时间，格式为yyyyMMddHHmmss，如2009年12月25日 9点10分10秒表示为20091225091010
debit_flag	借贷标识	String	N	1	见附录借贷标识
trans_time	交易时间	String	N	6	支付完成时间，格式为yyyyMMddHHmmss，如2009年12月25日9点10分 10秒表示为20091225091010
out_ord_id	外部订单号	String	N	50
devs_id	汇付终端号	String	N	50
posp_seq_id	凭证号	String	N	32
remark	备注	String	N	6
fq_mer_discount_flag	分期贴息类型	int	N		分期贴息类型，1:商户贴息，默认商户不贴息
ref_amt	可退金额	String	N	12
unconfirm_amt	未确认金额	String	N	12
dc_response	数字货币返回响应参数	String	N		以下字段当业务返回码=00时有返回，数字货币内容
wx_user_id	微信用户唯一标识码	String	N	128	微信用户唯一标识码 ; 259号文新增字段
mer_dev_location	商户终端定位	jsonObject	N		Json格式；详见 259号文新增字段

请求示例¶

{
        "sign_type":"RSA2",
        "sign":"TEST_SIGN",
        "sys_id":"TEST",
        "data":"{\"huifu_id\":\"6666000001016747\",\"product_id\":\"TEST\",\"req_date\":\"20200227\",\"hf_seq_id\":\"0029000topA200227150057P679c0a8108a00000\"}"
}

响应示例¶

{
    "data": "{\"acct_date\":\"20200227\",\"acct_split_bunch\":{\"acct_infos\":[{\"acct_date\":\"20200227\",\"div_amt\":\"0.03\",\"huifu_id\":\"6666000001016747\"},{\"acct_date\":\"20200227\",\"div_amt\":\"0.03\",\"huifu_id\":\"6666000001016747\"},{\"acct_date\":\"20200227\",\"div_amt\":\"0.02\",\"huifu_id\":\"6666000001016747\"},{\"acct_date\":\"20200227\",\"div_amt\":\"0.00\",\"huifu_id\":\"6666000001016747\"}],\"fee_acct_date\":\"20200227\",\"fee_amt\":\"0.01\",\"fee_huifu_id\":\"6666000001016747\"},\"acct_stat\":\"S\",\"alipay_response\":{\"buyer_id\":\"2088612006621361\",\"buyer_logon_id\":\"233***@qq.com\"},\"bagent_id\":\"6666000001016747\",\"bagent_name\":\"万事屋-注册名称\",\"bank_code\":\"10000\",\"fee_amt\":\"0.01\",\"fee_flag\":2,\"hf_seq_id\":\"0029000topA200227150057P679c0a8108a00000\",\"huifu_id\":\"6666000001016747\",\"is_delay_acct\":\"0\",\"is_div\":\"1\",\"mer_name\":\"万事屋-注册名称\",\"mer_ord_id\":\"20200303143400I0000001\",\"org_resp_code\":\"00000000\",\"org_resp_desc\":\"成功\",\"party_order_id\":\"TOP00000012002271500589fze3NwaVu\",\"req_date\":\"20200227\",\"req_seq_id\":\"Test2233242416\",\"settlement_amt\":\"0.08\",\"sub_resp_code\":\"00000000\",\"sub_resp_desc\":\"成功\",\"trans_amt\":\"0.08\",\"trans_stat\":\"S\",\"trade_type\":\"A_MICROPAY\"}",
    "resp_code": "10000",
    "resp_desc": "成功调用",
    "sign": "Ml7aIXWgU8TnlOw7nFU8J+0/bb33V3Ie5QFYdzDE/quL7vvQnPnI119IjfsxRS70u4WHOrFBLeib+TkBHEQmWvzhveJjn9+lGv6fi5H4ZUzpqWzON1hj6W7/zZVBcgH73gW0jUzQ9vphIzRfxwBSS9ID/647Wn2RhHH375eDTNrP50C1ZleW5QerO1s1tCL68+8AAQhlaqQEfgz8JLiiTQQvs25UxL6f2RgsxLP0aKigXAr/nb8u58JzViAe1vyLx5lTWcfkilGxUGiys6GieqKl9EKb5z42tKaU2xI8igoL5u8j+zihR+V3PGxf7nTHH6rgfe3CgkYPl+Bh+TIB6A=="
}

接口调用实例

Demo参考