开记账户
1、说明
一、合作方发送请求报文给富友。富友验证报文合法性。处理业务逻辑后。同步返回结果报文给合作方。
二、在商户调用该接口之前先通过SFTP上传接口里面的图片，上传到SFTP上面的路径：/upload/申请日期/文件名 ， 比如：/upload/20240101/sfzzp001.jpg
三、接口中的图片字段。就只用传文件名就行了。不用传路径。比如身份证正面照片：certifIdPic=sfzzp001.jpg 图片文件名只能是数字和字母。不能超过16位。比如sfzzp001.jpg就是合法的
四、证件类型：入账方主体类型为0必填；0=营业执照；1=营业执照三证合一；2=医疗从业许可证；3=民办非企业单位凭证登记证书；9=其他。执照编号非18位社会统一信用代码，请选择营业执照
五、以下字段XML里面都要传。也都要按文档参加签名。值可以按业务传空字符串(对公，对私业务的值。没有的传空支付串)。
六、对公的所有银行都支持开户。
七、对私的支持6家国有商业银行(中国工商银行、中国农业银行、中国银行、中国建设银行、交通银行、中国邮政储蓄银行),12家全国性股份制商业银行(招商银行、浦发银行、中信银行、中国光大银行、华夏银行、 中国民生银行、广发银行、兴业银行、平安银行、浙商银行、恒丰银行、渤海银行)。 会验证用户的姓名，银行卡号，手机号，身份证号是否一致。
八、地方城商行和农商行也支持开户，但是没有验证用户的姓名，银行卡号，手机号，身份证号是否一致。会返回开户成功，卡号未验证。
九、合同最大分账比例，目前默认最大值是8000，也就是80%分账。如需100%的分账。请联系对接的商务同事申请。
2、请求地址
生产：[https://ordupz.fuioupay.com/openAccount.fuiou]
测试：[https://ordupz-test.fuioupay.com/openAccount.fuiou]
3、接口输入
| 变量名称 | 字段 | 长度 | 是否必填 | 是否参加签名 | 说明 |
|---|---|---|---|---|---|
| 商户编码 | mchntCd | MAX(15) | 是 | 是 | 商户编码富友分配 |
| 交易流水号 | traceNo | MAX(30) | 是 | 是 | 唯一流水号，无业务用 |
| 申请日期 | applyDate | MAX(8) | 是 | 是 | 格式：20240101 |
| 入账方主体类型 | isIndividualMchnt | MAX(1) | 是 | 是 | 0=企业，8=个体 |
| 入账方主体名称 | insNameCn | MAX(80) | 是 | 是 | 数字-字母-中文-中划线-中文括号，必须包含中文。建议：企业直接用企业简称+序号123，个人直接用商户公司简称+个人姓名+序号123，保证不重复 |
| 入账账户类型 | settleTp | MAX(4) | 是 | 是 | 01-对公银行账户(0=企业)，02-个人银行卡(8=个体) |
| 到账周期类型 | revenueTp | MAX(2) | 是 | 是 | 03 固定传03 |
| 入账方户名 | outAcntNm | MAX(64) | 是 | 是 | 银行卡的户名 |
| 入账方卡号 | outAcntNo | MAX(40) | 是 | 是 | 银行卡的卡号(注意不要用个人二类户卡。冻结卡。注销卡) |
| 分账合同名称 | contractName | MAX(30) | 是 | 是 | 出账方和入账方的分账协议合同，商户提供 |
| 分账合同照片 | contractPic | MAX(16) | 是 | 是 | 出账方和入账方的分账协议合同照片，商户提供 |
| 合同开始时间 | startDate | MAX(8) | 是 | 是 | 合同开始时间。要在分账订单日期以前。 |
| 合同结束时间 | endDate | MAX(8) | 是 | 是 | 合同结束时间。与开始时间最多3年。 |
| 合同最大分账比例 | maxScale | MAX(5) | 是 | 是 | 订单分账比例。10000就表示最多100%分账。 5000就表示最多50%分账 |
| 签名 | signature | MAX | 是 | 否 | AyaQBsq2NmxmMMaSSIg2........ |
| 3.1、以下字段为对公银行账户必填 |
|---|
| 开户许可证扫描照片 | khxkjPic | MAX(16) | 是 | 是 | 对公户的开户许可证照片或者转账交易图片 |
|---|---|---|---|---|---|
| 开户行行号 | interBankNo | MAX(12) | 是 | 是 | 12位开户行行号，文档附件有提供行号参考 |
| 开户证件类型 | flagTp | MAX(1) | 是 | 是 | 见上面说明四、描述 如：1 |
| 开户证件名称 | certifiNm | MAX(32) | 是 | 是 | 如：营业执照三证合一 |
| 开办资金 | startUpCapital | MAX(12) | 否 | 是 | 民办非企业单位凭证登记证书 要填 单位万元。如：100 |
| 开户证件代码 | licNo | MAX(30) | 是 | 是 | |
| 开户证件有效期 | licTov | MAX(8) | 是 | 是 | 格式：yyyyMMdd；比如：20220323 长期的传21230101这种 |
| 证件扫码图片 | licPic | MAX(16) | 是 | 是 | 如：certfront.png |
| 品牌名称 | platNameCn | MAX(80) | 是 | 是 | 比如上海富友支付服务股份有限公司 品牌名称就是：富友支付 |
| 电子邮件 | MAX(50) | 是 | 是 | 企业邮箱 | |
| 联系人 | contactPerson | MAX(50) | 是 | 是 | 企业联系人名称 |
| 联系手机 | contactMobile | MAX(15) | 是 | 是 | 企业联系手机号码 |
| 3.2、以下字段为对私银行账户必填 |
|---|
| 身份证号 | certifId | MAX(18) | 是 | 是 | 18位身份证 要与银行预留的一致 |
|---|---|---|---|---|---|
| 有效期至 | validDt | MAX(8) | 是 | 是 | 格式：yyyyMMdd；比如：20230101 长期的传21230101这种 |
| 手机号码 | contactPhone | MAX(11) | 是 | 是 | 要与银行预留的一致 |
| 身份证正面照片 | certifIdPic | MAX(16) | 是 | 是 | 如：certfront.png |
4、接口输出
| 变量名称 | 字段 | 长度 | 是否必填 | 是否参加签名 | 说明 |
|---|---|---|---|---|---|
| 交易流水号 | traceNo | MAX(32) | 是 | 是 | 唯一流水号 |
| 商户编码 | mchntCd | MAX(15) | 是 | 是 | 商户编码富友分配 |
| 返回码 | respCode | MAX(8) | 是 | 是 | 0000=成功；其他失败 |
| 返回描述 | respDesc | MAX(60) | 是 | 是 | 交易成功 |
| 分账入账方编号 | accountIn | MAX(15) | 是 | 是 | 由富友生成 入账方的商户编号 |
| 分账合同编号 | contractSsn | MAX(60) | 是 | 是 | 由富友生成 出账方和入账方的分账合同 |
| 分账合同规则 | ruleNo | MAX(4) | 是 | 是 | 由富友生成 一般固定是0001 |
| 签名 | signature | MAX | 是 | 否 | AyaQBsq2NmxmMMaSSIg2........ |