diff --git a/content/docs/开发/HRO接口文档.md b/content/docs/开发/HRO接口文档.md new file mode 100644 index 0000000..6a0a80b --- /dev/null +++ b/content/docs/开发/HRO接口文档.md @@ -0,0 +1,785 @@ +--- +title: HRO接口文档 +--- + + + +# 易才代收付API + +**修订记录** + +版本号 | 更新日期 | 更新人 | 更新内容 +--- | --- | --- | --- +v0.1 | 2020-12-29 | 赵磊 | 初稿 + +[TOC] + +## 接口设计 + +### 报文头 + +报文头格式为:“\报文头内容\”,内容结构详见接口设计部分公共报文头 + +### 报文体 + +报文体主要用于传输业务数据信息,格式为:“\报文体内容\” + +### 通讯 + +Protocol:HTTP +Method:POST +Content-Type:application/xml;charset=utf-8 + +### 签名 + +将HTTP Body中的数据流用MD5进行签名,将签名结果与密钥拼接生成签名串,再使用SHA256对签名串进行哈希,结果放在HTTP Request Header中,Key为Signature + +```java +String contentMD5 = byteArrayToHexString(MD5(bodyStream.getBytes("UTF-8"))); +String signature = Base64.encode(SHA256((contentMD5 + secretKey).getBytes("UTF-8"))); +``` + +bodyStream 为字节数组 + +### 报文格式 + +- 请求 + + ```xml + + + + v1.0 + diskApply + 20210104000000000001 + 20200104235959 + + + + 20201229 + 20201229000000000000000000000001 + /data/send/20201229000000000000000000000001 + v1 + OHJEMIA1EINGUGAH0AITHOHNUEYAHWOO + 1000001 + c5950a259435d3e51262539a10a22910 + + + ``` + +- 返回 + + ```xml + + + + 000000 + 交易成功 + 20210104235959 + + + ``` + +## 接口清单 + +序号 | 服务名 | 描述 | 报文方向 | 是否签名 +:---: | --- | -- | :----: | :----: +1 | diskApply | 批量代付申请 | HRO -> 沐融代付 | Y +2 | diskResult | 批量代付结果查询 | HRO -> 沐融代付 | Y +3 | diskNotify | 批次终态通知 | 沐融代付 -> HRO | Y +4 | refundQuery | 退票查询 | HRO -> 沐融代付 | Y +5 | customerSync | 客户信息同步 | HRO -> 沐融代付 | Y +6 | titleSync | 支付地账户信息同步 | HRO -> 沐融代付 | Y +7 | transStsSync | 业务状态同步 | HRO -> 沐融代付 | Y +8 | cardInfoQuery | 卡信息查询 | HRO -> 沐融代付 | Y + +### 公共请求/响应头 +- 请求 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + version | VARCHAR(10) | M | 接口版本 | v1.0 + serviceName | VARCHAR(50) | M | 服务名 | eg. diskApply + requestId | VARCHAR(48) | M | 请求ID | 全局唯一 + requestTime | VARCHAR(14) | M | 请求时间 | eg. 20210104120000 + +- 返回 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + requestId | VARCHAR(48) | M | 请求ID | 全局唯一 + respCode | VARCHAR(8) | M | 返回码 | 详见 [响应码](#响应码) 的定义 + respMessage | VARCHAR(100) | M | 返回信息 | + respTime | VARCHAR(14) | M | 服务器时间 | + +### diskApply [批量代付申请] + +- 请求 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + applyDate | VARCHAR(8) | M | 送盘日期 | eg. 20201229 + diskNo | VARCHAR(48) | M | 磁盘编号 | eg. 20201229000000000000000000000001 + filePath | VARCHAR(100) | M | 文件名 | eg. /data/send/2020/1229/20201229000000000000000000000001 + fileVersion | VARCHAR(8) | O | 文件版本 | eg. v1 默认v1 + customerId | VARCHAR(48) | M | 客户编号 | eg. OHJEMIA1EINGUGAH0AITHOHNUEYAHWOO + titleId | VARCHAR(48) | M | 支付地抬头ID | eg. 1000001 + md5 | VARCHAR(32) | M | 磁盘MD5值 | eg. c5950a259435d3e51262539a10a22910 + +- 返回 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + [公共返回头] | | | | 详见[公共请求/响应头] + +### diskResult [批量代付结果查询] + +- 请求 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + applyDate | VARCHAR(8) | M | 送盘日期 | eg. 20201229 + diskNo | VARCHAR(48) | M | 磁盘名称 | eg. 20201229000000000000000000000001 + makeFile | VARCHAR(1) | O | 是否生成回盘文件 | eg. Y:是 N:否 默认N + +- 返回 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + diskSts | VARCHAR(1) | M | 批次状态 | 0:接收中 9:接收失败 1:已接收完成 2: 批次处理中 3: 批次处理完成 4: 批次处理失败 + lastDate | VARCHAR(8) | M | 最后更新日期 | + lastTime | VARCHAR(6) | M | 最后更新时间 | + totalCount | VARCHAR(8) | M | 总笔数 | + totalAmount | VARCHAR(18) | M | 总金额 | + succCount | VARCHAR(8) | M | 成功笔数 | + succAmount | VARCHAR(18) | M | 成功金额 | + failCount | VARCHAR(8) | M | 失败笔数 | + failAmount | VARCHAR(18) | M | 失败金额 | + filePath | VARCHAR(100) | M | 文件路径 | eg. /data/recv/2020/1229/20201229000000000000000000000001 + md5 | VARCHAR(32) | M | 磁盘MD5值 | eg. c5950a259435d3e51262539a10a22910 + + +### diskNotify [批次终态通知] + +> 批次完成后通知HRO系统 + +- 请求 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + diskNo | VARCHAR(48) | M | 磁盘名称 | + diskSts | VARCHAR(1) | M | 批次状态 | 0:接收中 9:接收失败 1:已接收完成 2: 批次处理中 3: 批次处理完成 4: 批次处理失败 + lastDate | VARCHAR(8) | M | 最后更新日期 | + lastTime | VARCHAR(6) | M | 最后更新时间 | + totalCount | VARCHAR(8) | M | 总笔数 | + totalAmount | VARCHAR(18) | M | 总金额 | + succCount | VARCHAR(8) | M | 成功笔数 | + succAmount | VARCHAR(18) | M | 成功金额 | + failCount | VARCHAR(8) | M | 失败笔数 | + failAmount | VARCHAR(18) | M | 失败金额 | + filePath | VARCHAR(100) | M | 文件路径 | eg. /data/recv/2020/1229/20201229000000000000000000000001 + md5 | VARCHAR(32) | M | 磁盘MD5值 | eg. c5950a259435d3e51262539a10a22910 + +- 返回 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + [公共返回头] | | | | 详见[公共请求/响应头] + + +### refundQuery [退票查询] + +- 请求 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + startDate | VARCHAR(8) | M | 开始日期 | + endDate | VARCHAR(8) | M | 结束日期 | + +- 返回 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + diskNo | VARCHAR(48) | N | 磁盘编号 | + transId | VARCHAR(48) | N | 业务平台流水号 | 沐融交易流水号 + refId | VARCHAR(48) | N | 参考号 | HRO明细流水号 + bankRefId | VARCHAR(48) | N | 银行流水号 | + acctNo | VARCHAR(48) | Y | 账号 | 卡号、存折号 + acctName | VARCHAR(150) | Y | 姓名 | + transDate | VARCHAR(14) | Y | 交易日期 | + transSts | VARCHAR(1) | Y | 交易状态 | U:未处理 P:处理中 S:成功 F:失败 T:超时 X:未知错误 + amount | VARCHAR(18) | Y | 金额 | 分为单位 + refundCode | VARCHAR(5) | Y | 退票代码 | + refundPs | VARCHAR(100) | N | 退票附言 | + payerAcctNo | VARCHAR(48) | Y | 出款账号 | + payerAcctName | VARCHAR(100) | Y | 出款户名 | + remark | VARCHAR(100) | Y | 备注 | + +### customerSync [客户信息同步] + +- 请求 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + customerId | VARCHAR(48) | M | 客户编号 | + customerName | VARCHAR(100) | M | 客户名称 | + customerCode | VARCHAR(48) | M | 客户代码 | + rank | VARCHAR(100) | M | 等级 | 数字1~3,数字越大代表等级越高 + enabled | VARCHAR(1) | M | 是否启用 | Y:启用 N:停用 + +- 返回 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + [公共返回头] | | | | 详见[公共请求/响应头] + +### titleSync [支付地账户同步] + +- 请求 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + titleId | VARCHAR(48) | M | 支付地抬头ID | + titleName | VARCHAR(48) | M | 支付地抬头名称 | + bankCode | VARCHAR(20) | M | 银行代码 | 详见 [银行通道](#银行通道) + brNo | VARCHAR(20) | M | 开户行所在分行号 | 详见 [分行号](#分行号) + acctNo | VARCHAR(30) | M | 账号 | + acctName | VARCHAR(100) | M | 户名 | + enabled | VARCHAR(1) | M | 是否启用 | Y:启用 N:停用 + +- 返回 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + [公共返回头] | | | | 详见[公共请求/响应头] + +### transStsSync [业务状态同步] + +- 请求 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + applyDate | VARCHAR(8) | Y | 申请日期 | + refId | VARCHAR(48) | Y | 参考号 | HRO明细流水号 + transSts | VARCHAR(1) | Y | 交易状态 | S:成功 F:失败 R:已退票 + respMessage | VARCHAR(100) | Y | 响应信息 | + +- 返回 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + [公共返回头] | | | | 详见[公共请求/响应头] + +### cardInfoQuery [卡信息查询] + +- 请求 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + cardNo | VARCHAR(32) | Y | 卡号 | + +- 返回 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + bankType | VARCHAR(4) | Y | 银行类型 | + cardType | VARCHAR(2) | Y | 卡类型 | + cardName | VARCHAR(100) | Y | 卡名称 | + +## 文件格式 + +### 送盘 + +- 首行 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + totalCount | VARCHAR(8) | Y | 总笔数 | + totalAmount | VARCHAR(18) | Y | 总金额 | 分为单位 + titleId | VARCHAR(48) | Y | 支付地抬头ID | + customerId | VARCHAR(48) | Y | 客户编号 | + costItem | VARCHAR(5) | Y | 费项代码 | 01201:代发工资 04900:其他费用 + +- 循环体 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + acctNo | VARCHAR(48) | Y | 账号 | 卡号、存折号 + acctName | VARCHAR(150) | Y | 姓名 | + refId | VARCHAR(48) | Y | 参考号 | HRO明细流水号 + amount | VARCHAR(18) | Y | 金额 | 分为单位 + bankType | VARCHAR(10) | N | 银行类型 | 存折与大小额时必输 + bankCity | VARCHAR(100) | N | 开户行所在城市 | 存折与大小额时必输 + bankName | VARCHAR(100) | N | 开户银行网点 | 存折与大小额时必输 + postscript | VARCHAR(100) | N | 银行附言 | + remark | VARCHAR(100) | N | 备注 | + +### 回盘 + +- 首行 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + totalCount | VARCHAR(8) | Y | 总笔数 | + totalAmount | VARCHAR(18) | Y | 总金额 | 分为单位 + succCount | VARCHAR(8) | Y | 成功笔数 | + succAmount | VARCHAR(18) | Y | 成功金额 | 分为单位 + failCount | VARCHAR(8) | Y | 失败笔数 | + failAmount | VARCHAR(18) | Y | 失败金额 | 分为单位 + titleId | VARCHAR(48) | Y | 支付地抬头ID | + customerId | VARCHAR(48) | Y | 客户编号 | + +- 循环体 + + 字段名称 | 类型 | 必输 | 描述 | 备注 + --- | --- | :----: | ---- | --- + acctType | VARCHAR(2) | Y | 账号类型 | 01:借记卡 02:贷记卡 03:准贷记卡 00:其他 + acctNo | VARCHAR(48) | Y | 账号 | 卡号、存折号 + acctName | VARCHAR(150) | Y | 姓名 | + transId | VARCHAR(48) | Y | 业务平台流水号 | 沐融交易流水号 + refId | VARCHAR(48) | Y | 参考号 | HRO明细流水号 + bankRefId | VARCHAR(48) | Y | 银行流水号 | + amount | VARCHAR(18) | Y | 金额 | 分为单位 + bankType | VARCHAR(10) | N | 银行类型 | + postscript | VARCHAR(100) | N | 银行附言 | + payerAcctNo | VARCHAR(48) | Y | 出款账号 | + payerAcctName | VARCHAR(100) | Y | 出款户名 | + orgNo | VARCHAR(100) | N | 合作机构编号 | + remark | VARCHAR(100) | Y | 备注 | + transSts | VARCHAR(1) | Y | 明细状态 | U:未处理 S:成功 P:处理中 F:失败 T:超时 X:未知错误 + respMessage | VARCHAR(100) | Y | 返回信息 | + +## 附录 + +### 费项代码 + +代码(costItem) | 说明 +----- | ---- +00000 | 通用费项 +00100 | 电费 +00201 | 用水费 +00202 | 排水费 +00204 | 污水处理费 +00205 | 暖气费 +00206 | 冷气费 +00207 | 垃圾处理费 +00208 | 环卫费 +00302 | 燃气费 +00400 | 电话费 +00500 | 通讯费 +00501 | 数据通讯费 +00503 | 代维费 +00504 | 网络使用费 +00505 | 信息服务费 +00600 | 保险费 +00607 | 保险赔付金 +00608 | 托底安置补贴 +00609 | 住房公积金 +00700 | 房屋管理费 +00701 | 房屋租赁费 +00702 | 租赁服务费 +00703 | 物业管理费 +00704 | 清洁费 +00705 | 保安服务费 +00706 | 电梯维护保养费 +00707 | 绿化费 +00708 | 停车费 +00709 | 物业专项维修金 +00710 | 公路规费 +00711 | 港口建设费 +00712 | 高速公路费 +00713 | 交通罚没款 +00800 | 代理服务费 +00801 | 押运服务费 +00802 | 票据传递费 +00803 | 代理记账服务费 +00900 | 学教费 +00901 | 报考费 +00902 | 学杂费 +00903 | 保教费 +00904 | 劳务费 +00905 | 培训补贴 +01000 | 有线电视费 +01002 | 移动电视费 +01003 | 传输服务费 +01100 | 企业管理费用 +01101 | 工商行政管理费 +01102 | 商检费 +01103 | 返代扣缴税手续费 +03000 | 国库汇款 +03001 | 国库退库 +03002 | 财政拨款 +04901 | 土地使用费 +04902 | 加油卡费 +04903 | 消费贷款 +04904 | 代付货款 +04905 | 血款 +04906 | 付手续费 +04907 | 广告费 +04908 | 邮费 +04910 | 速递费 +01200 | 薪金报酬 +01201 | 工资 +01202 | 奖金 +01203 | 养老金 +07001 | 福利彩票 +07100 | 证券基金 +07101 | 基金申认购 +07102 | 基金赎回/分红/撤单/退款 +07104 | 基金垫支 +09001 | 费用(报销) +04900 | 其他费用 + +### 响应码 + +应答码(respCode) | 描述(respMessage) +--- | --- +00 | 操作成功 +01 | 支付失败。详情请咨询您的发卡行 +02 | 您输入的卡号无效,请确认后输入 +03 | 支付失败,您的发卡银行不支持该商户,请更换其他银行卡 +04 | 交易失败,请重试 +05 | 文件校验错误 +06 | 您的卡已经过期,请使用其他卡支付 +09 | 业务处理中 +10 | 公司账号不符 +11 | 您卡上的余额不足 +13 | 账号已挂失 +14 | 您的卡已过期或者是您输入的有效期不正确,支付失败 +15 | 您输入的银行卡密码有误,支付失败" +16 | 账号户名不符 +18 | 交易未通过,请尝试使用其他银联卡支付或联系95516 +20 | 您输入的转入卡卡号有误,支付失败 +21 | 您输入的验证信息有误,支付失败 +22 | 付款币种非法 +23 | 失败,请检查交易对应业务是否已经开通 +25 | 查找原始交易失败 +30 | 报文错误 +31 | 交易受限 +32 | 系统维护中 +36 | 交易金额超限,支付失败 +37 | 原始金额错误 +39 | 您已连续多次输入错误密码 +40 | 您的银行卡暂不支持在线支付业务,请向您的银行咨询如何加办银联在线支付 +41 | 您的银行卡不支持认证支付,请选择快捷支付 +42 | 您的银行卡不支持小额支付,请选择快捷支付 +43 | 您的银行卡不支持认证支付 +44 | 代发金额或次数超限 +56 | 您的银行卡所能进行的交易受限,详细请致电发卡行进行查询 +57 | 该银行卡未开通银联在线支付业务 +60 | 银行卡未开通认证支付 +61 | 银行卡开通状态查询次数过多 +71 | 交易无效,无法完成,支付失败 +72 | 无此交易 +73 | 扣款成功但交易超时 +74 | 对不起,该操作员只能在交易当日进行 +80 | 内部错误 +81 | 可疑报文 +82 | 验签失败 +83 | 超时 +84 | 订单不存在 +85 | 不支持短信发送 +86 | 短信验证码错误 +87 | 您的短信发送过于频繁,请稍候再试 +88 | 您的短信发送累计过于频繁,请在x分钟后重试 +89 | 对不起,短信发送失败,请稍候再试 +90 | 请您登录工商银行网上银行或拨打95588进行后续认证操作 +93 | 请致电您的银行以确定您的个人客户基本信息中的相关信息设置正确 +94 | 重复交易 +95 | 您尚未在邮储银行网点柜面或个人网银签约加办银联无卡支付业务,请去柜面或网银开通 +97 | 请致电您的银行以确定您的用户信息是否设置正确,并咨询是否已经开办银联在线支付 + + +### 银行通道 + +银行代码(bankCode) | 银行类型(bankType) | 银行名称(bankName) +--- | --- | --- +LJCB | 0492 | 龙江银行 +QSCCB | 6409 | 齐鲁银行 +QSSCCB | 0438 | 齐商银行 +YRRCB | 1446 | 宁夏黄河农村商业银行 +ZYCCB | 0586 | 中原银行 +SDRCB | 1408 | 顺德农村商业银行 +QHCB | 6458 | 青海银行 +QHRCB | 1449 | 青海省农村信用社联合社 +QDCB | 0450 | 青岛银行 +YASCB | 0566 | 雅安市商业银行 +SXNRCU | 1442 | 陕西省农村信用社联合社 +YQCCB | 0908 | 阳泉市商业银行 +CZCCB | 0512 | 长治银行 +CCAB | 0541 | 长安银行 +TLCCB | 0539 | 铁岭银行 +JHCB | 0426 | 金华银行 +CQRB | 1413 | 重庆农村商业银行 +CQTGB | 0542 | 重庆三峡银行 +BEEB | 1420 | 鄞州银行 +ESB | 0534 | 鄂尔多斯银行 +ZZCB | 0435 | 郑州银行 +HDCB | 0517 | 邯郸银行 +XTCCB | 0554 | 邢台银行 +SNZCB | 0551 | 遂宁银行 +LYCCB | 0419 | 辽阳银行 +LNNC | 1454 | 辽宁省农村信用社联合社 +GZCB | 0463 | 赣州银行 +BGZCB | 0500 | 贵州银行 +HSBCB | 0561 | 衡水银行 +HLCB | 0433 | 葫芦岛银行 +YKCB | 0465 | 营口银行 +LSB | 0497 | 莱商银行 +SZCB | 1430 | 苏州银行 +CITI | 0319 | 花旗银行 +ZGSCB | 0909 | 自贡银行 +SXCB | 0428 | 绍兴银行 +QHDCCB | 0457 | 秦皇岛银行 +HXCB | 0405 | 福建海峡银行 +SJBK | 0417 | 盛京银行 +WFCB | 6462 | 潍坊银行 +LHCCB | 0556 | 漯河银行 +HNNC | 1438 | 湖南省农村信用社联合社 +HUBCB | 0575 | 湖北银行 +HBRRB | 1410 | 湖北农信社 +WZCB | 0412 | 温州银行 +CBHB | 0318 | 渤海银行 +SC | 0671 | 渣打银行 +YZRCB | 1520 | 深圳福田银座村镇银行 +HNRB | 1448 | 海南省农村信用社联合社 +CZB | 0316 | 浙商银行 +TACB | 0528 | 泰安银行 +QZCCB | 0464 | 泉州银行 +HBCB | 0422 | 河北银行 +HBRC | 1441 | 河北省农村信用社联合社 +CZCB | 0476 | 沧州银行 +JYRCB | 1412 | 江阴农村商业银行 +JXCB | 0448 | 江西银行 +JXRCU | 1439 | 江西农信联合社 +JSCB | 0508 | 江苏银行 +JSRCU | 1424 | 江苏省农村信用社联合社 +JNRCB | 1460 | 江南农村商业银行 +HSBC | 0501 | 汇丰银行 +WHSZ | 0510 | 永亨银行 +WHRCB | 1459 | 武汉农村商业银行 +GLCB | 6491 | 桂林银行 +LZCB | 0495 | 柳州银行 +CYCB | 0549 | 朝阳银行 +QJCCB | 0906 | 曲靖市商业银行 +JCCB | 0904 | 晋城银行 +JZCCB | 0559 | 晋中银行 +DBS | 0324 | 星展银行 +KSRB | 1402 | 昆山农村商业银行 +KLCB | 0547 | 昆仑银行 +WXCCB | 1437 | 无锡农村商业银行 +PZHCCB | 0483 | 攀枝花市商业银行 +CMB | 0308 | 招商银行 +FSCB | 0430 | 抚顺银行 +CDCB | 0513 | 承德银行 +CHDCB | 0429 | 成都银行 +CDRB | 1422 | 成都农村商业银行 +HSB | 0504 | 恒生银行 +EBCL | 0315 | 恒丰银行 +HSCB | 6440 | 徽商银行 +DYCB | 0498 | 长城华西银行 +ZJGRB | 1416 | 张家港农村商业银行 +ZJKCB | 0490 | 张家口银行 +XJKCCB | 0565 | 库尔勒市商业银行 +BBWCB | 6478 | 广西北部湾银行 +GXZRCU | 1443 | 广西农村信用社联合社 +GZB | 0413 | 广州银行 +GZRB | 1405 | 广州农村商业银行 +GDRCU | 1450 | 广东省农村信用社联合社 +GDB | 0306 | 广东发展银行 +PDSCCB | 0548 | 平顶山银行 +PABC | 0410 | 平安银行 +CRRB | 1403 | 常熟农村商业银行 +SXRB | 1455 | 山西省农村信用社联合社 +SHDRB | 1414 | 山东省农村信用社联合社 +FDCB | 6466 | 富滇银行 +YBCCB | 0910 | 宜宾市商业银行 +AHRB | 1447 | 安徽省农村信用社联合社 +NBCB | 0408 | 宁波银行 +NDHB | 0550 | 宁波东海银行 +WHCB | 6481 | 威海市商业银行 +TCRCB | 1433 | 太仓农村商业银行 +TJBHRCB | 1456 | 天津滨海农村商业银行 +UOB | 0622 | 大华银行 +SCRC | 1452 | 四川省农村信用社联合社 +JXCCB | 0470 | 嘉兴银行 +TSCCB | 0499 | 唐山银行 +HRBCB | 0442 | 哈尔滨银行 +WJRCB | 1428 | 吴江农村商业银行 +JLCB | 0451 | 吉林银行 +JLNC | 1445 | 吉林农信联合社 +TZCB | 0459 | 台州银行 +WB | 0593 | 友利银行 +XMCB | 3930 | 厦门银行 +NCB | 0503 | 南洋商业银行 +NCSCB | 0496 | 四川天府银行 +NJCB | 0424 | 南京银行 +HRXJ | 0570 | 华融湘江银行 +HXB | 0304 | 华夏银行 +FSBK | 0787 | 华一银行 +BOB | 0403 | 北京银行 +BSB | 0479 | 包商银行 +LSZCB | 0555 | 凉山州商业银行 +IMCB | 0474 | 内蒙古银行 +IMRCU | 1451 | 内蒙古自治区农村信用联合社 +CIB | 0309 | 兴业银行 +LZB | 0447 | 兰州银行 +XYCCB | 0569 | 信阳银行 +BDCB | 0552 | 保定银行 +BCOM | 0301 | 交通银行 +YNRB | 6509 | 云南省农村信用社联合社 +JJCCB | 0454 | 九江银行 +LSSCB | 0540 | 乐山市商业银行 +ULMQCB | 0427 | 乌鲁木齐银行 +WHCCB | 0907 | 乌海银行 +LSHCB | 0905 | 临商银行 +BOC | 0104 | 中国银行 +PSBC | 0100 | 中国邮政储蓄银行 +CMBC | 0305 | 中国民生银行 +CCB | 0105 | 中国建设银行 +ICBC | 0102 | 中国工商银行 +ABC | 0103 | 中国农业银行 +CEB | 0303 | 中国光大银行 +CITIC | 0302 | 中信银行 +DGRB | 1415 | 东莞农村商业银行 +BEA | 0502 | 东亚银行 +SRCB | 6526 | 上饶银行 +SPDB | 0310 | 上海浦东发展银行 +FXBK | 0333 | 法国兴业银行 +BOS | 0401 | 上海银行 +SHRB | 1401 | 上海农村商业银行 +SZRCB | 1404 | 深圳农村商业银行 +DLCB | 0420 | 大连银行 +TCCB | 0434 | 天津银行 +LYCB | 0418 | 洛阳银行 +NXCB | 0436 | 宁夏银行 +CQCB | 0441 | 重庆银行 +GYCB | 0443 | 贵阳银行 +CSCB | 0461 | 长沙银行 +BRCB | 1418 | 北京农村商业银行 + + + + + +### 联行号 + +银行代码 | 联行号(总行) | 银行名称 +--- | --- | --- +ICBC | 102100099996 | 中国工商银行 +ABC | 103100000026 | 中国农业银行 +BOC | 104100000004 | 中国银行 +CCB | 105100000017 | 中国建设银行 +BCOM | 301290000007 | 交通银行 +CITI | 302100011000 | 中信银行 +CEB | 303100000006 | 中国光大银行 +HXB | 304100040000 | 华夏银行 +CMBC | 305100000013 | 中国民生银行 +CGB | 306581000003 | 广发银行 +PAB | 307584007998 | 平安银行(原深圳发展银行) +CMB | 308584000013 | 招商银行 +CIB | 309391000011 | 兴业银行 +SPDB | 310290000013 | 浦发银行 +EBCL | 315456000105 | 恒丰银行 +CZB | 316331000018 | 浙商银行 +CBHB | 318110000014 | 渤海银行 +HSCB | 319361000013 | 徽商银行 +PSBC | 403100000004 | 中国邮政储蓄银行 +BOS | 313290000017 | 上海银行 +BOB | 313100000013 | 北京银行 +NBCB | 313332082914 | 宁波银行 +JSCB | 313301099999 | 江苏银行 +TCCB | 313110000017 | 天津银行 +HBCB | 313121006888 | 河北银行 +XTCCB | 313131000016 | 邢台银行 +ZJKCB | 313138000019 | 张家口市商业银行 +CDCB | 313141052422 | 承德银行 +CZCB | 313143005157 | 沧州银行 +IMCB | 313191000011 | 内蒙古银行 +BSB | 313192000013 | 包商银行 +ESB | 313205057830 | 鄂尔多斯银行 +DLCB | 313222080002 | 大连银行 +YKCB | 313228000276 | 营口银行 +JLCB | 313241066661 | 吉林银行 +HRBCB | 313261000018 | 哈尔滨银行 +BON | 313301008887 | 南京银行 +WZCB | 313333007331 | 温州银行 +SXCB | 313337009004 | 绍兴银行 +TZCB | 313345001665 | 台州银行 +XMCB | 313393080005 | 厦门银行 +GZCB | 313428076517 | 赣州银行 +SRCB | 313433076801 | 上饶银行 +QDCB | 313452060150 | 青岛银行 +QSSCCB | 313453001017 | 齐商银行 +WFCB | 313458000013 | 潍坊银行 +LSHCB | 313473070018 | 临商银行 +ZZCB | 313491000232 | 郑州银行 +LYCB | 313493080539 | 洛阳银行 +CSCB | 313551088886 | 长沙银行 +BBWCB | 313611001018 | 广西北部湾银行 +LZCB | 313614000012 | 柳州银行 +CQCB | 313653000013 | 重庆银行 +PZHCCB | 313656000019 | 攀枝花市商业银行 +FDCB | 313731010015 | 富滇银行 +LZB | 313821001016 | 兰州银行 +KLCB | 313882000012 | 昆仑银行 +HLCB | 313227600018 | 葫芦岛银行 +LSB | 313463400019 | 莱商银行 +LJCB | 313261099913 | 龙江银行 +SZCB | 313305066661 | 苏州银行 +SHDRB | 402451000010 | 山东省农村信用社联合社 +WHCB | 313465000010 | 威海市商业银行 +QHCB | 313851000018 | 青海银行营业部 +HXCB | 313391080007 | 福建海峡银行 +CCAB | 313791030003 | 长安银行股份有限公司 + +### 分行号 + +分行名 | 代码(brNo) +--- | --- +北京 | 10 +广州 | 20 +上海 | 21 +天津 | 22 +重庆 | 23 +沈阳 | 24 +南京 | 25 +武汉 | 27 +成都 | 28 +西安 | 29 +太原 | 35 +郑州 | 37 +石家庄 | 38 +唐山 | 39 +大连 | 41 +长春 | 43 +哈尔滨 | 45 +呼和浩特 | 47 +银川 | 51 +苏州 | 52 +青岛 | 53 +宁波 | 54 +合肥 | 55 +济南 | 56 +杭州 | 57 +温州 | 58 +福州 | 59 +泉州 | 60 +无锡 | 62 +南通 | 63 +烟台 | 65 +东莞 | 69 +南宁 | 71 +西宁 | 72 +长沙 | 73 +深圳 | 75 +佛山 | 77 +南昌 | 79 +贵阳 | 85 +昆明 | 87 +海口 | 89 +乌鲁木齐 | 91 +厦门 | 92 +兰州 | 93 +香港 | 97 +总行 | 01 diff --git a/content/docs/开发/dev.md b/content/docs/开发/dev.md index 7f2cfcb..ee4363c 100644 --- a/content/docs/开发/dev.md +++ b/content/docs/开发/dev.md @@ -28,9 +28,9 @@ title: "开发指南" Host | User | Password | Remark ---- | ---- | -------- | ------ -192.168.1.4 | capadm | capadm | 代收付核心 -192.168.1.4 | uiadm | uiadm | 运营管理系统 -192.168.1.5 | capadm | capadm | 数据库 +182.18.1.4 | capadm | capadm | 代收付核心 +182.18.1.4 | uiadm | uiadm | 运营管理系统 +182.18.1.5 | capadm | capadm | 数据库 @@ -59,7 +59,6 @@ Host | User | Password | Remark - 库表要分区 -- diff --git a/content/docs/需求/channel_cmb.md b/content/docs/需求/channel_cmb.md index a4439c5..4fd4a96 100644 --- a/content/docs/需求/channel_cmb.md +++ b/content/docs/需求/channel_cmb.md @@ -2,7 +2,6 @@ title: 银行待沟通问题列表(招行) --- - ## 银行待沟通问题列表(招行) - 商务&流程 @@ -11,67 +10,127 @@ title: 银行待沟通问题列表(招行) - 多久可以提供测试参数? + > 2~3个工作日 + - 是否具备现成的联调环境? + > 有联调环境 + - 是否有专人配合联调? + > 有专人配合 + - 开发完成后银行是否需要在测试环境上验收? + > 测试环境需要验收,执行案例并填写银行给的测试报告 + - 生产参数及前置机软件多久可以提供? + > 2~3个工作日 + - 我方投产后行方是否需要生产环境的验收? + > 我方自行验证 + - 跨行 - 大额、小额、超网 的限额及时效各是什么样的? + + > 大额:实时,100W以上(5 x 8) + > 小额:非实时,100w以下(7 x 24) + > 超网:实时,100w以下(7 x 24) - 未走超网的跨行业务是否一定要上送开户行行名、开户所在地、开户行支行名或联行号? + > 大小额需要上送;超网不需要上送 + - 他行的存折能否处理? + > 原则上支持存折,具体取决于收款行 + - 跨行的退票接口哪几个字段可以到原业务批次号跟交易流水号? + > 可以关联 + + - 提供支持超网的银行列表 + + > ==待银行会后提供== + - 业务 - 单笔/单批/单日/单月/单年金额、笔数上限各为多少? + > 有上限,具体限额根据商务协议定 + - 超网代发接口中chnflg= Y,但是金额超过5W,是否会自动走大小额? + > 该笔会失败 + - 不同法人的子公司账户通过一个银企接入具体应该如何操作? - + + > 通过关联操作可以实现子公司账户统一以集团编号对接银行 + - 能否提供全量的错误码与错误信息及对应的业务状态? + > 提供不全,但只需判断业务的状态码 + - 能否提供详细的接口文档 + > 提供新版云直连接口 + - 批次提交后多久可以获取回盘? + > 最少10秒后获取回盘 + - 节假日是否提供服务? + > 提供 + + - 支持哪些费用,是否有编码 + + > 招行仅支持代发工资、代发其他两种 + - 批付业务是逐笔记账还是并笔记账? + + > 按照批次金额并笔记账 - 文档中未找到对账接口,有无对账? + > 无对账 + - 性能 - 银行侧是否有流量控制? + > 不超过5个并发 + - 最大支持多少并发数? + > 不超过5个并发 + - 正常的接口请求平均响应时间是多少? + > 秒级 + - 网络相关 - 云直联是否通过公网接入?能否提供专线接入? + > 提供公网与专线两种方式接入 + - 前置机相关 - 单套前置机最大支持多少并发数? + > 不使用前置机方案 + - 使用U-KEY还是软证书? - - 工行银企的前置机能否部署在虚拟化的操作系统? + > 不使用前置机方案,不涉及U-Key - 能否使用多个U-KEY部署多套前置机? + > 不使用前置机方案,不涉及U-Key + diff --git a/content/docs/需求/channel_icbc.md b/content/docs/需求/channel_icbc.md index be7dbe8..012952e 100644 --- a/content/docs/需求/channel_icbc.md +++ b/content/docs/需求/channel_icbc.md @@ -12,65 +12,121 @@ title: 银行待沟通问题列表(工行) - 多久可以提供测试参数? + > 2~3个工作日 + - 是否具备现成的联调环境? + > ==工行近期更换环境,1月下旬到1月底才有联调环境== + - 是否有专人配合联调? + > 专人配合 + - 开发完成后银行是否需要在测试环境上验收? + + > 工行不验收,但需要易才出示带公章的验收报告,工行提供模板 - 生产参数及前置机软件多久可以提供? + > 2~3个工作日 + - 我方投产后行方是否需要生产环境的验收? + > 不验收 + - 跨行 - 大额、小额、超网 的限额及时效各是什么样的? + > 大额:实时,100W以上(5 x 8) + > 小额:非实时,100w以下(7 x 24) + > 超网:实时,==5w以下==(7 x 24) + - 跨行业务是否要上送开户行行名、开户所在地、开户行支行名或联行号? + > 大小额、超网均需要上送开户行信息(联行号与开户行名2选1) + - 他行的存折能否处理? + > 原则上支持存折,具体取决于收款行 + - 跨行的退票如何处理?有没有接口可以获取? - - 若有退票,是否可以关联到原批次与原明细? + > ==无接口可用,只能线下人工处理== + + - 若有退票,是否可以关联到原批次与原明细? + + > 不支持退票查询 - 业务 - 单笔/单批/单日/单月/单年金额、笔数上限各为多少? + + > 无限额 - 能否提供全量的错误码与错误信息及对应的业务状态? + > 提供不全,以业务状态码为准 + - 能否提供详细的接口文档 + > 需提供更详细的开发手册 + - <企业财务室指令提交>接口请求最大支持多少笔明细? + > 1000笔 + - 批次提交后多久可以获取回盘? + > ==批量模式1个小时~1个半小时== + > ==单笔模式立马可以返回结果== + - 节假日是否提供服务? + + > 提供 - 批付业务是逐笔记账还是并笔记账? + > 可并笔,但记账维度与我方不符 + - 文档中未找到对账接口,有无对账? + + > 无对账 - 性能 - 银行侧是否有流量控制? + > 前置机有流量控制 + - 最大支持多少并发数? + > ==前置机模式不支持并发,加密机模式支持1000并发== + - 正常的接口请求平均响应时间是多少? + > 秒级 + - 网络相关 - 通过公网接入?能否提供专线接入? + > 提供专线与公网两种方式接入(加密机模式直能用专线接入) + - 前置机相关 - 单套前置机最大支持多少并发数? + > 不支持并发 + - 使用U-KEY还是软证书? + + > 同事支持U-KEY与软证书 - 工行银企的前置机能否部署在虚拟化的操作系统? + + > 工行不建议使用前置机,推荐加密机来实现高高并发 - 能否使用多个U-KEY部署多套前置机? + > 工行不建议多前置机,推荐加密机来实现高高并发