交易确认

服务商可通过此接口对一笔延时交易进行交易确认,资金分配由传入的分账串进行指定。

说明: 可支持通过原交易的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==",
}

接口调用示例

Demo参考