银行卡分期支付确认¶

银行卡分期支付为两段式支付，调用此接口发起一笔针对银行卡分期申请的确认支付动作。

请求参数¶

请求地址

https://spin.cloudpnr.com/top/bccredit/paymentConfirm

公共请求参数

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

请求参数(data)

参数	中文名	定义	长度	非空	说明
req_seq_id	请求流水号	String	128	Y	请求流水号
req_date	请求时间	String	8	Y	请求时间YYYYMMDD
huifu_id	商户号	String	32	Y
org_seq_id	原请求流水号	String	128	Y	二段式支付申请请求流水号
org_seq_date	原请求时间	String	8	Y	二段式支付申请请求时间YYYYMMDD
mer_ord_id	商户订单号	String	50	Y
cvv2	CVV2	String	3	N
valid_date	有效期	String	6	N
verify_code	手机验证码	String	6	Y
extend_pay	网联扩展字段	JSON		Y
time_expire	订单有效期	String	14	N	订单失效时间
terminal_device_info	设备信息	JSON		Y	设备信息
risk_check_info	风控信息	String	4000	Y	风控信息
notify_url	异步通知地址	String	512	N	例：virgo://http://www.xxx.com/getResp

网联扩展字段¶

参数	中文名	定义	长度	非空	说明
pyer_trx_trm_tp	付款终端类型	String	2	N	付款终端类型：01：电脑02：手机03：平板设备04：可穿戴设备05：数字电视06：条码支付受理终端99：其他
pyer_trx_trm_no	付款终端编码	String	32	N	付款终端编码：标识交易终端的唯一、固定的编码。应符合《网络支付报文结构及要素技术规范（V1.0）》（银办发〔2016〕222号）要求，最长为32个字符。
pyee_acct_id	收款方账户编号	String	34	Y	收款方账户编号(网联银联支付使用)，非空
pyee_nm	收款方账户名称	String	60	Y	收款方账户名称，非空(网联银联支付使用) (说明：<、>、&、’、”、\|、%、#、^、- 不能包含特殊字符)
pyee_acct_tp	收款方账户类型	String	2	Y	收款方账户类型，非空(网联银联支付使用) （03 个人支付账户, 04 单位支付账户默认值为04 单位支付账户）
pyee_trx_trm_tp	收款终端类型	String	2	N	收款终端类型：01：电脑02：手机03：平板设备04：可穿戴设备05：数字电视06：条码支付受理终端99：其他
pyee_trx_trm_no	收款终端编码	String	32	N	收款终端编码：标识交易终端的唯一、固定的编码。应符合《网络支付报文结构及要素技术规范（V1.0）》（银办发〔2016〕222号）要求，最长为32个字符。
mer_type	二级商户类型	String	2	Y	二级商户类型： 01：法人02：其他组织03：个体工商户04：自然人
mer_id_type	二级商户证件类型	String	2	Y	二级商户证件类型：00：身份证01：护照02：军官证03：军官证04：回乡证05：户口簿06：警官证07：临时身份证08：台胞证09：港澳通行证10：企业营业执照11：法人代表证12：外国人永久居留证，即绿卡13：其他
mer_id_no	二级商户证件编码	String	32	Y	二级商户证件编码
mer_cat_code	二级商户行业类别	String	4	Y	商户行业类别参照银联MCC编码
goods_short_name	商品简称	String	64	Y	商品简称，非空, (网联银联支付使用)(说明：<、>、&、’、”、\|、%、#、^、- 不能包含特殊字符)
biz_tp	业务种类	String	6	N	参见附录业务种类

响应参数¶

data(响应内容体)

参数	中文名	定义	长度	非空	说明
sub_resp_code	业务返回码	String	8	Y	见附录业务返回码
sub_resp_desc	业务返回描述	String	512	Y	业务返回描述
req_seq_id	请求流水号	String	128	Y	请求流水号
req_date	请求时间	String	8	Y	请求时间YYYYMMDD
hf_seq_id	汇付流水号	String	128	Y	汇付流水号
product_id	产品号	String	32	Y
mer_ord_id	商户订单号	String	50	Y	即商户支付订单号，商户传入时保证唯一格式：数字+字母
huifu_id	商户号	String	32	Y
trans_amt	交易金额	String	12	N	单位元，需保留小数点后两位，例如：1.00
fee_amt	手续费金额	String	12	Y	手续费金额
acct_date	入账账务日期	String	8	N
fee_acct_date	手续费账务日期	String	8	N
bank_code	银行返回码，可空	String	64	N
bank_message	银行返回描述，可空	String	256	N
acct_split_bunch	分账串	JSON		N	见附录返回分账串
gate_id	支付渠道号	String	4	Y	网关号
channel_type	支付渠道类型	String	1	N	支付渠道类型：U：银联 N：网联 D：直连 O：其他
party_order_id	支付凭证号	String	64	N	汇付发往银行（银联/网联）的订单编号，即银联网联流水号
notify_type	返回类型	String	2	Y	1- 通道 2- 账务
trans_stat	交易状态	String		N	I：初始、P：处理中、S：成功、F：失败
acct_stat	账务状态	String		N	I：初始、P：处理中、S：成功、F：失败

异步响应参数(data)

参数	中文名	定义	长度	非空	说明
sub_resp_code	业务返回码	String	8	Y	见附录业务返回码
sub_resp_desc	业务返回描述	String	512	Y	业务返回描述
req_seq_id	请求流水号	String	128	Y	请求流水号
req_date	请求时间	String	8	Y	请求时间YYYYMMDD
hf_seq_id	汇付流水号	String	128	Y	汇付流水号
product_id	产品号	String	32	Y
mer_ord_id	商户订单号	String	50	Y	即商户支付订单号，商户传入时保证唯一格式：数字+字母
huifu_id	商户号	String	32	Y
trans_amt	订单金额	String	12	N	单位元，需保留小数点后两位，例如：1.00
fee_amt	手续费金额	String	12	Y	手续费金额
acct_date	入账账务日期	String	8	N
fee_acct_date	手续费账务日期	String	8	N
bank_code	银行返回码，可空	String	64	N
bank_message	银行返回描述，可空	String	256	N
acct_split_bunch	分账串	JSON		N	见附录返回分账串
gate_id	支付渠道号	String	4	Y	网关号
channel_type	支付渠道类型	String	1	N	支付渠道类型：U：银联 N：网联 D：直连 O：其他
party_order_id	支付凭证号	String	64	N	汇付发往银行（银联/网联）的订单编号，即银联网联流水号
notify_type	返回类型	String	2	Y	1- 通道 2- 账务
trans_stat	交易状态	String		N	I：初始、P：处理中、S：成功、F：失败
acct_stat	账务状态	String		N	I：初始、P：处理中、S：成功、F：失败

请求示例¶

{
        "sign_type":"RSA2",
        "sys_id":"test",
        "sign": "kP0YeT3BxIRpc0SsrCLRh6ZCKDk/nvJhCCIHb4MSuJacEvkeK8H7QPG+uGegrC92HWtHxFYeoh2csH4sy7IQG9EC1Dh0aKC+r5j/GXb014ZqQBksVMtsSXJpe5JcbMIHfLgdgfWn3SvMsI8Co2BxseC6mC4VQHZDcAc0upoJwqhpsibzm1d+dFVKkLUL5veO1uNhXhPdYx6VSQJbj9MFCh5Vrkf1yc/lvLqGLm5E1ZJjHovMJLNrIBodGkKXO8vB7JtWoTqDN+0eVZFjp9nVO1b7F3CtMABarcpw+v13FjOMAmpkF1ZiYOaHFvHGIaWCVbOvLn2dVXQZsWTCwQvWmA==",
        "data": "{\"card_mobile\":\"18180812345\",\"card_name\":\"测试\",\"card_no\":\"***\",\"devs_id\":\"SPINTP335750301080907\",\"extend_pay\":{\"goods_short_name\":\"成都置略口腔汇分期支付\",\"mer_cat_code\":\"5399\",\"mer_id_no\":\"310000200001010011\",\"mer_id_type\":\"01\",\"mer_type\":\"01\",\"pyee_acct_id\":\"6666000102108204\",\"pyee_acct_tp\":\"04\",\"pyee_nm\":\"成都置略口腔\"},\"huifu_id\":\"6666000102108204\",\"id_no\":\"***\",\"id_type\":\"01\",\"instalments_num\":\"12\",\"is_acct_div\":0,\"is_acct_div_param\":0,\"mer_ord_id\":\"m202103211123299057179\",\"notify_url\":\"virgo://https://hfenqi.cloudpnr.com/hfenqi-ser/unionPay/installment/payConfirmNotify\",\"org_seq_date\":\"20210321\",\"org_seq_id\":\"r202103211123233762584\",\"req_date\":\"20210321\",\"req_seq_id\":\"r202103211123299057179\",\"sys_id\":\"test\",\"terminal_device_info\":{\"devs_id\":\"SPINTP335750301080907\"},\"trans_amt\":\"26400.00\",\"verifyCode\":\"***\"}"
}

响应示例¶

{
        "resp_code":"0000",
        "resp_desc":"成功",
        "data":"{\"acct_stat\":\"I\",\"channel_type\":\"U\",\"fee_amt\":\"0.00\",\"hf_seq_id\":\"002900TOP1A210321112329P990ac13261c00000\",\"huifu_id\":\"6666000102108204\",\"mer_ord_id\":\"m202103211123299057179\",\"ord_amt\":\"26400.00\",\"party_order_id\":\"20210321112323hzeebk\",\"req_date\":\"20210321\",\"req_seq_id\":\"r202103211123299057179\",\"settlement_amt\":\"26400.00\",\"sub_resp_code\":\"00000100\",\"sub_resp_desc\":\"交易正在处理中 cashCode:00000000 cashDesc:成功\",\"sys_id\":\"test\",\"transStat\":\"P\"}",
        "sign":"ixo6gYmN3+OqWxPOg9HG/CoyTzsyASWxPAW1eQEtHvUEx4VrXbc+rjwYBQ3qmAwe3xEurD4Y8YnpgOl7f7fCD71GyNuUDdK92goZ58FFbj11RU+WYjfee75AAk3H/C3eew8iJvyyTp924AFunyt5t30x9bLF1GF9l43ztuBV9ttYirJ2mjc67NWxOlbFrTwfeTn4HA5GhL4WeN3yd+RH7kzbbMQkqps9tM52zCdrJmVyht1LwIFMqKAvA5/cZvDOZzYr3T0ErrYQZLIcKP3oEIKUYKhFmKe2q8s38ybf8Ih9drDAkRpLLyGwnb1RRZ1rO45JdU1uG+VZ29g3jqTTxg=="
}

接口调用实例

Demo参考