资源描述
中国移动网状网接口规范
V1.3.4
银行总对总缴费业务单行本
[在此处键入文档摘要。摘要通常为文档内容的简短概括。在此处键入文档摘要。摘要通常为文档内容的简短概括。]
目录
目录 1
文档变更记录 5
1 介绍 14
1.1 范围 14
1.2 规范性引用文件 14
1.3 参考文档 14
1.4 术语、定义和缩略语 14
1.4.1 术语、定义 14
1.4.2 缩略语 15
2 业务概述 15
2.1 业务定义 15
2.1.1 移动渠道发起的缴费 15
2.1.2 银行渠道代收费 16
2.2 业务属性 16
2.3 适用地区 16
3 实时接口 17
3.1 消息结构 17
3.1.1 消息头 18
3.1.2 消息体 21
3.2 接口方式总体说明 22
3.3 性能指标 22
3.4 安全性说明 22
3.5 编码规则 23
3.5.1 业务编码规则 23
3.5.2 交易编码规则 23
3.5.3 接口编码表 24
3.5.4 机构系统编码 26
3.6 接口消息 26
3.6.1 手机号码信息查询 26
3.6.2 银行账号校验接口 29
3.6.3 主号签约信息同步 31
3.6.4 副号签约信息同步 33
3.6.5 银行预签约接口 35
3.6.6 签约结果通知 38
3.6.7 签约用户缴费接口 40
3.6.8 充值接口 42
3.6.9 冲正接口 44
3.6.10 交易结果查询接口 46
3.6.11 发票打印情况查询 48
3.6.12 发票打印接口 51
3.6.13 支付结果通知 52
3.6.14 副号签约校验 54
3.6.15 手机号码身份信息验证 56
4 文件接口 58
4.1 文件统一格式说明 58
4.1.1 头记录格式 58
4.1.2 文件体格式 58
4.1.3 文件名格式 59
4.2 文件上传方式 59
4.3 签约信息对账 59
4.3.1 接口说明 59
4.3.2 文件体格式 61
4.3.3 异常流程 63
4.4 缴费对账 63
4.4.1 接口说明 63
4.4.2 文件体格式 65
4.4.3 异常流程 68
4.5 发票打印信息对账 68
4.5.1 接口说明 68
4.5.2 接口方式 68
4.5.3 文件格式 69
4.6 后付费批量代扣文件接口 69
4.6.1 接口说明 69
4.6.2 接口方式 69
4.6.3 文件格式 70
4.7 交易佣金结算文件接口 71
4.7.1 功能概述 71
4.7.2 接口方式 72
4.7.3 交易佣金文件记录格式 72
4.8 数据一致性文件 73
5 WEB接口 73
5.1 省公司网厅->中国移动统一支付系统的“签约”交易 74
5.1.1 签约请求 74
5.1.2 将用户重定向回中国移动省公司网上营业厅 76
5.2 省公司网厅->中国移动统一支付系统的“支付”交易 77
5.2.1 支付请求 77
5.2.2 将用户重定向回中国省公司移动网上营业厅 78
6 附录 79
6.1 机构系统编码 79
6.2 系统机构编码 80
6.3 路由类型编码 81
6.4 省代码表 81
6.5 系统应答类型以及应答代码 83
6.6 客户基本资料项目编码 83
6.7 用户状态编码 83
6.8 客户标识类型 84
6.9 证件类型编码 84
6.10 渠道标识 84
6.11 银行卡类型 85
6.12 缴费方式定义 85
6.13 用户类型标识 85
6.14 文件返回码 86
6.15 操作流水号编码规则 87
6.16 证件类型对照表 87
文档变更记录
序号
变更内容说明
版本号
版本日期
执笔人
1
规范初稿
V0.9
2012-10-26
张志刚
2
1、 补充业务编码、交易编码;
2、 接口增加交易属性;
3、 调整二级返回码为4位编码;
4、 增加接口消息结构和接口方式说明;
5、 明确了部分字段说明;
6、 批量批量代扣文件增加移动帐号
V0.9.1
2012-11-07
张志刚
3
1、 修订附录名称与规范内参考附录名称,前后名称一致
2、 修改省公司网厅签约和缴费接口方式
V1.0.0
2012-11-22
张志刚
4
1、 对签约和缴费相关接口安全性设置为:1、需要加密
2、 新增3.4安全性说明章节
3、 删除“安全方案”和“管理接口”章节
4、 增加“3.4安全性说明”章节,明确接口安全性要求为报文体加密。
V1.0.1
2012-12-5
张志刚
5
1、 “5WEB接口”章节,增加签名验签和加解密要求。
2、 根据建行反馈,“4.6后付费批量代扣文件接口”中,增加省代码
V1.0.2
2012-12-10
张志刚
6
1、 新增“3.6.15副号签约校验”接口
2、 “3.6.2银行账号校验接口”和“3.6.3主号签约信息同步”增加银行系统超时和银行系统异常编码
V1.0.3
2012-12-11
张志刚
7
1、 更新接口编码表(通过网上营业厅办理签约的交易编码,移动非签约网银缴费的业务编码)
2、 修改接口路由类型
3、 新增“3.5.4”机构系统编码
V1.0.4
2012-12-21
张志刚
8
1、 增加冲正接口应答报文
2、 “3.6.4副号签约信息同步”、“3.6.6签约结果通知”、“3.6.14支付结果通知”接口修改为通知类接口
3、 缴费对账文件缴费记录分为:成功、失败、冲正、退款
4、 修改“3.6.13 发票打印回退”接口中回退流水的描述
5、 “4.5发票打印信息对账”中增加回退记录
6、 统一所有接口中金额单位为:分
7、 签约交易日增量对账文件增加发起方标识
8、 “6.15 接口编码表”删除银行签约中手机号码查询接口,增加非签约用户银行渠道缴费流程
9、 修订“6.9 证件类型编码”
10、 “4.4.2.1省公司缴费业务日总账文件”和“4.4.2.2 统一支付系统缴费业务日总账文件”增加银行机构编码
11、 “4.4.1 接口说明”增加日总账文件说明
V1.0.5
2013-1-4
张志刚
9
1、 接口中金额相关字段格式设置为Num,长度设置为V9.0
2、 “3.6.6签约结果通知”增加操作流水和操作请求日期字段
3、 统一接口中操作流水的名称和长度
4、 增加“3.6.16 手机号码身份信息验证”接口
5、 删除“4.6.3.1头记录格式”,采用统一头记录格式
6、 对后付费批量代扣文件接口做了说明,明确文件处理方式
7、 交易佣金结算文件接口调整,佣金报表格式采用附件excel表格
V1.0.6
2013-1-22
张志刚
10
1、 更新3.5.3接口编码表章节
V1.0.7
2013-2-4
丁玉文
11
1、 消息和文件元素规范化
2、 更新6.9证件类型编码
3、 更新6.14文件返回码
4、 新增6.16证件类型对照表
5、 规范了文件接口中的目录和文件名
V1.0.8
2013-2-6
黄晓丽/丁玉文/李叶林
12
1、 修改1.3参考文档
2、 修改3.4 安全性说明
3、 修改3.1消息结构,参考总册说明
4、 修改实时接口中的请求报文体序号从1开始,应答报文体的序号从8开始
5、 交易属性增加了“存储模式”
6、 通知类交易的“交易属性”增加了“优先级”属性说明
7、 实时接口交易属性增加交易编码
8、 修改6.5系统应答类型及应答代码,使用网状网统一编码
9、 统一实时接口二级编码信息,编码参见网状网二级编码分册
V1.0.9
2013-2-21
张志刚
13
1.5.WEB接口 增加了签约 、支付的字段以及增加了参加摘要运算的字段,并具体说明了签名方案;
2.3.6.2银行账号校验接口增加银行编码字段、删除注解;
V1.1.0
2013-03-05
李剑锋、李叶林
14
1、 修改3.5.4机构系统编码
2、 修改手机号码信息查询接口应用场景描述
3、 删除3.6.5银行预签约接口SessionID取值说明
V1.1.1
2013-03-11
张志刚
15
1、 修改主号签约信息同步接口中银行账号元素名称为:BankAcctID
2、 副号签约信息同步接口修改为大圈类交易
V1.1.2
2013-03-29
张志刚
16
1、 3.6.2.5 银行账号校验接口应答报文中AuthNum字段备注为:暂不使用;
2、 5.1.1、5.2.1签约请求及支付请求中,Lang字段描述改为:默认为空;
3、 修订5.1.2章节UserPayType字段为UserCat,并调整取值;
4、 3.6.9.5章节,修订OrigReqSys字段名称为OriReqSys;
5、 修改3.6.3.4章节中UserIDType和UserID字段约束条件为1;
6、 增加银行总对总二级返回码编码。
V1.1.3
2013-4-11
李叶林、丁玉文、张志刚
17
1、 4.5.2 接口方式中的文件目录由incoming改为outgoing
2、 3.6.1手机号码信息查询,对于后付费的用户,增加返回用户姓名
3、 3.6.10交易结果查询接口请求报文,增加ActivityCode字段,实现按交易代码区分,可以到不同的交易表查询交易结果
V1.1.4
2013-4-22
丁玉文、张志刚
18
修订:
1、 2.2章节增加对账、冲正、结算不参与网状网系统;
2、 3.6.9冲正接口交易属性的交易类型由冲正类修改为大圈类;
3、 在3.6.9冲正接口和3.6.10交易结果查询接口的交易属性分节的路由类型增加UPSS作为落地方时的路由信息997。
4、 3.6.11至3.6.14 交易属性的发起方机构和落地方机构的取值;
5、 增加3.6.15章节的请求报文中MainIDType、SubIDType的取值说明;
6、 增加文件接口与附录相关节点的取值说明。
7、 4.6.3.1.1和4.6.3.1.2修改移动账号为银行账号
8、 3.6.1.4返回报文中的客户姓名改为非必填
9、 删除原3.6.13发票打印回退接口,因为银行侧没有对应接口,目前无法实现。
10、 3.6.9.4章节,修订OrigReqSys字段名称为OriReqSys;
V1.1.5
2013-5-6
魏益苗
丁玉文(7-10点)
19
1、 修改3.6.6签约结果通知,增加银行标志字段
2、 修改4.1.1文件头记录格式,添加文件总数字段
V1.1.6
2013-05-15
丁玉文
20
1、4.4.2.3 缴费业务日明细文件增加银行编号字段
2、3.6.13支付结果通知请求报文字段sig修改为可选;
3、3.6.3主号签约信息同步接口增加字段UserCat字段
4、删除4.5发票打印信息对账文件中两个字段,回退操作流水和回退时间
5、增加4.6后付费批量扣费文件中一个字段,银行编号
V1.1.7
2013-05-17
丁玉文
21
1、 修改4文件接口的各个接口的FTP服务器地址和目录
V1.1.8
2013-05-21
魏益苗
22
1、 修改3.6.3主号签约信息同步接口字段UserIDType、UserID修改为非必填,增加什么时候必填、什么时候非必填的描述
2、 删除3.5.3接口编码表中关于发票打印回退内容
3、 删除4.5.3发票打印信息对账文件格式字段OptType操作类型-回退描述内容
4、 删除4.5.1接口说明中关于发票打印回退的描述
V1.1.9
2013-05-24
丁玉文
23
1、 更改3.6.15 手机号码身份信息验证 请求报文SvcCont字段IdentityCheckReq描述
2、 修改4.6.2章节关于后付费回盘文件下发的时间
3、 4.3.2.1签约关系增量核对文件中的UserCat长度改为F1;4.3.2.2签约关系日增量差异处理文件中的UserCat长度改为F1;4.3.2.3签约关系月全量核对文件中的UserCat长度改为F1;4.3.2.4签约关系月增量差异处理文件中的UserCat长度改为F1。
V1.2.0
2013-05-31
丁玉文
24
1、 3.6.3主号信息同步接口的应答报文增加非必填字段SettleDate交易帐期;省发起主号签约成功时,UPSS返回银行交易帐期给省boss
2、 3.6.6签约结果通知接口增加必填字段SettleDate交易帐期
3、 3.6.8 充值接口的请求报文增加必填字段SettleDate交易帐期
4、 3.6.9 冲正接口, 修改ActionDate为OriActionDate, 修改TransactionID为OriTransactionID;添加必填字段TransactionID操作流水号,添加非必填字段SettleDateDate交易帐期。
5、 在4.4.1细化缴费对帐说明。
6、 修改4.4.2文件格式:缴费业务日总帐文件ActionDate缴费日期修改为SettleDate交易帐期;修改OrderType的填写说明。
7、 修改4.4.2.3 日明细对帐和4.4.2.4日明细差异处理文件中的ActionTime交易时间为SettleDate交易帐期。
8、 3.6.11修改发票操作帐期字段;
9、 3.6.12修改发票操作帐期字段、发票帐期字段、发票打印日期字段类型、发票打印流水字段
10、 4.5.3修改发票打印流水字段、发票打印时间字段;
11、 4.6.3.1.1修改省BOSS批扣帐期字段名;
12、 4.6.3.1.2修改省BOSS批扣帐期字段名和字段长度、银行帐期字段名、交易流水字段名
13、 在4.3.1接口说明中,增加签解约核对文件的生成规则和处理规则。
14、 在4.3.1和4.3.2的中,将签约关系日核对/差异文件名中的签约改为签解约。
V1.2.1
2013-06-13
余洪、黄晓丽、周双、付峰
25
1. 修改3.5.3接口编码表,增加副号码自动解约业务场景
2. 修改3.6.3.2业务场景描述
3. 删除3.6.4关于TransactionID的描述,添加到6.15里面
4. 修改3.6.8充值接口的描述,增加银行侧缴费
5. 修改3.6.9冲正接口的描述,区分省公司侧发起和移动侧发起的路由信息
6. 修改3.6.10结果查询请求和应答报文字段,更正字段名称
7. 修改3.6.11和3.6.12的路由类型,从统一支付发起请求,按手机号码路由
8. 修改4.3.1关于签解约对账的描述
9. 增加4.1.3文件名格式,YYYYMMDD填T日的日期
10. 修改4.6.3.1.2文件返回码字段从PayRes修改为DiffType
11. 修改3.6.11.4发票打印查询返回报文AcctDate的长度F8到F6
12. 修改3.6.10交易结果查询的返回报文关于返回码以及应答描述的描述
13. 修改3.6.15身份验证接口的返回码描述
14. 修改4文件接口中关于上传.doing临时文件的描述,不用再上传.doing文件。
V1.2.2
2013-06-24
丁玉文
26
1. 修改4.1.2关于文件错误的反馈文件的说明,增加错误反馈文件的上发和下载目录
2. 增加6.14文件返回码文件名错误
V1.2.3
2013-06-28
丁玉文
27
1. 修改4.3.1接口说明,改正笔误:日签约对账文件名从DAYLY改DAILY
2. 修改4.1.2描述,F001和F002改为F101和F102,F001和F002为不存在的文件错误码
3. 修改5.1.1签约请求接口,增加字段:PayType、RechThreshold、RechAmount字段
4. 修改4.1.2关于文件发生记录级错误的处理流程,由人工处理。
5. 修改3.6.7签约用户缴费的描述,添加主号绑定副号后,要48小时后才能为副号缴费。
6. 修改3.6.11发票打印情况查询接口,增加请求字段BankProv,打印网点归属省编码。
7. 修改5.1.1网关签约请求,增加网关签名拼接字段规则和签名的具体使用方法
V1.2.4
2013-07-07
丁玉文
28
1. 修改4.4.2.4缴费业务日明细差异处理文件,增加两个字段,BankID(银行编码)和ActionTime(交易时间)
2. 修改6.14文件返回码F101和F102的描述
3. 修改4.6.3.1.1批量代扣文件记录格式的TransactionID的长度改为V32位
V1.2.5
2013-07-25
丁玉文
29
联调修订的规范:
1. 修改5.1.1签约请求和5.2.1支付请求中参加签名运算中的字段的笔误,&改为|
2. 修改3.6.11.4发票打印情况查询,修改返回字段ItemName和ItemValue的长度
3. 修改4.4.2缴费对账日汇总的总金额字段的字段长度,从V9.0改为V16.0
4. 修改佣金文件的命名和说明
5. 修改6.14文件返回码,删除重复的F101和F103
6. 修改5.1.1签约请求中Sig签名字段的描述,增加进行utf-8转码的描述
天猫方案修改记录:
1. 增加3.6.16电商电商充值接口(全网方案);
2. 修改3.5.3接口编码表,增加电商充值接口的BIPCode和交易编码;
3. 增加4.9章节,天猫充值结算文件接口;
4. 修改3.6.8充值接口的说明,增加描述文字,天猫过渡方案将复用该接口;
5. 修改6.1机构系统编码文字描述,修改为机构系统编码-网状网侧;
6. 修改4.4.1缴费对账的接口说明,增加描述,在日汇总和日明细文件中,不包含天猫的充值记录,如果包括了天猫的充值记录,统一支付对此类记录不打回差异;
7. 修改6.2系统机构编码,增加电商机构编码;
8. 修改6.10渠道标识,增加电商渠道标识;
9. 修改银行系统机构编码描述为系统机构编码
V1.2.6
2013-08-21
丁玉文,周双
30
联调修订的规范:
1. 修改3.6.16.3交易属性中的交易编码
2. 修改4.7.2接口方式中的文件名称,增加机构码BBBB;
3. 修改3.6.11.4发票打印情况查询接口,修改ItemName和ItemValue为128长度。
4. 修改3.6接口消息中的交易属性,修改报文体加密配置为0,不需要配置。但接口3.6.2银行账号校验接口、3.6.3主号签约信息同步仍需要加密。
5. 修改3.6.15手机号码身份信息验证接口报文需要加密。
6. 修改3.6.1手机号码信息查询字段描述,响应报文客户姓名只填最后一个字;
7. 修改4.3.2.1、4.3.2.2、4.3.2.3、4.3.2.4核对文件和差异文件,增加描述,银行账号、客户证件号码除后四位之外以*号代替;
8. 修改4.6.3.1.1和4.6.3.1.2批扣文件和回盘文件描述,银行账号不需要填写;
9. 修改5.1.2将用户重定向回中国移动省公司营业厅描述,银行账号只填后四位;证件编码只填后四位;用户姓名只填最后一个字。修改证件类型、证件编号和用户姓名非必填。
10. 修改3.6.16.4交易报文中的字段描述,修改字段描述及接口描述,增加字段支付流水号。
11. 修改第5节WEB接口,增加支付结果通知请求、支付结果通知响应两个web接口,这四个接口部分省公司适用,省公司根据自身系统特点决定是否采用;修改部分描述,增加请求的发起方和落地方描述。
天猫方案修改记录:
1. 修改3.6.8充值接口,增加描述试点省方案;
2. 修改4.4.2.3缴费业务日明细文件,增加描述试点省方案;
3. 增加4.4.2.4缴费业务日明细文件(全网方案);
4. 修改4.4.2.5缴费业务日明细差异处理文件,增加描述试点省方案;
5. 增加4.4.2.6缴费业务日明细差异处理文件(全网方案);
6. 修改4.4.2.1省公司缴费业务日总账文件,增加描述试点省方案;
7. 增加4.4.2.2省公司缴费业务日总账文件(全网方案);
8. 修改4.4.2.3统一支付系统缴费业务日汇总文件,增加描述试点省方案;
9. 增加4.4.2.4统一支付系统缴费业务日汇总文件(全网方案);
10. 修改4.9.3.1和4.9.3.2天猫对账文件及差异文件,增加商品上架编码字段
V1.2.7
2013-09-11
丁玉文
31
移动商城方案修改记录:
1. 增加4.10移动商城对账文件接口;
2. 修改6.2系统机构编码,增加移动商城0055和移动手机支付0056系统编码;
3. 修改6.10渠道标识,增加06移动商城和07移动手机支付渠道标识;
V1.2.8
2013-09-12
丁玉文
32
1. 修改6.14,增加文件返回码F123,批扣失败
2. 修改3.6.3主号签约信息同步接口返回报文中的SubTime为选填;
3. 修改4.3.2.1、4.3.2.2、4.3.2.3、4.3.2.4核对文件和差异文件,增加描述,银行账号、客户证件号码除后四位之外以x代替
4. 修改3.6消息接口,增加对特殊字符的处理的描述,对特殊字符需要转换为x
5. 增加5.1接口说明,增加签名字符串的拼接规则说明,增加serverUrl(MerUrl)和backUrl的说明,以backUrl作为最终的结果通知。删除5.2.1签名请求中的签名字符串的规则说明
V1.2.9
2013-11-21
丁玉文
33
1、增加2.1.3浙江电商发起的缴费和2.1.4移动商城发起的缴费业务描述
2、增加3.5重发报文说明描述,重发的报文头的TransIDO使用新的TransIDO,其它字段保持不变,并增加省公司处理这个重发的描述。
3、根据生产和联调情况,修改部分接口的描述说明和约束,包括3.7.3、3.7.4、3.7.10、3.7.16、3.7.14、4.3.2.1、4.4.2.6、4.4.3、4.4.9、4.9.3.1、4.10.1.3.1、5.2.2、4.4.2.8。
4、4.7.3.2下发给省的银行酬金报表格式更新
V1.3.0
2013-12-27
丁玉文
余洪
34
1、 修改4.9.2.1、4.4.2.6、4.4.2.8、4.9.3.2中的Commison为Commision(属于对账文件的字段,不影响交易报文和对账)
2、 修改4.9.1接收说明,修改天猫对账原则说明
3、 修改4.9.1.2天猫充值结算文件接口说明中的全网方案文件描述,增加天猫对账差异记录的处理方式。
4、 修改了4.9.4天猫核对处理流程的文件,对于天猫多、移动少的差异记录,省公司不需要处理,由天猫进行退款处理
V1.3.1
2014-02-17
丁玉文
35
1、 修改4.10.1.1移动商城对账文件接口说明
2、 修改4.10.1.2移动商城对账文件接口方式
3、 增加4.10.1.3.2统一支付下发移动商城对账差异文件
V1.3.2
2014-02-27
丁玉文
36
1、 3.7.16充值接口修改OrganID机构编码的说明。移动商城发起的建行、银联充值时,机构编码填写建行或银联,以便区别移动商城发起的手机支付充值。
2、 6.2系统机构编码增加“0057 银联”的机构编码。
V1.3.3
2014-04-08
余洪
37
1、 3.7.7签约用户缴费接口增加总对总折扣、营销活动号等相关字段;
2、 3.7.16充值接口(全网方案)启用保留字段1,作为折扣率字段;
3、 5.3.1支付请求(省网厅非签约网银缴费)增加总对总折扣、营销活动号等相关字段;
4、 4.7.3交易佣金结算文件接口增加省网厅非签约缴费佣金计算的归类说明;
5、 修改6.10渠道标识,增加08类型,表示移动网上营业厅(非签约缴费适用) ;
6、 修改4.6.3.1.1批量代扣文件记录格式,增加折扣率和充值金额两个字段
7、 修改4.6.3.1.2批量代扣回盘文件记录格式,增加折扣率和充值金额两个字段
8、 修改3.6.3接口编码表,涉及省公司的冲正、退费接口为双向
9、 修改3.7.15充值接口,增加描述。描述移动商城充值时发起方和渠道标识的填写方式。并修改了交易属性的描述。
10、 修改4.10.1.1移动商城对账文件接口说明,增加对账文件取记录的范围描述
11、 修改4.3.2.1和4.3.2.2关于签解约关系日增量核对文件和差异处理文件关于TransactionID字段的描述
12、 修改3.7.8.2冲正接口应用场景,增加描述,规范省公司返回的冲正响应
13、 修改所有响应报文RspCode的描述,要求按二级返回码分册中的总对总特殊返回码返回。
14、 增加3.7.17省公司签到签退接口
去掉版本试点省版本相关信息
1、 删除3.6.3接口编码表关于试点省的交易码
2、 删除原3.7.8充值接口(试点省方案)
3、 删除原4.4.2.1省公司缴费业务日总账文件(试点省方案)
4、 删除原4.4.2.3统一支付缴费业务日总账文件(试点省方案)
5、 删除原4.4.2.5缴费业务日明细文件(试点省方案)
6、 删除原4.4.2.7缴费业务日明细差异处理文件试点省方案)
7、 删除原4.9.1.1过渡方案,删除原4.9.2文件体格式(过渡方案)
8、 删除其他关于含有“全网方案”的描述,不再使用“全网”此类描述。
V1.3.4
2014-04-29
丁玉文
余洪
38
修改4.6.1接口说明,删除批扣文件中不体现折扣率和充值金额等描述。
修改4.6后付费批量代扣文件接口的字段描述
在4.4.1、4.9.1补充说明根据结算机构编码生成各对账文件的规则
增加天猫月负账文件
修改4.9.1.1天猫充值全网接口方案,增加统一支付下发月负账文件;
增加4.9.2.3增加统一支付下发天猫月负账文件章节;
修改6.14文件返回码,增加F125和F126,表示天猫月负账退款记录有效或无效
增加日全量下发文件
增加4.4.2.5统一支付下发缴费业务日明细全量文件;
增加4.9.2.4统一支付下发天猫业务日明细全量文件;
增加4.10.1.3.3统一支付下发移动商城业务日明细全量文件。
增加有价卡业务
增加3.7.17到3.7.25共9个接口;
增加4.11有价卡交易文件接口
V1.3.5
2014-07-18
丁玉文
39
1、按照最新要求删除有价卡增加的相关接口,有价卡只有系统冲值冲正接口走统一支付平台;
2、对于省冲值接口增加有价卡相关有价卡冲值业务相关字段。
V1.3.5
2014.7.22
李晓明,吕振山
1 介绍
1.1 范围
本规范遵循业务规范《银行总对总缴费应用细化业务方案》,定义了全国性商业银行总对总客户缴移动话费业务的业务定义、业务要求、业务流程、业务管理等业务的接口描述。详细的从业务的角度描述移动和银行之间的业务流程,详细描述每个流程的活动的接口内容。通过定义每个活动的接口方式,协议和详细的接口内容,以及异常的处理模式。构建一个安全,稳定,高效的移动和银行的业务交换平台。
1.2 规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本标准。
1.3 参考文档
《中国移动与银行接口技术方案》
《中国移动统一支付系统技术方案》
《中国移动网状网系统接口规范 - 总册》
《中国移动网状网系统接口规范-二级返回码分册》
1.4 术语、定义和缩略语
1.4.1 术语、定义
下列术语、定义适用于本标准:
表1-1
词语
解释
对账
两个业务系统之间核对账务的过程。
结算
根据清分的结果,进行资金划拨的过程。
清分
是指根据资金往来交易的记录,按照一定的规则进行汇总分类计算出对帐文件,并进行轧差处理的过程。
1.4.2 缩略语
下列缩略语适用于本标准:
表1-2
词语
解释
BOSS
Business Operation Service System,业务运营支撑系统
GPRS
General Packet Radio System,通用无线分组业务
VCES
Value Card Electronic System 有价卡电子化系统
2 业务概述
2.1 业务定义
银行总对总客户缴费应用是指在移动总部系统和银行系统采用一点接入条件下,实现客户缴纳手机话费和营销活动费用的服务,根据客户缴费发起的渠道可划分为移动渠道发起的缴费和银行渠道代收费两大类型。
2.1.1 移动渠道发起的缴费
移动渠道发起的缴费包括非签约缴费和签约缴费。
2.1.1.1 非签约缴费
非签约缴费指客户不用将手机号码和任何银行账户进行签约绑定,即可通过移动门户网站等渠道缴纳手机话费和营销活动费用。
2.1.1.2 签约缴费
签约缴费指客户在将手机号码和银行账户进行签约绑定后,通过移动公司渠道发起缴费操作,从客户绑定的银行账户中扣除相应费用,缴纳手机话费或营销活动费用。
签约缴费按照发起缴费操作的方式,分为主动缴费和自动缴费两种方式:主动缴费由客户根据手机话费余额或账单情况自行发起缴费操作,按客户发起缴费操作的渠道类型,主动缴费包括网站缴费、短信缴费和热线缴费;自动缴费由移动公司系统根据客户预先设定的缴费条件自动发起缴费操作,按缴费条件设置类型,自动缴费包括预付费阀值充值和后付费自动扣费。
2.1.2 银行渠道代收费
银行渠道代收费指客户通过银行渠道发起缴费操作,以缴纳现金或从指定银行账户扣除相应费用,缴纳通信费用。
2.1.3 浙江电商发起的缴费
浙江电商发起的缴费是指客户通过天猫的移动官方旗舰店进行充值操作,从支付宝账号扣款,并扣除相关的佣金费用、积分返点费等相应费用,缴纳通信费用。
2.1.4 移动商城发起的缴费
移动商城发起的缴费是指客户通过移动商城发起的充值,进行缴纳通信费用,或者跳转银行页面,由银行完成充值。
2.2 业务属性
在对业务进行定义时,需要有属性以保证参与业务处理的各方在处理上保持一致性和完整性。业务属性的定义如下,其中冲正由平台或者省BOSS主动发起,网状网不做主动发起自动冲正交易,对账交易也由平台和BOSS双方对账,网状网并不参与:
1. 手续费:是指向客户收取的办理某项业务的人工费用。当收取手续费时,一般是在客户归属地帐户上作为一次性营业费用记帐;属性值为收取规则。
2. 冲正处理:是由系统在处理超时情况下自动发起的差错处理手段,用于保证受理方、全国中心、归属方之间业务的完整性、准确性;属性值为是否需要冲正;冲正不能够冲正前一个逻辑交易日的交易。
3. 人工冲正处理:人工冲正处理是指应客户要求或者营业员操作失误而对该客户已经受理成功的某项业务的复原交易。
4. 安全性要求:是指对于客服密码、帐户密码等客户私有信息以及交易报文或者报文中的关键信息项在传输过程中的保密要求;取值为是否PIN加密;另外为保证在传输过程中关键数据如金额和客户身份数据的防篡改,可以对这些数据进行摘要,属性取值为报文中需要进行摘要的字段。
5. 清分结算:是指对业务受理过程中产生的、需要在银行和移动之间进行转移或分配的费用的核对,取值为是否参与清分结算。
6. 对帐:是指对业务受理过程中涉及到用户费用、用户状态等关键数据变更的交易的核对。取值为是否参与对帐。
2.3 适用地区
本业务适用于合作银行已建立省级分支机构的省、自治区和直辖市,银行尚未建立省级分支机构的地区暂不开放此业务。
3 实时接口
3.1 消息结构
注:本章节内容来源于网状网总册,如果与总册冲突以总册内容为准。
原一级BOSS枢纽系统中,省BOSS和SN之间采用一个XML报文进行传输,报文头及报文体封装在单个大XML报文中,SN与SN之间也是采用单一XML进行报文传输,而实际运行中绝大部分业务部不需要处理报文体,只需解析报文头,因此对于大报文的XML解析造成处理效率的部分浪费,在网状网中,对机构<->SN以及SN<->SN之间的报文进行拆分。
交易在机构和SN之间的消息是以XML格式表达的,所有的XML均以UTF-8格式封装。
请求消息包括两个XML文件:Message Header(消息头)与Message Body(交易业务内容);其中Message Header用于存储交易请求的公共部分和消息的控制数据,而Message Body包含交易请求的业务数据。
应答消息由一个XML文件构成,消息头和消息体都在这一个文件中,消息体以XML格式存储(UTF-8格式),在交易报文传输时作为Message Header的一个元素“SvcCont”和Header一起传输。为了方便处理和校验Service Content,在此元素中以常量(包含XML TAG)即CDATA形式存在。
对于系统大圈类交易,若某业务分册规范中说明该系统大圈交易的“应答SvcCont为空”,则无SvcCont节点。
对于存储转发类交易,业务分册规范均说明其应答的Service Content为空。即,通知类交易,不存在SvcCont节点。
在本文档中以表格的形式表示XML格式;以下为表格中对元素约束(出现次数)的表示方法的描述:
符号
含义
?
0..1,可选项
*
0..n,可以没有,也可以有多项
+
1..n,至少有1项,也可以有多项
1
数字1,代表必须且只能填1项
参考W3C的HTTP 1.1规范。
在HTTP传输过程中,HTTP Header部分需要遵循下面的约定:
在请求报文中:content-type=multipart/form-data
在应答报文中:content-type=multipart/mixed
HTTP交易报文需要遵循以下约定,报文头的parameter名为“xmlhead”;报文体的parameter名为“xmlbody”,如果有附件,附件的parameter名为“attachfile”。例如:
xmlhead=报文头内容
xmlbody=报文体内容
attachfile=附件内容
3.1.1 消息头
消息头中是各类交易控制信息、路由信息。系统大圈交易的应答报文包含在消息头中,见消息头格式SvcCont字段,系统大圈的应答报文没有独立的消息体。
根据XML的定义,每个XML文件需要有特定的Root Tag(根标记),Message Header的Root Tag为“InterBOSS”。各个字段解释如下表,各机构在实现时可使用枢纽定义下发的XSD文件。
表1:SN与机构之间交互的统一消息头格式
序号
父元素名称
元素名称
约束
类型
长度
描述
取值说明
1
InterBOSS
Version
展开阅读全文