线上交易查询接口¶

本 API为后台版接口，用于查询单笔线上交易状态及明细。

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

请求参数¶

请求地址

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

公共请求参数

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

请求参数(data)

参数中文名称	参数名称	数据格式	是否必须	说明
产品号	product_id	变长32位String	必须
原交易请求日期	req_date	定长8位String	必须	YYYYMMDD
商户号	huifu_id	变长32位String	必须
原交易请求流水号	req_seq_id	变长64位String	可选	req_seq_id、hf_seq_id必须传一项
交易返回的汇付流水号	hf_seq_id	变128位String	可选
原交易支付类型	pay_type	变长20位String	可选	快捷类交易必填：QUICK_PAY，其他不填

响应参数¶

同步响应参数（data）

参数	中文名	类型	必填	最大长度	说明
sub_resp_code	返回码	String	Y	8	业务返回码
sub_resp_desc	返回描述	String	Y	512	业务返回描述
req_seq_id	请求流水号	String	Y	64
req_date	请求日期	String	Y	8
order_type	订单类型	String	N	1	P：支付;R：充值
huifu_id	商户号	String	Y	32
pay_type	支付类型	String	N	32	支付类型
hf_seq_id	汇付流水号	String	N	128
trans_amt	订单金额	String	N	12	单位元，需保留小数点后两位，例如： 1.00
fee_amt	手续费金额	String	N	12	单位元，需保留小数点后两位，例如： 1.00
acct_split_bunch	分账串	JSON	N		返回分账串
is_delay_acct	是否延时分账	String	N	1	0：实时；1：延时
is_div	是否分账交易	String	N	1	0：非分账交易；1：是分账交易
fee_flag	手续费扣款标志	String	N	1	1：外扣；2：内扣
fee_rec_type	手续费收取方式	String	N	1	1：实收；2：后收
trans_stat	交易状态	String	N	1	P：处理中，S：成功，F：失败
bank_code	通道返回码	String	N	8
bank_message	通道返回描述	String	N
product_id	产品号	String	Y	32
mer_priv	商户私有域	String	N	1024
debit_flag	借贷标识	String	N		D：借记；C：贷记
bank_extend_param	网银附加参数	String	N		网银附加参数
unconfirm_amt	待确认金额	String	N	12	单位元，需保留小数点后两位，例如： 1.00

网银附加参数¶

参数	中文名	类型	必填	说明
gate_type	网关支付类型	String	Y	01: 个人网关；02:企业网关
bank_id	付款方银行号	String	N	B2B支付成功后可能返回
pyer_acct_id	付款方银行账户	String	N	B2B支付成功后可能返回
pyer_acct_nm	付款方银行账户名	String	N	B2B支付成功后可能返回

支付类型¶

payType	备注
ONLINE_PAY_B2B	B2B网银支付
ONLINE_PAY_B2C	B2C网银支付
ONLINE_RECHARGE_B2B	B2B网银充值
ONLINE_RECHARGE_B2C	B2C网银充值
QUICK_PAY	快捷支付
QUICK_RECHARGE	快捷充值
WAP_PAY	手机网页支付
WAP_PAY_INSTALLMENT	手机网页支付(分期)

请求示例¶

{
    "sign": "gF7ooYFY2dEpE6GwSrS5gRU5FOcdAdgkvxPAq/hRjWOTQgEs74zBjQ6KLP0Kq2tRZTzzM3vlf8GSkE+Lcc9zHWRgBr/gFLjkWhCdSCPvsSJk56rxe+8zl7c3BlBcGOeufSRB+4e9DEsMoY7JPwO/ZoCly7eUNa8oLtNs7cyQdYV9Q3kYPoIkxtCJt83QYn5EbXMs/KRI2rZfS8ygXmGOS6eyMbDMDYG04jA6wCySy/QtjenDOVk/+fu4DaQYJAQCtU0fGn+W72ECU0TpBBrWRXXjQlyj6IatHUV2F1WCRTgCa583d6yY15W7+TtGi5K2PgHkFFZMRl1P1Se6yMkMlQ==",
    "sign_type": "RSA2",
    "sys_id": "TEST",
    "data": "{\"req_seq_id\":\"20201221onlinepage0004\",\"req_date\":\"20201221\",\"huifu_id\":\"6666000003100615\"}"
}

响应示例¶

{
    "data": "{\"acct_date\":\"20201221\",\"acct_split_bunch\":{\"acct_infos\":[{\"div_amt\":\"10.00\",\"huifu_id\":\"6666000003100615\"}],\"fee_amt\":\"2.01\",\"fee_huifu_id\":\"6666000003100615\"},\"acct_stat\":\"S\",\"bank_code\":\"00\",\"bank_extend_param\":{\"gate_type\":\"01\"},\"bank_message\":\"交易成功\",\"channel_type\":\"O\",\"debit_flag\":\"D\",\"fee_amt\":\"2.01\",\"fee_flag\":2,\"fee_rec_flag\":\"1\",\"gate_id\":\"C1Y0\",\"hf_seq_id\":\"0032default201221134000P315c0a855d100000\",\"huifu_id\":\"6666000003100615\",\"is_delay_acct\":\"0\",\"is_div\":\"0\",\"mer_name\":\"盈盈超市\",\"ord_id\":\"20201221134000defaultL2920863581\",\"order_type\":\"P\",\"pay_type\":\"ONLINE_PAY_B2C\",\"product_id\":\"MYPAY\",\"ref_amt\":\"0.00\",\"req_date\":\"20201221\",\"req_seq_id\":\"20201221onlinepage0004\",\"sub_resp_code\":\"00000000\",\"sub_resp_desc\":\"成功\",\"trans_amt\":\"10.00\",\"trans_stat\":\"S\"}",
    "resp_code": "10000",
    "resp_desc": "成功调用",
    "sign": "N9c4Dw+3c6GrQYBOWEE5Odn0fXr1Z0yfLq3Re83uHQg7azYMWpIaQIl5vska36zPLY+brHSDs1A+NF8+4kerll9mhME6xlw5xVov13oISuXtXxBKaZXpKi0AiszgJMVddpMJ+FX4qj80YfvfdK1LumlaD63vBZ0ZSABCsZZCzx0lQHo1od6DztnkBWmrePEqsQTeP+YG2sdTfMa+6anaGSG+/V8RdNjCFmF0upVQYn2AUcwmEN0OrzajdeweOG3Mqz92huO9uzIgLWPrRStWZDLC6htxt3yqda8/VIGRIqfoO9wWJja0OXabvboMzEuKdimcxuPR7J72BQ2wFSZT/Q=="
}

接口调用示例¶

Demo参考