快捷支付确认接口¶
本API为后台接口，上送短信验证码进行快捷支付确认。
涉及到的接口包括： 快捷支付申请接口、 线上交易查询接口 、 线上交易退款接口、 线上退款查询接口。
请求参数¶
- 请求地址
https://spin.cloudpnr.com/top-online-ser/quickpay/confirm
- 公共请求参数
请求报文头HEADER - 「接口规则-参数规定-报文头」 ，请求报文体BODY - 「接口规则-参数规定-报文体」 ，响应报文体 - 「接口规则-参数规定-响应报文体」
- 请求参数(data)
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 请求流水号 | req_seq_id | 变长64位String | 必须 | |
| 请求日期 | req_date | 定长8位String | 必须 | 请求时间YYYYMMDD |
| 产品号 | product_id | 变长32位String | 必须 | |
| 商户号 | huifu_id | 变长32位String | 必须 | |
| 短信验证码 | sms_code | 定长6位String | 必须 | |
| 异步通知地址 | mer_notice_url | 变长512位String | 必须 | virgo://#{http_server_url} 例：virgo://http://www.xxx.com/getResp |
| 商户私有域 | mer_priv | 变长1024位String | 可选 |
响应参数¶
- 同步失败响应参数（resp_data）
仅传business_url且校验失败场景返回
| sub_resp_code | 返回码 | String | Y | 8 | 业务返回码 |
| sub_resp_desc | 返回描述 | String | Y | 512 | 业务返回描述 |
| req_seq_id | 请求流水号 | String | Y | 64 | |
| req_date | 请求日期 | String | Y | 8 | |
| hf_seq_id | 汇付流水号 | String | N | 128 | |
| product_id | 产品号 | String | Y | 32 | |
| huifu_id | 商户号 | String | Y | 32 | |
| user_huifu_id | 用户号 | String | N | 32 | |
| bank_id | 银行代号 | String | N | 8 | |
| debit_flag | 借贷标识 | String | N | 1 | D-借记，C-贷记卡 |
| trans_amt | 交易金额 | String | N | 12 | |
| mer_priv | 商户私有域 | String | N | 1024 |
- 异步响应参数（resp_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 | |
| user_huifu_id | 用户号 | String | N | 32 | |
| bank_id | 银行代号 | String | N | 8 | |
| debit_flag | 借贷标识 | String | N | 1 | D-借记，C-贷记卡 |
| trans_amt | 交易金额 | String | N | 12 | |
| fee_amt | 手续费 | String | N | 12 | |
| is_delay_acct | 是否延时分账 | String | N | 1 | 0：实时；1：延时 |
| is_div | 是否分账交易 | String | N | 1 | 0：非分账交易；1：是分账交易 |
| fee_flag | 手续费扣款标志 | String | N | 1 | 1：外扣；2：内扣 |
| trans_stat | 交易状态 | String | N | 1 | I:处理中，P：处理中，S：成功，F：失败 |
| acct_stat | 账务状态 | String | N | 1 | I:处理中，P：处理中，S：成功，F：失败 |
| channel_code | 通道返回码 | String | N | 8 | |
| channel_message | 通道返回描述 | String | N | 128 | |
| trans_type | 交易类型 | String | Y | 交易类型 | |
| mer_priv | 商户私有域 | String | N | 1024 | |
| acct_split_bunch | 分账串 | JSON | N | 返回分账串 |
交易类型¶
| transType | 备注 |
|---|---|
| QUICK_PAY | 快捷支付 |
| QUICK_RECHARGE | 快捷充值 |
请求示例¶
java
{
"data":"{\"req_seq_id\":\"20210708121117821121\",\"req_date\":\"20210708\",\"product_id\":\"JCTEST\",\"huifu_id\":\"6666000103423237\",\"mer_notice_url\":\"http://www.baidu.com\",\"sms_code\":\"111111\",\"merPriv\":\"P\"}",
"sign":"Cjs0Db0FyCXJ1HhllW3B0k39AzCPpEFEBRWFTXcBbvAtuLFNgLShQV1d4RdpIv4Q+u9oSZq2OBrF1J62Gl3J6hHoYFXW3kQhBOGL141dGv7MZYtGHDE5M9WPLG14P4zFnvowIQnll+ROnetOW/FypUQGKzWJwSA8BzRgBd6y2VWrC92ng+eF2mgNR9T3+s3hgyJhXckdhzNnYzi2QFEYPocj+rsTUqmGuUGno+Omi42eLEsRUg3fbLZcse0qb7W1rKLxvRGVS/bJAqjONe4sTC8SI9lfW2p5XKDnYkBdqkUNglhbPN6uHCO9IjUVM8ridKdJoWQanlmEsok1kln3Kw==",
"signType":"RSA2",
"sysId":"JCTEST"
}
响应示例¶
java
{
"data":"{\"acct_id\":\"C00091082\",\"acct_split_bunch_b_o\":{\"acct_id\":\"C00091082\",\"acct_split_bunch\":{\"acct_infos\":[{\"acct_id\":\"C00091082\",\"div_amt\":\"1.02\",\"huifu_id\":\"6666000103423237\"}],\"fee_acct_id\":\"C00093770\",\"fee_amt\":\"0.00\",\"fee_huifu_id\":\"6666000103427205\"},\"bank_id\":\"01030000\",\"calc_mode\":\"AMT*0.003\",\"db_pay_type\":\"QUICK_PAY\",\"db_trans_type\":\"3004\",\"fee_flag\":\"1\",\"fee_rec_type\":\"1\",\"huifu_id\":\"6666000103423237\",\"is_acct_div\":0,\"is_acct_div_param\":0,\"is_delay_acct\":\"0\",\"limit_acct_type\":\"D\",\"order_type\":\"P\",\"product_id\":\"JCTEST\",\"real_main_huifu_id\":\"6666000103423237\",\"req_seq_id\":\"20210708121117821121\",\"trans_amt\":\"1.02\",\"user_huifu_id\":\"6666000103423833\"},\"bagent_id\":\"6666000003078903\",\"bagent_name\":\"上海集成企业\",\"bank_id\":\"01030000\",\"bank_name\":\"中国农业银行\",\"bind_qp_card_flag\":0,\"bip_bank_id\":\"0708163342P01574\",\"card_bind_id\":\"10000067314\",\"card_num_hash\":\"#011Ag/Gqi3FVPJNuDtJdmiQIc/RZtEll0cd\",\"card_num_mask\":\"622848*********9979\",\"cash_resp_code\":\"00000000\",\"cash_resp_desc\":\"成功\",\"channel_stat\":\"I\",\"channel_type\":\"U\",\"db_unit\":\"1\",\"device_info\":\"{\\\"trx_device_ip\\\":\\\"127.0.0.1\\\",\\\"trx_device_type\\\":\\\"01\\\"}\",\"fee_flag\":\"1\",\"fee_rec_type\":\"1\",\"first_ord_id\":\"20210708163342defaultL2129080789\",\"first_req_date\":\"20210708\",\"hf_seq_id\":\"0047default210708163342P434c0a855d100000\",\"huifu_id\":\"6666000103423237\",\"is_delay_acct\":\"0\",\"license_code\":\"110101199003074290\",\"license_type\":\"01\",\"limit_acct_type\":\"D\",\"lock_flag\":1,\"mer_id\":\"SSP001\",\"mer_name\":\"盈盈超市\",\"mer_priv\":\"P\",\"merchant_info_b_o\":{\"huifu_id\":\"6666000103423237\",\"license_code\":\"\",\"mcc\":\"\",\"mer_name\":\"盈盈超市\",\"mer_short_name\":\"盈盈超市\",\"mer_type\":\"01\",\"pa_mer_id\":\"SSP001\",\"product_id\":\"JCTEST\",\"receipt_name\":\"盈盈超市\",\"reg_name\":\"\",\"sub_mer_id_cipher\":\"#011NG6f4K9trR1BKPTFSdSkllasgdDfTBPf\",\"sub_mer_id_mask\":\"110************290\",\"sub_mer_id_tp\":\"00\",\"up_bagent_id\":\"6666000003078903\",\"up_bagent_name\":\"上海集成企业\"},\"nacl_info\":\"{\\\"biz_tp\\\":\\\"123451\\\",\\\"goods_short_name\\\":\\\"01\\\"}\",\"online_pay_extend_d_o\":{\"card_bind_id\":\"10000067314\",\"db_unit\":\"1\",\"ord_id\":\"20210708163342defaultL2129080789\",\"user_huifu_id\":\"6666000103423833\"},\"ord_amt\":\"1.02\",\"ord_id\":\"20210708164021defaultL2129080849\",\"order_type\":\"P\",\"product_id\":\"JCTEST\",\"real_pay_type\":\"3001\",\"region_id\":\"default\",\"repeat_confirm_sms_flag\":0,\"req_date\":\"20210708\",\"req_seq_id\":\"20210708121117821121\",\"risk_check_info\":\"{\\\"riskMngInfo\\\":{\\\"subTradeType\\\":\\\"4300\\\"}}\",\"second_ord_id\":\"20210708164021defaultL2129080849\",\"second_req_date\":\"20210708\",\"sms_code\":\"111111\",\"sub_resp_code\":\"00000100\",\"sub_resp_desc\":\"交易正在处理中\",\"sys_id\":\"JCTEST\",\"time_expire\":\"\",\"trans_acct_detail_d_o_list\":[{\"acct_detail_id\":\"20210708163342defaultL2129080790\",\"acct_id\":\"C00091082\",\"acct_serial_no\":1,\"db_unit\":\"1\",\"div_amt\":1.02,\"huifu_id\":\"6666000103423237\",\"real_acct_id\":\"C00091082\",\"real_cust_id\":\"6666000103423237\",\"ref_amt\":1.02,\"settle_amt\":1.02,\"trans_ord_id\":\"20210708163342defaultL2129080789\"}],\"trans_extend_d_o\":{\"acct_split_bunch\":\"{\\\"acctInfos\\\":[{\\\"acctId\\\":\\\"C00091082\\\",\\\"divAmt\\\":\\\"1.02\\\",\\\"huifuId\\\":\\\"6666000103423237\\\"}],\\\"feeAcctId\\\":\\\"C00093770\\\",\\\"feeAmt\\\":\\\"0.00\\\",\\\"feeHuifuId\\\":\\\"6666000103427205\\\"}\",\"client_ip\":\"127.0.0.1\",\"db_unit\":\"1\",\"nucc_extend\":\"{\\\"biz_tp\\\":\\\"123451\\\",\\\"goods_short_name\\\":\\\"01\\\"}\",\"ord_extend_id\":\"20210708163342defaultL2129080789\",\"ord_id\":\"20210708163342defaultL2129080789\",\"version\":1},\"trans_notify_url\":\"http://www.baidu.com\",\"trans_order_d_o\":{\"acct_stat\":\"I\",\"bagent_id\":\"6666000003078903\",\"bagent_name\":\"上海集成企业\",\"bank_id\":\"01030000\",\"bank_name\":\"中国农业银行\",\"card_bank_id\":\"01030000\",\"cash_req_date\":\"20210708\",\"channel_stat\":\"I\",\"check_cash_flag\":\"I\",\"db_unit\":\"1\",\"dc_type\":\"D\",\"fee_acct_id\":\"C00093770\",\"fee_amt\":0.00,\"fee_flag\":1,\"fee_huifu_id\":\"6666000103427205\",\"fee_real_acct_id\":\"C00093770\",\"fee_real_cust_id\":\"6666000103427205\",\"fee_rec_type\":1,\"goods_desc\":\"01\",\"hf_seq_id\":\"0047default210708163342P434c0a855d100000\",\"huifu_id\":\"6666000103423237\",\"is_acct_div\":0,\"is_acct_div_param\":0,\"is_delay_acct\":0,\"mer_name\":\"盈盈超市\",\"mer_ord_id\":\"2021070820210708163342defaultL2129080789\",\"mer_priv\":\"\",\"ord_amt\":1.02,\"ord_id\":\"20210708163342defaultL2129080789\",\"pa_mer_id\":\"SSP001\",\"pay_card_id\":\"622848*********9979\",\"pay_card_id_enc\":\"#011Ag/Gqi3FVPJNuDtJdmiQIc/RZtEll0cd\",\"pay_type\":\"QUICK_PAY\",\"product_id\":\"JCTEST\",\"real_acct_id\":\"C00091082\",\"real_cust_id\":\"6666000103423237\",\"real_pay_type\":\"3001\",\"ref_amt\":1.02,\"ref_fee_amt\":0.00,\"region_id\":\"default\",\"req_date\":\"20210708\",\"req_seq_id\":\"20210708163342defaultL2129080789\",\"settle_amt\":1.02,\"sys_id\":\"JCTEST\",\"time_expire\":\"\",\"trans_date\":\"20210708\",\"trans_notify_url\":\"http://www.baidu.com\",\"trans_stat\":\"P\",\"trans_type\":\"3004\"},\"trans_stat\":\"P\",\"trans_type\":\"QUICK_PAY\",\"user_huifu_id\":\"6666000103423833\",\"user_name\":\"张三李四啊\",\"user_reg_flag\":0,\"version\":\"1.0.0\"}",
"resp_code":"10000",
"resp_desc":"成功调用",
"sign":"jOWKPDnAXfQKEYohM8VJ28BiE9DnEn0bVS4zHGIy7zaNrgeFjDhgR3FE/7qh9RZ3VaNTClo0b5OLxnRnLW/RkHrFZLoxX6wbx+mHjyNSi/z/yqX2cvLiILyhC4wuEnDOc1X1sP8VOOE0gzr6MviNO7xex7W+lmi4hsSF4lulB/W5klEQuvm1G2wrrzBe0SU+z08s2uQDFpb6ADPX3nj7O7AJIPt9+ocF7DDiXv4s/TaGCmtP6WnIRYScYRiuLQINS0xuhdF2X1dqSMCjwLQ2LVxZDmFdFDz3N4c7CPXnBTOILHI94EEuj7A1lQwIZcqagvVAIJqIuUIEUXmNEEgw0Q=="
}
