网银类接口¶
pay008 网银支付（页面版）¶
网银支付请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 用户客户号 | user_cust_id | 定长16位String | 可选 | 支持免开户支付 |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20190531 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， 50位内的字母或数字组合 |
| 交易金额 | trans_amt | 变长14位String | 必须 | 泛指交易金额，金额格式必须是###.00，比如2.00，2.01 |
| 支付网关号 | gate_id | 定长2位String | 可选 | 如果填网关号，则提交后直接跳转对应银行页面； 如果不填网关号，则提交后跳转汇付银行选择页面； |
| 网银支付类型 | trans_type | 定长2位String | 可选 | 10：B2C 个人网银 11：B2B 企业网银 gate_id与trans_type不能同时传入，但是可以都不传入如果传入trans_type，则只返回对应类型的银行列表 |
| 延时分账 | div_type | 定长1位String | 可选 | 0：实时分账 1：延时分账 注：延时分账时，in_cust_id、in_acct_id、div_details必须为空 |
| 交易类型 | 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二选一 |
| 手续费客户号 | fee_cust_id | 定长16位String | 可选 | 用于指定手续费收取客户号 |
| 手续费账户号 | fee_acct_id | 变长9位String | 可选 | 用于指定手续费收取账户号 传手续费客户号时必填，必须是属于手续费客户号下的账户号 |
| 商品名称 | goods_desc | 变长64位String | 可选 | 默认：通用型产品 |
| 订单有效期 | ord_exp | 定长14位String | 可选 | 格式为YYYYMMDDhhmmss |
| 网关支付受理渠道 | gw_chnnl_tp | 定长2位String | 可选 | 网关支付受理渠道 01：电脑浏览器 02：手机浏览器 03：手机应用程序 99：其他 默认99 |
| 设备静态信息 | 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 二选一必填，见下文 |
| 页面返回URL | ret_url | 变长128位String | 可选 | 前台异步通知商户网银支付结果，前台页面返回，交易结果以商户后台应答地址返回为准 |
| 商户后台应答地址 | bg_ret_url | 变长128位String | 可选 | 通过后台异步通知，商户应在应答接收的响应中输出RECV_ORD_ID字样的字符串，表明商户已经收到该笔交易结果。 注意： 1) URL中请不要包含特殊字符 2) 必须是外网地址 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
| 交易发生地 | transaction_addr | 定长64位String | 必填 | 例如：上海 |
| 用途 | purpose | 定长256位String | 必填 | 例如：其他 |
分账串格式：
注：分账串最大支持5个
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 分账客户号 | divCustId | 定长16位String | 必须 | |
| 分账账户号 | divAcctId | 定长9位String | 必须 | |
| 分账金额 | divAmt | 变长14位String | 必须 | 泛指交易金额，金额格式必须是###.00，比如2.00，2.01 |
设备静态信息：
| 字段 | 字段描述 | 是否必须 |
|---|---|---|
| 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 | 变长String | 必须 | 返回码的对应中文描述 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 用户客户号 | user_cust_id | 定长16位String | 可选 | 支持免开户支付 |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20190531 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， 50位内的字母或数字组合 |
| 交易金额 | trans_amt | 变长14位String | 必须 | 泛指交易金额，金额格式必须是###.00，比如2.00，2.01 |
| 充值支付标志 | biz_trans_type | 定长1位String | 必须 | P：支付 R：充值 |
| 支付网关号 | gate_id | 定长2位String | 可选 | |
| 分账类型 | div_type | 定长1位String | 可选 | 0：实时分账 1：延时分账 |
| 入账客户号 | in_cust_id | 定长16位String | 可选 | |
| 入账账户号 | in_acct_id | 变长9位String | 可选 | |
| 分账账户串 | div_details | 变长String | 可选 | 数据格式： [{‘divCustId’:‘6666000000025350’,’divAcctId’:‘78276’,’divAmt’:‘50.00’},{‘divCustId’:‘6666000000025666’,’divAcctId’:‘78841’,’divAmt’:‘50.00’ }] |
| 手续费客户号 | fee_cust_id | 定长16位String | 可选 | 用于指定手续费收取客户号 |
| 手续费账户号 | fee_acct_id | 变长9位String | 可选 | 用于指定手续费收取账户号 传手续费客户号时必填，必须是属于手续费客户号下的账户号 |
| 手续费金额 | fee_amt | 变长14位String | 可选 | 泛指交易金额，金额格式必须是###.00，比如2.00，2.01 |
| 本平台交易唯一标识号 | platform_seq_id | 变长20位String | 可选 | |
| 网银支付类型 | trans_type | 定长2位String | 可选 | 10：B2C 个人网银 11：B2B 企业网银 |
| 可分账金额 | real_trans_amt | 变长14位String | 可选 | 延迟分账用，订单交易成功时有效； 该字段配合“延时分账确认”接口的“非手续费分摊模式” 使用，如果“延时分账确认”接口中字段share_fee_mode=1(手续费分摊模式)，则忽略字段real_trans_amt |
| 页面返回URL | ret_url | 变长128位String | 可选 | 前台异步通知商户网银支付结果，前台页面返回，交易结果以商户后台应答地址返回为准 |
| 商户后台应答地址 | bg_ret_url | 变长128位String | 可选 | 通过后台异步通知商户网银支付结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
异步返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 用户客户号 | user_cust_id | 定长16位String | 可选 | 支持免开户支付 |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20190531 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， 50位内的字母或数字组合 |
| 交易金额 | trans_amt | 变长14位String | 必须 | 泛指交易金额，金额格式必须是###.00，比如2.00，2.01 |
| 充值支付标志 | biz_trans_type | 定长1位String | 必须 | P：支付 |
| 支付网关号 | gate_id | 定长2位String | 可选 | |
| 分账类型 | div_type | 定长1位String | 可选 | 0=实时分账 1=延时分账 |
| 入账客户号 | in_cust_id | 定长16位String | 可选 | |
| 入账账户号 | in_acct_id | 变长9位String | 可选 | |
| 分账账户串 | div_detail | 变长String | 可选 | 数据格式： [{‘divCustId’:‘6666000000025350’,’divAcctId’:‘78276’,’divAmt’:‘50.00’},{‘divCustId’:‘6666000000025666’,’divAcctId’:‘78841’,’divAmt’:‘50.00’ }] |
| 手续费客户号 | fee_cust_id | 定长16位String | 可选 | 用于指定手续费收取客户号 |
| 手续费账户号 | fee_acct_id | 变长9位String | 可选 | 用于指定手续费收取账户号 传手续费客户号时必填，必须是属于手续费客户号下的账户号 |
| 手续费金额 | fee_amt | 变长14位String | 可选 | 泛指交易金额，金额格式必须是###.00，比如2.00，2.01 |
| 本平台交易唯一标识号 | platform_seq_id | 变长20位String | 可选 | |
| 网银支付类型 | trans_type | 定长2位String | 可选 | 10：B2C 个人网银 11：B2B 企业网银 |
| 可分账金额 | real_trans_amt | 变长14位String | 可选 | 延迟分账用，订单交易成功时有效 ；该字段配合“延时分账确认”接口的“非手续费分摊模式” 使用，如果“延时分账确认”接口中字段share_fee_mode=1(手续费分摊模式)，则忽略字段real_trans_amt |
| 页面返回URL | ret_url | 变长128位String | 可选 | 前台异步通知商户网银支付结果，前台页面返回，交易结果以商户后台应答地址返回为准 |
| 商户后台应答地址 | bg_ret_url | 变长128位String | 可选 | 通过后台异步通知商户网银支付结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
| 付款方银行号 | payer_bank_no | 定长8位String | 可选 | B2B支付成功后可能返回 |
| 付款方银行账户 | payer_card_num | 变长32位String | 可选 | B2B支付成功后可能返回 |
| 付款方银行账户名 | payer_acct_nm | 变长String | 可选 | B2B支付成功后可能返回 |
