快捷支付申请接口¶

本API为后台接口，上送快捷绑卡id进行快捷支付申请，申请成功后银行会向持卡人发送短信验证码。

充值时，出入款方均为用户；支付时，出款方为用户，入款方为商户。

涉及到的接口包括：快捷支付确认接口、线上交易查询接口、线上交易退款接口、线上退款查询接口。

请求参数¶

请求地址

https://spin.cloudpnr.com/top-online-ser/quickpay/apply

公共请求参数

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

请求参数(data)

参数中文名称	参数名称	数据格式	是否必须	说明
请求流水号	req_seq_id	变长64位String	必须
请求日期	req_date	定长8位String	必须	请求时间YYYYMMDD
产品号	product_id	变长32位String	必须
商户号	huifu_id	变长32位String	必须
用户号	user_huifu_id	变长32位String	必须
绑卡ID	card_bind_id	变长32位String	必须	绑卡ID
订单金额	trans_amt	变长12位String	必须	订单金额，单位元，需保留小数点后两位，例如：1.00,最低传入0.01
异步通知地址	mer_notice_url	变长512位String	必须	virgo://#{http_server_url} 例：virgo://http://www.xxx.com/getResp
订单类型	order_type	固定1位String	可选	P:支付;R:充值, 默认：P
延时标记	is_delay_acct	固定1位String	可选	是否延时交易,1为延迟 0为不延迟
订单有效期	time_expire	固定14位String	可选	订单失效时间 YYYYMMDDHHMMSS格式
商户私有域	mer_priv	变长1024位String	可选
分账串	acct_split_bunch	JSON	可选	请求分账串
设备信息	device_info	String	必须	设备信息
网联扩展信息	nacl_info	String	必须	网联扩展信息
风控信息	risk_check_info	变长4000位String	必须	jsonstring，风控信息

设备信息¶

参数	中文名	类型	必填	最大长度	说明
trx_device_type	设备类型	String	Y	2	01:手机，02:平板，03:手表，04:PC
trx_device_ip	交易设备IP	String	Y	45	用于标识交易设备IP地址，目前暂传IPv4格式
trx_device_mac	交易设备MAC	String	N	12	去掉特殊的连接符号，如冒号、连接符
trx_device_imei	交易设备IMEI	String	N	15
trx_device_imsi	交易设备IMSI	String	N	15
trx_device_icc_id	交易设备ICCID	String	N	20
trx_device_wifi_mac	交易设备WIFIMAC	String	N	12
trx_device_gps	交易设备GPS	String	N	23

网联扩展信息¶

参数	中文名	类型	必填	最大长度	说明
goods_short_name	商品简称	String	Y	40	不能包含特殊字符
biz_tp	业务种类	String	Y	6	业务种类

响应参数¶

同步失败响应参数（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

String url = "https://spin-test.cloudpnr.com/top-online-ser/quickpay/apply";
{
    "data":"{\"req_seq_id\":\"20210708121117821121\",\"req_date\":\"20210708\",\"product_id\":\"JCTEST\",\"huifu_id\":\"6666000103423237\",\"user_huifu_id\":\"6666000103423833\",\"card_bind_id\":\"10000067314\",\"trans_amt\":\"1.02\",\"is_delay_acct\":\"0\",\"order_type\":\"P\",\"mer_notice_url\":\"http://www.baidu.com\",\"time_expire\":\"\",\"mer_priv\":\"\",\"nacl_info\":{\"goods_short_name\":\"01\",\"biz_tp\":\"123451\"},\"device_info\":{\"trx_device_type\":\"01\",\"trx_device_ip\":\"127.0.0.1\"},\"risk_check_info\":{\"riskMngInfo\":{\"subTradeType\":\"4300\"}}}",
    "sign":"myYSc/nbE1yRgMD7QhT4zg0c7MLpoJj+8sKp46lLIOouvgnB/VzmKAb274LQHme/5yvWZZgvTGRqBEhUhNUzv6v0I9KILKCozFpBqFVOapK39fhUXCg403cwMZ9Tzum5X9rD0HMpk4KPEHZVj1t496zUuBGHW5lRGsf/lr4UKfklWL493N0jqY+4RUvKl2naCaIDyifWqGznNuogOI10DoRp1VmmbDusR+NCDWlG1DS1nu9QaX+mKWYPiFmzX9/7xQAoZh53SnYUfOnOhZyyH9vbDbQmm8fP5pt97jrrAWBvj5DfuemjfaH5052dfiZ7Sq01KHpIbl7LKG3+HoVtag==",
    "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,\"card_bind_id\":\"10000067314\",\"card_num_enc\":\"#011Ag/Gqi3FVPJNuDtJdmiQIc/RZtEll0cd\",\"card_num_mask\":\"622848*********9979\",\"cash_resp_code\":\"00000000\",\"cash_resp_desc\":\"成功\",\"client_ip\":\"127.0.0.1\",\"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\",\"goods_desc\":\"01\",\"hf_seq_id\":\"0047default210708163342P434c0a855d100000\",\"huifu_id\":\"6666000103423237\",\"id_card_enc\":\"#011NG6f4K9trR2f3kJ/caW1nDcelJt7wQ9W\",\"id_card_hash\":\"dcf5f489291839c83a9182a369dd8e1c9aa52198fb70b8b51c7df887a7b14331\",\"id_card_mask\":\"110************07X\",\"is_acct_div\":\"0\",\"is_acct_div_param\":\"0\",\"is_delay_acct\":\"0\",\"license_code\":\"110101199003074290\",\"license_type\":\"01\",\"limit_acct_type\":\"D\",\"mer_id\":\"SSP001\",\"mer_name\":\"盈盈超市\",\"mer_priv\":\"\",\"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\":\"20210708163342defaultL2129080789\",\"order_type\":\"P\",\"product_id\":\"JCTEST\",\"real_pay_type\":\"3001\",\"region_id\":\"default\",\"req_date\":\"20210708\",\"req_seq_id\":\"20210708121117821121\",\"risk_check_info\":\"{\\\"riskMngInfo\\\":{\\\"subTradeType\\\":\\\"4300\\\"}}\",\"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\",\"trx_device_type\":\"01\",\"user_huifu_id\":\"6666000103423833\",\"user_name\":\"张三李四啊\",\"user_reg_flag\":0,\"version\":\"1.0.0\"}",
    "resp_code":"10000",
    "resp_desc":"成功调用",
    "sign":"LkCXQz3hdFS4CDfwHVJnPH8JXVgKuurnmvvzVPvU3XZr8J58S83deUMuH1uMh4/rL3Sa4kBMV7IF611U32DHuwxG3n6Q+DM7QZNfA41hoo9RN8Ee1gAbC+ZalgWJYfuX90o/EgdxFc2J9YsC1gRwAXQNImK0xH3UeAaTDfGf/3+jkGTSlM/Mz92EbPiJoPD0Bf58AVmHoGa3CIY8oD9Fj0bbtusmTCGT4ti0HGQ/jAHg7VoOKzBHaGSriDqKcGa6zVutL40pkLdfrUX5UKliYSmrbqFIAJYAjN5/RUW7BsPuBm0WOq8t/Ux9ZgIJY1YkZRKYSgCSLasYM8cvcWvotg=="
}

接口调用示例¶

Demo参考