快捷类接口

常用接入方式

快速接入方式（页面版）

此接入方式提供了页面让用户录入身份和卡号信息，商户不需要额外开发页面采集用户信息，可以快速接入快捷支付功能。这种接入方式支持贷记卡支付。 涉及到的接口包括： 快捷纯页面接口 、 交易状态查询接口 、 退款接口 （可选）、 退货接口 （可选）、 延时分账确认 （可选）、 文件下载接口 （可选）

纯后台系统调用方式（无页面）

此接入方式不会出现汇付的页面，商户需要开发页面采集用户信息。此接入方式不支持贷记卡快捷支付。 涉及到的接口包括：快捷短信发送 、 快捷确认支付 、 交易状态查询接口 、 退款接口 （可选）、 退货接口 （可选）、 延时分账确认 （可选）、 文件下载接口 （可选）

sms002 快捷绑卡发短信（后台版）

功能说明

适用产品企账通/app+，接口功能说明：给用户的银行卡预留手机号发送短信。需配合快捷绑卡验证短信（后台版）或快捷绑卡验证短信（页面版）。

调用方式：后台返回（同步）

调用地址：

• 生产环境：https://hfpay.cloudpnr.com/api/hfpay/sms002
• 测试环境：https://hfpay.testpnr.com/api/hfpay/sms002

请求参数

参数中文名称	参数名称	数据格式	是否必须	说明
商户客户号	mer_cust_id	定长16位String	必须	商户客户号
版本号	version	定长2位String	必须	固定：10
用户客户号	user_cust_id	定长16位String	可选
短信订单号	sms_order_id	变长50位String	必须	俗称一阶段订单号
短信订单日期	sms_order_date	定长8位String	必须	俗称一阶段订单日期 格式：yyyyMMdd
身份证号	id_card	15位或18位String	可选	用户客户号与身份证号必传其一，优先使用user_cust_id
姓名	user_name	变长50位String	可选	user_cust_id为空时，user_name必传
银行卡号	card_num	变长9-32位String	必须
银行预留手机号	card_mobile	定长11位String	必须
省份	card_prov	定长4位String	可选	银行卡开户省份
地区	card_area	定长4位String	可选	银行卡开户地区
是否代绑取现卡	bind_cash_card_flag	定长1位String	可选	0：不代绑取现卡 1：代绑取现卡 默认为0
商户私有域	mer_priv	变长120位String	可选
扩展域	extension	变长512位String	可选	为商户的自定义字段，该字段在交易完成后由本平台原样返回

返回参数

参数中文名称	参数名称	数据格式	是否必须	说明
返回码	resp_code	定长6位String	必须	返回码
返回描述	resp_desc	变长128位String	必须	返回描述
商户客户号	mer_cust_id	定长16位String	必须	商户客户号
用户客户号	user_cust_id	定长16位String	必须
用户账户号	user_acct_id	变长9位String	必须
短信订单号	sms_order_id	变长50位String	必须
短信订单日期	sms_order_date	定长8位String	必须	格式：yyyyMMdd
商户私有域	mer_priv	变长120位String	可选
扩展域	extension	变长512位String	可选	为商户的自定义字段，该字段在交易完成后由本平台原样返回
本平台交易唯一标识号	platform_seq_id	变长30位String	可选

返回码

返回码	返回描述
公共返回码
H10001	订单已过期
H10003	省份地区非法
H10004	数据加密失败
H10005	银行卡已存在，请勿重复操作
H10026	商户不支持贷记卡快捷支付
H10028	短信发送频繁
H10031	短信发送失败
H10044	快捷绑卡只支持个人用户和个体户

bind02 快捷绑卡验证短信（后台版）

功能说明

适用产品企账通/app+，先调用快捷绑卡短信发送接口，然后调本接口验证短信。本接口不展示汇付协议，使用前需汇付风控审核同意。解绑请调用银行卡解绑接口。

调用方式：后台返回（同步）

调用地址：

• 生产环境：https://hfpay.cloudpnr.com/api/hfpay/bind02
• 测试环境：https://hfpay.testpnr.com/api/hfpay/bind02

请求参数

参数中文名称	参数名称	数据格式	是否必须	说明
商户客户号	mer_cust_id	定长16位String	必须	商户客户号
版本号	version	定长2位String	必须	固定：10
订单号	order_id	变长50位String	必须	俗称二阶段订单号 传入“快捷绑卡发短信”接口的sms_order_id（一阶段二阶段用相同的订单号）
订单日期	order_date	定长8位String	必须	俗称二阶段订单日期 传入“快捷绑卡发短信”接口的sms_order_date（一阶段二阶段用相同的订单日期） 格式：yyyyMMdd
短信验证码	sms_code	定长6位String	必须
商户私有域	mer_priv	变长120位String	可选
扩展域	extension	变长512位String	可选	为商户的自定义字段，该字段在交易完成后由本平台原样返回

返回参数

参数中文名称	参数名称	数据格式	是否必须	说明
返回码	resp_code	定长6位String	必须	返回码
返回描述	resp_desc	变长128位String	必须	返回描述
商户客户号	mer_cust_id	定长16位String	必须	商户客户号
用户客户号	user_cust_id	定长16位String	必须
用户账户号	user_acct_id	变长9位String	必须
订单号	order_id	变长50位String	必须
订单日期	order_date	定长8位String	必须	格式：yyyyMMdd
短信订单号	sms_order_id	变长50位String	必须
短信订单日期	sms_order_date	定长8位String	必须	格式：yyyyMMdd
绑卡ID	bind_card_id	变长30位String	可选	此绑卡ID，用于快捷支付
取现绑卡ID	settle_bind_card_id	变长20位String	可选	当取现卡绑定成功时，该字段有值
商户私有域	mer_priv	变长120位String	可选
扩展域	extension	变长512位String	可选	为商户的自定义字段，该字段在交易完成后由本平台原样返回
本平台交易唯一标识号	platform_seq_id	变长20位String	可选

返回码

返回码	返回描述
公共返回码
H10005	银行卡已存在，请勿重复操作
H10029	请重新发送短信
H10030	短信发送中
H10038	订单日期不一致

bind03 快捷绑卡验证短信（页面版）

功能说明

适用产品企账通/app+，接口功能说明：先调用快捷绑卡短信发送接口，然后调用本接口，会跳转到汇付快捷签约的协议页面。用户同意签约后，验证短信并签约快捷。解绑请调用银行卡解绑接口。

调用方式：页面返回（同步，异步）

调用地址：

• 生产环境：https://hfpay.cloudpnr.com/api/hfpay/bind03
• 测试环境：https://hfpay.testpnr.com/api/hfpay/bind03

请求参数

参数中文名称	参数名称	数据格式	是否必须	说明
商户客户号	mer_cust_id	定长16位String	必须	商户客户号
版本号	version	定长2位String	必须	固定：10
订单号	order_id	变长50位String	必须	俗称二阶段订单号 传入“快捷绑卡发短信”接口的sms_order_id（一阶段二阶段用相同的订单号）
订单日期	order_date	定长8位String	必须	俗称二阶段订单日期 传入“快捷绑卡发短信”接口的sms_order_date（一阶段二阶段用相同的订单日期） 格式：yyyyMMdd
短信验证码	sms_code	定长6位String	必须
后台返回地址	bg_ret_url	变长128位String	可选	注意： 1) URL中请不要包含特殊字符 2) 必须是外网地址
前台返回地址	ret_url	变长128位String	可选	注意： 1) URL中请不要包含特殊字符 2) 必须是外网地址
商户私有域	mer_priv	变长120位String	可选
扩展域	extension	变长512位String	可选	为商户的自定义字段，该字段在交易完成后由本平台原样返回

返回参数

参数中文名称	参数名称	数据格式	是否必须	说明
返回码	resp_code	定长6位String	必须	返回码
返回描述	resp_desc	变长128位String	必须	返回描述
商户客户号	mer_cust_id	定长16位String	必须	商户客户号
用户客户号	user_cust_id	定长16位String	必须
用户账户号	user_acct_id	变长9位String	必须
订单号	order_id	变长50位String	必须
订单日期	order_date	定长8位String	必须	格式：yyyyMMdd
短信订单号	sms_order_id	变长50位String	必须
短信订单日期	sms_order_date	定长8位String	必须	格式：yyyyMMdd
绑卡ID	bind_card_id	变长30位String	可选	此绑卡ID，用于快捷支付
取现绑卡ID	settle_bind_card_id	变长20位String	可选	当取现卡绑定成功时，该字段有值
商户私有域	mer_priv	变长120位String	可选
扩展域	extension	变长512位String	可选	为商户的自定义字段，该字段在交易完成后由本平台原样返回
本平台交易唯一标识号	platform_seq_id	变长20位String	可选

返回码

返回码	返回描述
公共返回码
H10005	银行卡已存在，请勿重复操作
H10029	请重新发送短信
H10030	短信发送中
H10038	订单日期不一致

页面展示

手机版

pay001 快捷支付短信发送（后台版）

功能说明

适用产品企账通/app+，接口功能说明：该接口功能为发送快捷支付短信，如果未开户系统会自动开户，如果未绑卡系统会自动绑卡，本接口需要配合快捷支付确认接口使用。

调用方式：后台返回（同步）

调用地址：

• 生产环境：https://hfpay.cloudpnr.com/api/hfpay/pay001
• 测试环境：https://hfpay.testpnr.com/api/hfpay/pay001

请求参数

参数中文名称	参数名称	数据格式	是否必须	说明
商户客户号	mer_cust_id	定长16位String	必须	商户客户号
版本号	version	定长2位String	必须	固定10
短信订单日期	sms_order_date	定长8位String	必须	俗称一阶段订单日期 格式：20180101
短信订单号	sms_order_id	变长50位String	必须	俗称一阶段订单号
用户客户号	user_cust_id	定长16位String	可选	用户客户号与身份证号必传其一 如果两个参数都传了，则使用user_cust_id，只校验身份证号格式，不校验身份证号正确性
用户姓名	user_name	变长50位String	可选	user_cust_id为空时，必传
身份证号	id_card	定长18位String	可选	用户客户号与身份证号必传其一 如果两个参数都传了，则使用user_cust_id，只校验身份证号格式，不校验身份证号正确性 身份证号末位X支持大小写
银行预留手机号	card_mobile	定长11位String	可选	bind_card_id为空时，必传
银行卡号	card_num	变长9-32位String	可选	银行卡号与bind_card_id必传其一 如果两个参数都传了，则使用bind_card_id，只校验银行卡号格式，不校验银行卡号正确性
绑卡ID	bind_card_id	变长20位String	可选	银行卡号与bind_card_id必传其一 如果两个参数都传了，则使用bind_card_id，只校验银行卡号格式，不校验银行卡号正确性
延时分账	div_type	定长1位String	可选	0：实时分账 1：延时分账 注：延时分账时，in_cust_id、in_acct_id、div_details必须为空 默认：0
交易类型	biz_trans_type	定长1位String	必须	P：支付 R：充值 注： 1、充值时user_cust_id与in_cust_id相同 2、充值不支持分账 3、充值不支持延时分账 4、充值不支持贷记卡、准贷记卡 5、支付时user_cust_id与in_cust_id不能相同 6、支付时，分账串的div_cust_id不能全等于user_cust_id
入账客户号	in_cust_id	定长16位String	可选	in_cust_id，in_acct_id和div_details二选一，不能同时存在； 不分账时，可直接填写in_cust_id，in_acct_id
入账账户号	in_acct_id	变长9位String	可选	in_cust_id，in_acct_id和div_details二选一，不能同时存在； 不分账时，可直接填写in_cust_id，in_acct_id
分账串	div_details	变长String	可选	in_cust_id，in_acct_id和div_details二选一, 不能同时存在 json数组格式字符串，详细见下面表格
交易金额	trans_amt	变长14位String	必须	带2位小数，格式：12.00
省份	card_prov	定长4位String	可选
地区	card_area	定长4位String	可选
手续费扣款客户号	fee_cust_id	定长16位String	可选	fee_cust_id、fee_acct_id要么同时为空，要么同时不为空；
手续费扣款账户号	fee_acct_id	变长9位String	可选	fee_cust_id、fee_acct_id要么同时为空，要么同时不为空
付款方交易终端编码	payer_term_no	变长32位String	可选	请参考《网络支付报文结构及要素技术规范(V1.0)》(银办发[2016] 222号)
收款方交易终端类型	payee_term_type	定长2位String	可选	01-电脑 02-手机 03-平板设备 04-可穿戴设备 05-数字电视 06-条码支付受理终端 99-其他
收款方交易终端编码	payee_term_no	变长32位String	可选	请参考《网络支付报文结构及要素技术规范(V1.0)》(银办发[2016] 222号)
商品简称	goods_short_name	变长40位String	可选	不能包含特殊字符：<>&’”|%#\^-
身份证号有效期开始时间	id_card_expired_start	定长8位String	可选
身份证号有效期结束时间	id_card_expired_end	定长8位String	可选
商户私有域	mer_priv	变长120位String	可选
扩展域	extension	变长512位String	可选	为商户的自定义字段，该字段在交易完成后由本平台原样返回
设备静态信息	dev_info_json	变长2000位String	必填	json格式如：{“ipAddr”:”10.99.195.11”,”devType”:”2”,”MAC”:”D4-81-D7-F0-42-F8”,”IMEI”:”3553200846666033”}；注：ipAddr和devType必填，MAC和IMEI 二选一必填，见下文
是否绑定取现卡	bind_cash_card_flag	定长1位String	可选	0：不代绑取现卡 1：代绑取现卡 默认为0
订单超时时间	order_expire_time	定长14位String	可选	格式为 yyyyMMddHHmmss
交易发生地	transaction_addr	定长64位String	必填	例如：上海
用途	purpose	定长256位String	必填	例如：其他
对手方ip	user_ip_addr	定长20位String	必填	用户终端ip

分账串格式：

注：分账串最大支持5个

列名	数据格式	描述
divCustId	定长16位String	分账客户号
divAcctId	变长9位String	分账账户号
divAmt	变长14位String	分账金额 带2位小数，格式12.00

设备信息：

字段	字段描述	是否必须
devType	设备类型 1.电脑；2.手机	必填
ipAddr	IP地址	必填
MAC	MAC地址	选填
IMEI	IMEI码	选填
devSysType	设备系统类型 1.IOS；2.安卓；3.windows	选填
UUID	UUID	选填
IMSI	IMSI码	选填
ICCID	ICCID码	选填
MEID	MEID码	选填
SEID	SEID	选填
ipType	IP地址类型代理、家庭、办公环境、网吧、学校等，直接给中文名称	选填
ipProvName	IP省	选填
ipCityName	IP市	选填
ipAreaName	IP地区	选填
ipProvCode	IP省编码	选填
ipCityCode	IP市编码	选填
ipAreaCode	IP地区编码	选填
cenX	定位（经度）	选填
cenY	定位（纬度）	选填
provName	定位地址（省）	选填
cityName	定位地址（市）	选填
areaName	定位地址（区）	选填
provCode	定位（省编码）	选填
cityCode	定位（市编码）	选填
areaCode	定位（区编码）	选填
unDevCode	用户交易设备（唯一识别码）	选填
serviceProviderIp	商户服务IP地址	选填
merUrl	商户网址	选填

返回参数

参数中文名称	参数名称	数据格式	是否必须	说明
返回码	resp_code	定长6位String	必须	返回码
返回描述	resp_desc	变长128位String	必须	返回描述
商户客户号	mer_cust_id	定长16位String	必须	商户客户号
用户客户号	user_cust_id	定长16位String	可选
短信订单号	sms_order_id	变长50位String	必须
短信订单日期	sms_order_date	定长8位String	必须	格式：yyyyMMdd
银行代号	bank_id	定长8位String	可选
借贷标记	dc_flag	变长2位String	可选
交易金额	trans_amt	变长14位String	必须	格式12.10
入账客户号	in_cust_id	定长16位String	可选
入账账户号	in_acct_id	变长9位String	可选
分账串	div_details	变长512位的String	可选
手续费金额	fee_amt	变长14位String	可选	格式12.10
手续费客户号	fee_cust_id	定长16位String	可选
手续费账户号	fee_acct_id	变长9位String	可选
商户私有域	mer_priv	变长120位的String	可选
扩展域	extension	变长512位的String	可选	为商户的自定义字段，该字段在交易完成后由本平台原样返回
本平台交易唯一标识号	platform_seq_id	变长20位的String	可选

返回码

返回码	返回描述
公共返回码
H10001	订单已过期
H10002	快捷支付只支持个人用户和个体户
H10003	省份地区非法
H10004	数据加密失败
H10007	入账客户号、入账账户号与分账串信息必须输入一项
H10008	分账信息异常
H10009	分账串内容不能超过五个
H10010	延时分账时分账串与入账信息必须为空
H10012	分账串部分字段为空
H10013	分账串客户号信息格式错误
H10014	分账串账户信息格式错误
H10015	分账串金额格式错误
H10016	账户类型错误
H10017	分账串分账客户号重复
H10019	分账串总金额不等于交易金额
H10020	四要素信息不全
H10022	充值不支持分账和延时分账
H10023	充值不支持贷记卡和准贷记卡
H10024	充值时入账方必须与出账方信息一致
H10025	支付时入账方信息不能全等于出账方信息
H10026	商户不支持贷记卡快捷支付
H10028	短信发送频繁
H10039	手续费内扣不支持分账
H10068	手续费账户信息异常

pay002 快捷支付确认（后台版）

功能说明

适用产品企账通/app+，接口功能说明：本接口功能为确认支付，需要配合快捷支付短信发送接口使用。本接口支持将借记卡绑定为取现卡。

调用方式：后台返回

调用地址：

• 生产环境：https://hfpay.cloudpnr.com/api/hfpay/pay002
• 测试环境：https://hfpay.testpnr.com/api/hfpay/pay002

请求参数

参数中文名称	参数名称	数据格式	是否必须	说明
商户客户号	mer_cust_id	定长16位String	必须	商户客户号
版本号	version	定长2位String	必须	固定：10
订单号	order_id	变长50位String	必须	俗称二阶段订单号 传入“快捷统合版短信发送”接口的sms_order_id（一阶段二阶段用相同的订单号）
订单日期	order_date	定长8位String	必须	俗称二阶段订单日期 传入“快捷统合版短信发送”接口的sms_order_date（一阶段二阶段用相同的订单日期） 格式：yyyyMMdd
短信验证码	sms_code	定长6位String	必须
后台返回地址	bg_ret_url	变长128位String	可选	注意： 1) URL中请不要包含特殊字符 2) 必须是外网地址 3) 如果不填，将接收不到异步通知
商户私有域	mer_priv	变长120位String	可选
扩展域	extension	变长512位String	可选	为商户的自定义字段，该字段在交易完成后由本平台原样返回

返回参数

参数中文名称	参数名称	数据格式	是否必须	说明
返回码	resp_code	定长6位String	必须	返回码
返回描述	resp_desc	变长128位String	必须	返回描述
商户客户号	mer_cust_id	定长16位String	必须	商户客户号
用户客户号	user_cust_id	定长16位String	可选
用户账户号	user_acct_id	变长9位String	可选
订单号	order_id	变长50位String	必须
订单日期	order_date	定长8位String	必须	格式：yyyyMMdd
短信订单号	sms_order_id	变长50位String	必须
短信订单日期	sms_order_date	定长8位String	必须	格式：yyyyMMdd
交易金额	trans_amt	变长14位String	必须	格式12.10
入账客户号	in_cust_id	定长16位String	可选
入账账户号	in_acct_id	变长9位String	可选
分账串	div_details	变长512位String	可选
手续费金额	fee_amt	变长14位String	可选	格式12.10
手续费客户号	fee_cust_id	定长16位String	可选
手续费账户号	fee_acct_id	变长9位String	可选
绑卡id	bind_card_id	变长20位String	可选	已绑定快捷卡，返回该值 card_base_info得bind_card_id
取现绑卡ID	settle_bind_card_id	变长20位String	可选	已绑定取现卡，返回该值 card_base_info得bind_card_id
可分账金额	real_trans_amt	变长14位String	可选	延迟分账用，订单交易成功时有效； 该字段配合“延时分账确认”接口的“非手续费分摊模式” 使用，如果“延时分账确认”接口中字段share_fee_mode=1(手续费分摊模式)，则忽略字段real_trans_amt
商户私有域	mer_priv	变长120位String	可选
扩展域	extension	变长512位String	可选	为商户的自定义字段，该字段在交易完成后由本平台原样返回
本平台交易唯一标识号	platform_seq_id	变长20位	可选

返回码

返回码	返回描述
公共返回码
H10005	银行卡已存在，请勿重复操作
H10029	请重新发送短信
H10030	短信发送中
H10038	订单日期不一致
H10040	黑名单用户，开户失败
H10041	身份校验失败
H10042	身份证格式校验失败
H10043	身份证末位校验失败

pay020 快捷支付确认（cvv2页面版）

功能说明

适用产品企账通/app+，接口功能说明：快捷三合一指开户+绑快捷卡（取现卡）+快捷支付，本接口功能为验证快捷支付短信，本接口需要配合快捷三合一短信发送接口（pay001）使用。本接口支持将快捷卡绑定为取现卡，但是快捷卡必须为借记卡。本接口支持贷记卡支付，当银行卡为贷记卡时，跳转cvv2有效期得输入页面

调用方式：页面返回、异步返回

调用地址：

• 生产环境：https://hfpay.cloudpnr.com/api/hfpay/pay020
• 测试环境：https://hfpay.testpnr.com/api/hfpay/pay020

请求参数

参数中文名称	参数名称	数据格式	是否必须	说明
商户客户号	mer_cust_id	定长16位String	必须	商户客户号
版本号	version	定长2位String	必须	固定：10
订单号	order_id	变长50位String	必须	俗称二阶段订单号 传入“快捷统合版短信发送”接口的sms_order_id（一阶段二阶段用相同的订单号）
订单日期	order_date	定长8位String	必须	俗称二阶段订单日期 传入“快捷统合版短信发送”接口的sms_order_date（一阶段二阶段用相同的订单日期） 格式：yyyyMMdd
短信验证码	sms_code	定长6位String	必须
后台返回地址	bg_ret_url	变长128位的String	可选	注意： 1) URL中请不要包含特殊字符 2) 必须是外网地址 3) 如果不填，将接收不到异步通知
商户私有域	mer_priv	变长120位String	可选
扩展域	extension	变长512位String	可选	为商户的自定义字段，该字段在交易完成后由本平台原样返回
前台返回地址	ret_url	变长128位String	可选	如果传了ret_url，支付完成返回商户地址
页面类型	request_type	定长1位String	可选	P：PC端 M：移动端 默认：P

返回参数

参数中文名称	参数名称	数据格式	是否必须	说明
返回码	resp_code	定长6位String	必须	返回码
返回描述	resp_desc	变长128位String	必须	返回描述
商户客户号	mer_cust_id	定长16位String	必须	商户客户号
用户客户号	user_cust_id	定长16位String	可选
用户账户号	user_acct_id	变长9位String	可选
订单号	order_id	变长50位String	必须
订单日期	order_date	定长8位String	必须	格式：yyyyMMdd
短信订单号	sms_order_id	变长50位String	必须
短信订单日期	sms_order_date	定长8位String	必须	格式：yyyyMMdd
交易金额	trans_amt	变长14位String	必须	格式12.10
入账客户号	in_cust_id	定长16位String	可选
入账账户号	in_acct_id	变长9位String	可选
分账串	div_details	变长512位String	可选
手续费金额	fee_amt	变长14位String	可选	格式12.10
手续费客户号	fee_cust_id	定长16位String	可选
手续费账户号	fee_acct_id	变长9位String	可选
绑卡id	bind_card_id	变长20位String	可选	已绑定快捷卡，返回该值 card_base_info得bind_card_id
取现绑卡ID	settle_bind_card_id	变长20位String	可选	已绑定取现卡，返回该值 card_base_info得bind_card_id
可分账金额	real_trans_amt	变长14位String	可选	延迟分账用，订单交易成功时有效； 该字段配合“延时分账确认”接口的“非手续费分摊模式” 使用，如果“延时分账确认”接口中字段share_fee_mode=1(手续费分摊模式)，则忽略字段real_trans_amt
商户私有域	mer_priv	变长120位String	可选
扩展域	extension	变长512位String	可选	为商户的自定义字段，该字段在交易完成后由本平台原样返回
本平台交易唯一标识号	platform_seq_id	变长20位	可选

返回码

返回码	返回描述
公共返回码
H10005	银行卡已存在，请勿重复操作
H10029	请重新发送短信
H10030	短信发送中
H10038	订单日期不一致
H10040	黑名单用户，开户失败
H10041	身份校验失败
H10042	身份证格式校验失败
H10043	身份证末位校验失败

pay010/pay014 快捷纯页面接口（页面版）

功能说明

适用产品企账通/app+，纯页面接口，接口展示汇付页面，流程包含开户，快捷绑卡发短信，快捷绑卡短信验证，快捷支付短信发送，快捷支付确认。本接口支持将快捷卡绑定为取现卡，但是快捷卡必须为借记卡。

调用方式：页面返回

web页面版调用地址：

• 生产环境：https://hfpay.cloudpnr.com/api/hfpay/pay010
• 测试环境：https://hfpay.testpnr.com/api/hfpay/pay010

H5页面版调用地址：

• 生产环境：https://hfpay.cloudpnr.com/api/hfpay/pay014
• 测试环境：https://hfpay.testpnr.com/api/hfpay/pay014

请求参数

参数中文名称	参数名称	数据格式	是否必须	说明
商户客户号	mer_cust_id	定长16位String	必须	商户客户号
版本号	version	定长2位String	必须	固定10
订单日期	order_date	定长8位String	必须	格式:20180101 （一阶段二阶段都使用同一个订单日期）
订单号	order_id	变长50位String	必须	订单号 （一阶段二阶段都使用同一个订单号）
用户客户号	user_cust_id	定长16位String	可选	如果用户已开户，传入该参数
延时分账	div_type	定长1位String	可选	0：实时分账 1：延时分账 注：延时分账时，in_cust_id、in_acct_id、div_details必须为空 默认：0
交易类型	biz_trans_type	定长1位String	必须	P：支付 R：充值 注： 1、充值时user_cust_id与in_cust_id相同 2、充值不支持分账 3、充值不支持延时分账 4、充值不支持贷记卡、准贷记卡 5、支付时user_cust_id与in_cust_id不能相同 6、支付时，分账串的div_cust_id不能全等于user_cust_id
入账客户号	in_cust_id	定长16位String	可选	in_cust_id，in_acct_id和div_details二选一，不能同时存在； 不分账时，可直接填写in_cust_id，in_acct_id
入账账户号	in_acct_id	变长9位String	可选	in_cust_id，in_acct_id和div_details二选一，不能同时存在； 不分账时，可直接填写in_cust_id，in_acct_id
分账串	div_details	变长String	可选	in_cust_id，in_acct_id和div_details二选一, 不能同时存在 json数组格式字符串，详细见下面表格
交易金额	trans_amt	变长14位String	必须	带2位小数，格式：12.00
手续费扣款客户号	fee_cust_id	定长16位String	可选	fee_cust_id、fee_acct_id要么同时为空，要么同时不为空
手续费扣款账户号	fee_acct_id	变长9位String	可选	fee_cust_id、fee_acct_id要么同时为空，要么同时不为空
付款方交易终端编码	payer_term_no	变长32位String	可选	请参考《网络支付报文结构及要素技术规范(V1.0)》(银办发[2016] 222号)
收款方交易终端类型	payee_term_type	定长2位String	可选	01-电脑 02-手机 03-平板设备 04-可穿戴设备 05-数字电视 06-条码支付受理终端 99-其他
收款方交易终端编码	payee_term_no	变长32位String	可选	请参考《网络支付报文结构及要素技术规范(V1.0)》(银办发[2016] 222号)
商品简称	goods_short_name	变长40位String	可选	不能包含特殊字符：<>&’”|%#\^-
前台返回地址	ret_url	变长128位的String	可选
后台返回地址	bg_ret_url	变长128位的String	可选	注意： 1) URL中请不要包含特殊字符 2) 必须是外网地址 3) 如果不填，将接收不到异步通知
商户私有域	mer_priv	变长120位的String	可选
扩展域	extension	变长512位的String	可选	为商户的自定义字段，该字段在交易完成后由本平台原样返回
设备静态信息	dev_info_json	变长2000位String	必填	json格式如：{“ipAddr”:”10.99.195.11”,”devType”:”2”,”MAC”:”D4-81-D7-F0-42-F8”,”IMEI”:”3553200846666033”}；注：ipAddr和devType必填，MAC和IMEI 二选一必填，见下文
是否绑定取现卡	bind_cash_card_flag	定长1位String	可选	0：不代绑取现卡 1：代绑取现卡 默认为0
交易发生地	transaction_addr	定长64位String	必填	例如：上海
用途	purpose	定长256位String	必填	例如：其他

分账串格式

注：分账串最大支持5个

列名	数据格式	描述
divCustId	定长16位String	分账客户号
divAcctId	变长9位String	分账账户号
divAmt	变长14位String	分账金额 带2位小数，格式12.00

设备静态信息：

字段	字段描述	是否必须
devType	设备类型 1.电脑；2.手机	必填
ipAddr	IP地址	必填
MAC	MAC地址	选填
IMEI	IMEI码	选填
devSysType	设备系统类型 1.IOS；2.安卓；3.windows	选填
UUID	UUID	选填
IMSI	IMSI码	选填
ICCID	ICCID码	选填
MEID	MEID码	选填
SEID	SEID	选填
ipType	IP地址类型代理、家庭、办公环境、网吧、学校等，直接给中文名称	选填
ipProvName	IP省	选填
ipCityName	IP市	选填
ipAreaName	IP地区	选填
ipProvCode	IP省编码	选填
ipCityCode	IP市编码	选填
ipAreaCode	IP地区编码	选填
cenX	定位（经度）	选填
cenY	定位（纬度）	选填
provName	定位地址（省）	选填
cityName	定位地址（市）	选填
areaName	定位地址（区）	选填
provCode	定位（省编码）	选填
cityCode	定位（市编码）	选填
areaCode	定位（区编码）	选填
unDevCode	用户交易设备（唯一识别码）	选填
serviceProviderIp	商户服务IP地址	选填
merUrl	商户网址	选填

返回参数

参数中文名称	参数名称	数据格式	是否必须	说明
返回码	resp_code	定长6位String	必须	返回码
返回描述	resp_desc	变长128位String	必须	返回描述
商户客户号	mer_cust_id	定长16位String	必须	商户客户号
用户客户号	user_cust_id	定长16位String	可选
用户账户号	user_acct_id	变长9位String	可选
订单号	order_id	变长50位String	必须
订单日期	order_date	定长8位String	必须	格式：yyyyMMdd
绑卡ID	bind_card_id	变长20位	可选	已绑定快捷卡，返回该值 card_base_info得bind_card_id
取现绑卡ID	settle_bind_card_id	变长20位String	可选	已绑定取现卡，返回该值 card_base_info得bind_card_id
银行代号	bank_id	定长8位String	可选
借贷标记	dc_flag	变长2位String	可选
交易金额	trans_amt	变长14位String	必须	格式12.10
入账客户号	in_cust_id	定长16位String	可选
入账账户号	in_acct_id	变长9位String	可选
分账串	div_details	变长512位String	可选
手续费金额	fee_amt	变长14位String	可选	格式12.10
手续费客户号	fee_cust_id	定长16位String	可选
手续费账户号	fee_acct_id	变长9位String	可选
可分账金额	real_trans_amt	变长14位String	可选	延迟分账用，订单交易成功时有效； 该字段配合“延时分账确认”接口的“非手续费分摊模式” 使用，如果“延时分账确认”接口中字段share_fee_mode=1(手续费分摊模式)，则忽略字段real_trans_amt
商户私有域	mer_priv	变长120位String	可选
扩展域	extension	变长512位String	可选	为商户的自定义字段，该字段在交易完成后由本平台原样返回
本平台交易唯一标识号	platform_seq_id	变长20位	可选

返回码

返回码	返回描述
公共返回码
H10001	订单已过期
H10002	快捷支付只支持个人用户和个体户
H10003	省份地区非法
H10004	数据加密失败
H10007	入账客户号、入账账户号与分账串信息必须输入一项
H10008	分账信息异常
H10009	分账串内容不能超过五个
H10010	延时分账时分账串与入账信息必须为空
H10012	分账串部分字段为空
H10013	分账串客户号信息格式错误
H10014	分账串账户信息格式错误
H10015	分账串金额格式错误
H10016	账户类型错误
H10017	分账串分账客户号重复
H10019	分账串总金额不等于交易金额
H10020	四要素信息不全
H10022	充值不支持分账和延时分账
H10023	充值不支持贷记卡和准贷记卡
H10024	充值时入账方必须与出账方信息一致
H10025	支付时入账方信息不能全等于出账方信息
H10026	商户不支持贷记卡快捷支付
H10028	短信发送频繁
H10039	手续费内扣不支持分账
H10068	手续费账户信息异常
H10005	银行卡已存在，请勿重复操作
H10029	请重新发送短信
H10030	短信发送中
H10038	订单日期不一致
H10040	黑名单用户，开户失败
H10041	身份校验失败
H10042	身份证格式校验失败
H10043	身份证末位校验失败

页面展示

PC版 ——已开户绑卡场景

PC版 ——新开户绑卡场景

手机版 ——已开户绑卡场景

手机版 ——新开户绑卡场景

pay027 众邦虚拟账户余额支付短信发送

功能说明

适用产品企账通/app+，接口功能说明：如果商户的众邦虚拟账户余额支付短信开关已开启，则需要先调用本接口发送短信，再调用众邦虚拟账户余额支付接口进行验证短信并支付

调用方式：页面返回、异步返回

调用地址：

• 生产环境：https://hfpay.cloudpnr.com/api/hfpay/pay027
• 测试环境：https://hfpay.testpnr.com/api/hfpay/pay027

请求参数

参数中文名称	参数名称	数据格式	是否必须	说明
版本号	version	定长2位String	必须	目前固定为10
商户客户号	mer_cust_id	定长16位String	必须	由汇付生成，商户的唯一性标识
订单号	order_id	变长50位String	必须	由商户生成，必须保证唯一， 50位内的字母或数字组合
订单日期	order_date	定长8位String	必须	格式为YYYYMMDD，例如：20160307
众邦虚拟账户号	card_num	变长32位String	必须
商户私有域	mer_priv	变长120位String	可选
扩展域	extension	变长512位String	可选

返回参数

参数中文名称	参数名称	数据格式	是否必须	说明
应答返回码	resp_code	定长6位String	必须	–调用成功，其他见返回码附件表
应答返回描述	resp_desc	变长String	必须	返回码的对应中文描述
商户客户号	mer_cust_id	定长16位String	必须	由汇付生成，商户的唯一性标识
订单号	order_id	变长50位String	必须
订单日期	order_date	定长8位String	必须
商户私有域	mer_priv	变长120位String	可选
扩展域	extension	变长512位String	可选

返回码

返回码	返回描述
公共返回码
H10108	短信开关未开启
H10109	用户虚拟账户不存在
H10110	用户虚拟账户信息异常

pay028 众邦虚拟账户余额支付

功能说明

适用产品企账通/app+，接口功能说明：众邦虚拟账户余额支付，支持短信验证

调用方式：页面返回、异步返回

调用地址：

• 生产环境：https://hfpay.cloudpnr.com/api/hfpay/pay028
• 测试环境：https://hfpay.testpnr.com/api/hfpay/pay028

请求参数

参数中文名称	参数名称	数据格式	是否必须	说明
版本号	version	定长2位String	必须	目前固定为10
商户客户号	mer_cust_id	定长16位String	必须	由汇付生成，商户的唯一性标识
订单号	order_id	变长50位String	必须	由商户生成，必须保证唯一， 50位内的字母或数字组合
订单日期	order_date	定长8位String	必须	格式为YYYYMMDD，例如：20160307
众邦虚拟账户号	card_num	变长32位String	必须
短信验证码	sms_code	定长6位String	可选
是否延时分账	div_type	定长1位String	必须	0：实时分账 1：延时分账 注：延时分账时，in_cust_id、in_acct_id、div_details必须为空 默认0实时分账
交易金额	trans_amt	变长14位String	必须	泛指交易金额，金额格式必须是###.00，比如2.00，2.01
手续费客户号	fee_cust_id	定长16位String	可选	用于指定手续费收取客户号
手续费账户号	fee_acct_id	变长9位String	可选	用于指定手续费收取账户号 传手续费客户号时必填，必须是属于手续费客户号下的账户号
入账账户号	in_cust_id	定长16位String	可选	in_cust_id，in_acct_id和div_details二选一； 不分账时，可直接填写in_cust_id，in_acct_id
入账客户号	in_acct_id	变长9位String	可选	in_cust_id，in_acct_id和div_details二选一； 不分账时，可直接填写in_cust_id，in_acct_id
分账串	div_details	变长512位的String	可选	in_cust_id，in_acct_id和div_details二选一
后台返回地址	bg_ret_url	变长128位的String	可选	通过后台异步通知，商户应在应答接收的响应中输出RECV_ORD_ID字样的字符串，表明商户已经收到该笔交易结果。 注意： 1) URL中请不要包含特殊字符 2) 必须是外网地址
商户私有域	mer_priv	变长120位的String	可选
扩展域	extension	变长512位的String	可选

返回参数

参数中文名称	参数名称	数据格式	是否必须	说明
应答返回码	resp_code	定长6位String	必须	–调用成功，其他见返回码附件表
应答返回描述	resp_desc	变长String	必须	返回码的对应中文描述
商户客户号	mer_cust_id	定长16位String	必须	由汇付生成，商户的唯一性标识
订单号	order_id	变长50位String	可选
订单日期	order_date	定长8位String	可选
交易金额	trans_amt	变长14位String	可选
入账客户号	in_cust_id	定长16位String	可选
入账账户号	in_acct_id	变长9位String	可选
分账串	div_details	变长512位的String	可选
手续费金额	fee_amt	变长14位String	可选
手续费客户号	fee_cust_id	定长16位String	可选
手续费账户号	fee_acct_id	变长9位String	可选
商户私有域	mer_priv	变长120位的String	可选
扩展域	extension	变长512位的String	可选
可分账金额	real_trans_amt	变长14位String	可选	延迟分账用，订单交易成功时有效； 该字段配合“延时分账确认”接口的“非手续费分摊模式” 使用，如果“延时分账确认”接口中字段share_fee_mode=1(手续费分摊模式)，则忽略字段real_trans_amt

返回码

返回码	返回描述
公共返回码
H10108	短信开关未开启
H10109	用户虚拟账户不存在
H10110	用户虚拟账户信息异常
H10065	订单信息不匹配
H10029	请重新发送短信
H10030	短信发送中
H10010	延时分账时分账串与入账信息必须为空
H10007	入账客户号、入账账户号与分账串信息必须输入一项
H10025	支付时入账方信息不能全等于出账方信息
H10008	分账信息异常
H10009	分账串内容不能超过五个
H10012	分账串部分字段为空
H10013	分账串客户号信息格式错误
H10014	分账串账户信息格式错误
H10015	分账串金额格式错误
H10017	分账串分账客户号重复
H10019	分账串总金额不等于交易金额
H10111	入账方虚拟账户不存在
H10039	手续费内扣不支持分账