交易确认¶
服务商可通过此接口对一笔延时交易进行交易确认,资金分配由传入的分账串进行指定。
说明: 可支持通过原交易的org_req_seq_id(原始请求流水号)来进行确认,或者通过汇付返回的org_hf_seq_id来进行确认。
请求参数¶
- 请求地址
https://spin.cloudpnr.com/topat/payConfirm
- 公共请求参数
请求报文头HEADER - 「接口规则-参数规定-报文头」 ,请求报文体BODY - 「接口规则-参数规定-报文体」 ,响应报文体 - 「接口规则-参数规定-响应报文体」
- 请求参数(data)
参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
---|---|---|---|---|---|
req_seq_id | 请求流水号 | String | Y | 128 | 请求流水号,同一产品号下,req_date与req_seq_id组合需保证唯一 |
req_date | 请求时间 | String | Y | 8 | 请求时间YYYYMMDD,同一产品号下,req_date与req_seq_id组合需保证唯一 |
mer_ord_id | 商户订单号 | String | Y | 128 | 商户订单号 |
huifu_id | 商户号 | String | Y | 32 | 汇付分配的商户号 |
org_req_date | 原交易请求日期 | String | Y | 8 | |
org_req_seq_id | 原交易请求流水号 | String | N | 20 | 原请求流水号(org_req_seq_id,org_req_date) 、org_hf_seq_id 两者必填其一 |
org_hf_seq_id | 原交易汇付流水号 | String | N | 128 | |
remark | 说明 | String | N | 127 | |
acct_split_bunch | 分账串 | JSON | N | 4000 | 请求分账串 |
响应参数¶
- 响应参数(data)
参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
---|---|---|---|---|---|
sub_resp_code | 业务返回码 | String | Y | 8 | 业务返回码 |
sub_resp_desc | 业务返回描述 | String | Y | 512 | 业务返回描述 |
trans_stat | 交易状态 | String | Y | 1 | S:成功;F:失败;P:处理中 |
req_seq_id | 业务请求流水号 | String | Y | 128 | 请求流水号 |
req_date | 业务请求时间 | String | Y | 8 | 请求日期YYYYMMDD |
huifu_id | 商户号 | String | Y | 32 | |
mer_ord_id | 商户订单号 | String | Y | 50 | |
hf_seq_id | 汇付流水号 | String | N | 128 | |
acct_responses | 交易返回List | JSONARRAY | N | 账务信息返回 ,顺序同请求分账串分账信息列表顺序 |
账务信息返回¶
参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
---|---|---|---|---|---|
huifu_id | 入款子商户号 | String | Y | 32 | 入款子商户号 |
div_amt | 分账金额 | String | Y | 12 | 单位元,需保留小数点后两位,例如:1.00,最低传入0.01 |
请求示例¶
{
"sign_type": "RSA2",
"sign": "MRLqDlxk+m9H+UXa3kSq+2dAuOXDZ/acSJsyNLbwqFa5o4SRFMTKHR9mU4PuTCEg1Kv9o3eVKKljq2dhEi/QNh8IG81Wi6qUAlPukU8OHGr4h93bIT+YnGH2Ofg8ZRMFBRh+/sj5UWoGXbrAWBliqsp8ue0yZbLXhqDc3aAhFFY=",
"data": "{\"acct_split_bunch\":{\"acct_infos\":[{\"div_amt\":\"8.08\",\"huifu_id\":\"6666000001016774\"},{\"div_amt\":\"0.12\",\"huifu_id\":\"6666000001016747\"}]},\"huifu_id\":\"6666000001016747\",\"mer_ord_id\":\"e2bfc8c2-15e8-4b5f-804a-591bee37467f\",\"org_hf_seq_id\":\"0029000topB200304133036P984c0a8108c00000\",\"org_req_date\":\"20200227\",\"org_req_seq_id\":\"15832998341583299834\",\"product_id\":\"TEST\",\"req_date\":\"20200417\",\"req_seq_id\":\"b285c31b-ac46-4888-830f-a7fa26c5838e\"}"
}
响应示例¶
{
"data": "{\"acct_resp_code\":\"000\",\"acct_resp_desc\":\"成功\",\"acct_responses\":[{\"div_amt\":\"8.08\",\"huifu_id\":\"6666000001016774\",\"out_acct_date\":\"20200417\",\"out_acct_seq_id\":\"8001054491\",\"trans_id\":\"110005847433\"},{\"div_amt\":\"0.12\",\"huifu_id\":\"6666000001016747\",\"out_acct_date\":\"20200417\",\"out_acct_seq_id\":\"8001054492\",\"trans_id\":\"110005847434\"}],\"hf_seq_id\":\"0035default200417153207P116a9fe692a00000\",\"huifu_id\":\"6666000001016747\",\"mer_ord_id\":\"e2bfc8c2-15e8-4b5f-804a-591bee37467f\",\"product_id\":\"TEST\",\"req_date\":\"20200417\",\"req_seq_id\":\"a285c31b-ac46-4888-830f-a7fa26c5838e\",\"resp_code\":\"00000000\",\"resp_desc\":\"交易成功\",\"trans_stat\":\"S\"}",
"resp_code": "10000",
"resp_desc": "成功调用",
"sign": "BTyAPnEO7pPfOFM385x55zeHmuqTWGC4N3hlPxqqIsFTFxdmolzHEamnrPWUcCUB2iai9xiEPZ7CTRXmUkwZb7/DESDFEtM/kTLWA6ccMNqzVQsr5DImg7xuJEAvnZSgidEJdAVeFOvZ8QtX0pYW2J1mafEy/Pc+kYzga8/BpY6/BkilvV7J3WAZbRya9/m+KOcYhoboM5fa9S0kmWbehiwL60eGTNH7fPCbeoA/CZDUWKezV7P0Zp7/moSvP93Nj1uaYHNCCYMTjDehfqO0d7SP3QeWJ7zJepAQX1WGYMPRNcdRguVJW2AMk0jkWKdkVPWKnDzv8AZbZ8pIpLqhLw==",
}