当前位置：文档之家 › 泰州凤城一卡通空中充值接口规范1.0.5

泰州凤城一卡通空中充值接口规范1.0.5

  • 格式：docx
  • 大小：732.04 KB
  • 文档页数：52

泰州凤城一卡通空中充值接口规范V1.0.5【本文件中出现的任何文字叙述、文档格式、插图、照片、方法、过程等内容，除另有特别注明，版权均属上海捷羿软件系统有限公司所有，受到有关产权及版权法保护。

任何个人、机构未经上海捷羿软件系统有限公司的书面授权许可，不得以任何方式复制或引用本文件的任何片段。

】文档控制页目录1.概述 (5)1.1.数据类型 (5)1.2.报文格式说明 (5)1.3.数据域定义 (6)1.4.测试IP端口 (10)2.流程说明 (10)2.1.空中开卡 (10)2.2.空中激活 (11)2.3.充值（一卡通发起扣款） (12)2.4.充值（一卡通账户） (14)2.5.延期 (16)2.6.锁卡 (17)2.7.卡注销 (17)3.接口 (18)3.1.卡号申请J0005,600000007 (18)3.1.1.请求 (18)3.1.2.应答 (19)3.2.应用下载J0007,800000008（预个人化） (19)3.2.1.请求 (19)3.2.2.应答 (21)3.3.卡鉴权准备J0009,1000000009 (21)3.3.1.请求 (21)3.3.2.应答 (22)3.4.卡鉴权J0011,1200000010 (23)3.4.1.请求 (23)3.4.2.应答 (24)3.5.个人化J0013,1400000011 (24)3.5.1.请求 (25)3.5.2.应答 (26)3.6.卡激活请求J0019,200000001500000016（X） (27)3.6.1.请求 (27)3.6.2.应答 (28)3.7.卡激活确认J0021,220000001700000018(F0004) (29)3.7.1.请求 (29)3.7.2.应答 (30)3.8.订单发起J0015,1600000012 (31)3.8.1.请求 (31)3.8.2.应答 (33)3.9.充值请求J0002,3（J0023,24XX） (34)3.9.1.请求 (34)3.9.2.应答 (35)3.10.充值确认J0017,1800000013,00000014(F0005) (37)3.10.1.请求 (37)3.10.2.应答 (38)3.11.卡操作J0029,30 (39)3.11.1.请求 (40)3.11.2.应答 (41)3.12.注销请求J0031,3200000025 (42)3.12.1.请求 (42)3.12.2.应答 (43)3.13.注销确认J0033,3400000026 (44)3.13.1.请求 (44)3.13.2.应答 (44)3.14.账户余额查询 (45)3.14.1.请求 (45)3.14.2.应答 (46)3.15.账户交易明细查询 (47)3.15.1.请求 (47)3.15.2.应答 (48)4.对账 (49)5.附录A：签名算法 (50)5.1.中心测试公钥 (50)5.2.签名算法 (50)5.3.卡内PIN计算算法 (50)6.用户密码加密要求 (51)7.证件类型 (51)8.响应码表 (51)9.机构号、商户号 (52)10.附录E关键域格式说明 (52)10.1.B ALANCEINFO格式为JSON LIST对象 (52)10.2.TXNLIST格式为JSON LIST对象 (52)1.概述本文档对一卡通NFC接口规范进行说明。

本规范的接口以http的形式进行发布，数据采用json格式。

1.1. 数据类型数据类型限制1.2. 报文格式说明1.通信方式为http,使用POST方式提交请求参数：data，字符集UTF-8。

data数据的格式为json格式。

示例如下：{"txninfo":"报文体","signcode":"******"}报文体内容也为JSON格式：{"txncode":"charge","cardno":"2253123456781234"} signcode算法见附录A，数据项为txninfo键值内容。

以上数据的signcode计算域为{"txncode":"charge","cardno":"2253123456781234"}2.应答参数数据格式直接为json格式示例如下：{"txninfo":"报文体","signcode":"******"}报文体内容也为JSON格式：{"txncode":"charge","cardno":"2253123456781234"}3.报文中的数据区分大小写。

1.3. 数据域定义1.4. 测试IP端口2.流程说明以下流程图中的app和nfc平台指移动侧的平台。

2.1. 空中开卡空中开卡过程：获取卡号、创建卡结构、个人化（写入卡密钥及数据）。

流程如下：2.2. 空中激活2.3. 充值（一卡通发起扣款）1）订单请求应答报文如果响应码为“020003”，则app需要提示充值失败，并转“锁卡”流程2）app和nfc平台需要具备充值确认交易重发的功能。

通过参数控制重发的次数。

3）app充值请求应答报文的卡操作：如果卡片返回失败或未收到卡片的应答，app应通过充值初始化获取余额和充值计数器，根据卡号、余额和充值计数器确认写卡结果，如果无法判断，按照结果未确认处理，该订单将参与当日的清算。

4）充值成功后，app需要自动在001A文件中写入充值记录，该操作不得影响充值结果的判断。

该操作对用户透明。

5）App在充值成功后，需要自动发起延期交易，延期过程对用户透明，不影响充值结果的判断。

技术要求：在卡操作步骤中，充值成功后，需要对001A文件写充值记录具体操作步骤，1.进入住建部应用指令：[00A40000023F01]2.先验证PIN指令：[0020000106+PIN]验PIN算法见附录5.33.读0018文件的第一条记录指令：00B201C4174.把0018文件内容+卡卡片充值后金额（HEX）+TAC写入001A文件指令：[00E200D01F+0018数据[去除9000]+卡片充值后金额（HEX）+TAC]001A文件写充值记录的结果不得影响充值结果的判断。

泰州001A文件：泰州0018文件：2.4. 充值（一卡通账户）1）订单请求应答报文如果响应码为“020003”，则app需要提示充值失败，并转“锁卡”流程2）app和nfc平台需要具备充值确认交易重发的功能。

通过参数控制重发的次数。

3）app充值请求应答报文的卡操作：如果卡片返回失败或未收到卡片的应答，app应通过充值初始化获取余额和充值计数器，根据卡号、余额和充值计数器确认写卡结果，如果无法判断，按照结果未确认处理，该订单将参与当日的清算。

4）充值成功后，需要在001A文件中写入充值记录，该操作不得影响充值结果的判断。

该操作对用户透明。

5）App在充值成功后，需要自动发起延期交易，延期过程对用户透明，不得影响充值结果的判断技术要求：在卡操作步骤中，充值成功后，需要对001A文件写充值记录具体操作步骤，1.进入住建部应用指令：[00A40000023F01]2.先验证PIN指令：[0020000106+PIN]验PIN算法见附录5.33.读0018文件的第一条记录指令：00B201C4174.把0018文件内容+卡卡片充值后金额（HEX）+TAC写入001A文件指令：[00E200D01F+0018数据[去除9000]+卡片充值后金额（HEX）+TAC]001A文件写充值记录的结果不影响充值结果的判断。

泰州0018文件：2.5. 延期该业务在充值成功后，自动发起。

卡延期需要多次发送卡操作请求报文，直到中心返回apdunum=0或响应码为失败。

2.6. 锁卡该业务在充值请求应答响应码为黑名单卡后，由app进行处理，锁卡需要多次发送卡操作请求报文，直到中心返回apdunum=0或响应码为失败。

2.7. 卡注销注销业务由注销请求和注销确认组成。

App在请求报文需要上送卡余额，后台对余额进行判断，当前业务规则为只有余额为0的卡允许注销。

注销请求应答成功时，app才能卸载应用。

App应该保证注销请求和注销确认之间不能有其他交易。

如果有，则必须重新发起注销请求。

3.接口3.1. 卡号申请J0005,6000000073.1.1. 请求3.1.2. 应答3.2. 应用下载J0007,800000008（预个人化）卡应用下载只从一卡通下载指令完成卡结构创建的过程。

为减少交互，中心可能会返回多条指令，手机app需要依次执行指令，并判断执行结果。

成功后才能执行下一跳。

3.2.1. 请求3.2.2. 应答3.3. 卡鉴权准备J0009,10000000093.3.1. 请求3.3.2. 应答3.4. 卡鉴权J0011,12000000103.4.1. 请求3.4.2. 应答3.5. 个人化J0013,1400000011卡个人化指令使用安全域的会话密钥保护数据，因此，首次发送该请求前，需要执行“卡鉴权准备”和“卡鉴权”操作。

用于修改卡片个人化过程中，修改文件中的数据。

手机app需要依次执行指令，并判断执行结果。

成功后才能执行下一跳。

失败需要做异常处理。

3.5.1. 请求3.5.2. 应答3.6. 卡激活请求J0019,200000001500000016（X）3.6.1. 请求3.6.2. 应答3.7. 卡激活确认J0021,2200000017 00000018(F0004)3.7.1. 请求3.7.2. 应答3.8. 订单发起J0015,16000000123.8.1. 请求3.8.2. 应答3.9. 充值请求J0002,3（J0023,24XX）3.9.1. 请求3.9.2. 应答3.10. 充值确认J0017,1800000013, 00000014(F0005)3.10.1. 请求3.10.2. 应答3.11. 卡操作J0029,3000000023(延期1,3包)00000027(延期2包)00000024(锁卡)3.11.1. 请求3.11.2. 应答3.12. 注销请求J0031,32000000253.12.1. 请求3.12.2. 应答3.13. 注销确认J0033,34000000263.13.1. 请求3.13.2. 应答3.14. 账户余额查询J0035 J0036 000000283.14.1. 请求3.14.2. 应答3.15. 账户交易明细查询J0037 J0038000000293.15.1. 请求3.15.2. 应答4.对账运营商每天凌晨将上一日的交易以文件的方式ftp到一卡通指定的服务器，每天一个文件。

合集下载

中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

中国电信综合业务管理平台ISMP接口规范(RC1.0.0)-门户接口

CT综合业务管理平台ISMP接口规范-门户接口中国电信集团公司综合业务管理平台ISMP接口规范-门户接口SN RC1 ISMP V1.0.0目录1适用范围 (4)2引用标准 (5)3缩略语 (6)4需求约束 (7)5ISMP与用户门户之间的接口 (8)5.1ISMP与用户门户组网 (8)5.2终端信息查询接口 (8)5.2.1流程 (8)5.2.2概述 (8)5.2.3消息 (9)5.3功能调用接口 (9)5.3.1用户管理接口 (10)5.3.2认证与授权接口 (16)5.3.3定购管理接口 (19)5.4门户统一配置接口 (31)5.4.1终端信息同步接口 (32)5.4.2SP信息同步接口 (39)5.4.3内容信息同步接口 (40)5.4.4内容与产品关系同步接口 (43)5.4.5业务类别同步接口 (44)5.4.6业务信息同步接口 (45)5.4.7产品信息同步接口 (47)5.4.8套餐信息同步接口 (49)5.4.9集团产品信息同步接口 (51)5.4.10号段信息同步接口 (52)5.4.11业务引擎URL信息同步接口 (53)5.4.12回执文件 (54)5.4.13业务小图标同步接口 (54)附录A.业务能力编号及业务类型 (55)附录B.门户结果码定义 (56)综合业务管理平台ISMP接口规范-门户接口SN RC1 ISMP V1.0.0前言本规范定义了中国电信综合业务管理平台ISMP（Integrated Service Management Platform）的接口规范，包括ISMP与SS、ISAG、MSNMC、Portal、OCS、IN、运营支撑系统、CP/SP之间的接口。

本规范解释权属于中国电信集团公司。

本规范起草单位：中国电信股份有限公司上海研究院。

本标准主要起草人：韩彬斌，王铮，任华，方燕萍，黄铖斌，杨迪，张亚玫、宋金晶、黄颂尧。

综合业务管理平台ISMP接口规范-门户接口SN RC1 ISMP V1.0.01适用范围本规范适用于中国电信综合业务管理平台（ISMP）产品的设计及研发，提供给为中国电信开发制造ISMP的设备供应商。

034-中国联通在线计费(OCS)接口规范SMSC分册V1.0(20080815)

034-中国联通在线计费(OCS)接口规范SMSC分册V1.0(20080815)

3GPP 32.299:Diameter charging application
Short Message Peer to Peer Protocol Specification v3.4
4.
缩略语
英文
中文解释
AoC
Advice of Charge
计费通知
BSS
BusinessSupport System
业务接入控制点
SCP
Service Control Point
服务控制点
SDF
Service Data Point
业务数据点
SME
Short Message Entity
短消息实体
SMSC
Short Message Service Centre
短信息中心
SMPP
Short Message Peer to Peer Protocol
《中国联通在线计费系统（OCS）技术规范》
《中国联通在线计费系统（OCS）业务规范》
《中国联通在线计费系统（OCS）数据模型规范》
《中国联通在线计费系统（OCS）接口规范》
《中国联通在线计费系统（OCS）测试规范》
本文件为《中国联通在线计费系统（OCS）接口规范SMSC分册》。
本标准由中国联通公司信息化部提出并归口。
Diameter信控协议
ECF
Event Charging Function
事件计费功能
ESME
External Short Message Entity
扩展短消息实体
GGSN
Gateway GPRS Support Nodes
GPRS网关支持点
GPRS
General Packet Radio Service
中国移动数据业务实时计费接口规范-v100集采版

中国移动数据业务实时计费接口规范-v100集采版

中国移动通信企业标准QB-╳╳-╳╳╳-╳╳╳╳中国移动数据业务实时计费接口规范C h i n a M o b i l e O n l i n e C h a r g i n gI n t e r f a c e S p e c i f i c a t i o n f o r D a t aS e r v i c e版本号：1.0.0╳╳╳╳-╳╳-╳╳发布╳╳╳╳-╳╳-╳╳实施目录前言................................................................... III1.范围 (1)2.规范性引用文件 (1)3.术语、定义和缩略语 (2)4.数据业务实时计费方案 (3)4.1.方案概述 (3)4.2.Charging Characteristics字段 (5)4.3.数据业务实时计费漫游地解决方案 (6)5.实时计费流程 (6)5.1.流量计费类业务实时计费流程 (9)5.1.1.非内容计费类业务实时计费流程 (9)5.1.2.内容计费类业务实时计费流程 (11)5.2.时长计费类业务实时计费流程 (15)5.3.费率改变控制流程 (18)5.4.余额不足控制流程 (19)5.4.1.用户上线过程中发现余额不足 (19)5.4.2.用户使用数据业务过程中发现余额不足 (20)5.4.3.BOSS通过FUA指示重定向 (22)5.5.用户充值成功业务放通流程（可选） (24)5.6.HLR/HSS与BOSS中用户计费方式不一致流程（转离线计费） (25)5.7.用户不存在控制流程 (25)5.8.禁止用户使用业务流程 (26)5.9.条件改变触发上报控制流程 (27)5.9.1.SGSN/S-GW的IP地址改变 (27)5.9.2.PDP上下文/EPS承载的QOS改变 (28)5.9.3.无线接入技术改变 (29)5.10.异常流程 (30)5.11.PCC引入后实时计费流程 (32)5.12.其他流程 (34)6.DCCA协议定义 (35)6.1.协议结构 (35)6.2.协议格式 (35)6.2.1.消息头格式 (35)6.2.2.AVP头格式 (37)6.2.3.AVP数据格式 (38)6.3.消息列表 (40)7.Diameter协议命令集 (41)R/CCA (41)R (41)A (52)7.2.RAR/RAA (60)7.2.1.RAR (60)7.2.2.RAA (62)7.3.ASR/ASA (63)7.3.1.ASR (63)7.3.2.ASA (64)7.4.CER/CEA (65)7.4.1.CER (65)7.4.2.CEA (65)7.5.DWR/DWA (66)7.5.1.DWR (66)7.5.2.DWA (66)7.6.DPR/DPA (67)7.6.1.DPR (67)7.6.2.DPA (67)8.接口消息定义 (67)8.1.Service-Information参数定义 (67)R消息中的PS-Information参数定义 (67)A消息中的PS-Information参数定义 (72)8.2.Origin-Host参数定义 (73)8.2.1.网络侧Origin-Host参数定义 (73)8.2.2.BOSS侧Origin-Host参数定义 (73)8.3.AVP定义说明 (74)R消息中的AVP定义说明 (75)A消息中的AVP定义说明 (76)8.4.AVP Flag置位说明 (77)8.4.1.IETF 定义的AVP Flag置位说明 (77)8.4.2.3GPP定义的AVP Flag置位说明 (78)8.5.Result-Code定义说明 (80)8.5.1.Result-Code参数定义说明 (80)8.5.2.Result-Code场景举例 (86)8.6.PS-Free-Format-Data取值说明 (86)8.7.Service-Context-Id编码说明 (87)8.7.1.网络侧Service-Context-Id编码说明 (87)8.7.2.BOSS侧Service-Context-Id编码说明 (87)9.网络侧设备功能要求 (88)9.1.GGSN、PGW功能要求 (88)9.2.其他网元改造要求 (89)10.接口要求 (89)10.1.协议接口要求 (89)10.2.Diameter路由管理要求 (89)10.3.物理接口要求 (90)10.4.接口性能要求 (90)11.编制历史 (90)前言本标准依据3GPP等国际标准规范，结合中国移动其他企业标准，基于中国移动数据业务实时计费的实际需求，对GGSN、P-GW设备与业务支撑系统之间的实时计费接口提出规定，供中国移动内部和厂商共同使用，为设备引进、设备互通、网络规划、工程建设、运行维护及设备开发方面提供技术依据。

交通银行校园卡接口规范-1.2版

交通银行校园卡接口规范-1.2版

[内部使用] 校园一卡通接口规范交通银行湖南省分行-应用开发组2012年06月修订记录日期版本修订目的描述作者2012-7-2 1.0 文档初建贺鑫2014-7-2 1.1 修正贺鑫校园圈存机系统拓扑图圈存机前置银行中间业务平台银行校园卡前置校园圈存机校园圈存机总行核心总行端分行端学校端校园财务系统银校通系统通过专线连接，系统通过socket同步短连接，采用定长格式报文进行交互。

校园圈存机与银行校园卡前置进行交互。

本系统主要实现了以下功能：1、校园卡与银行的绑定批量绑定和单个绑定批量绑定：批量绑定采用文件接口，学校按照银行提供的批量处理的文件格式上传批量处理文件给银行，银行后台对批量文件进行批量处理，对后台开卡成功的数据进行校园卡与银行卡的关系绑定。

单个绑定：一般用于维护单个学生的校园卡与银行绑定关系的维护，学生持校园卡通过银行柜面或者自助通进行绑定关系的签约。

2、校园卡圈存机圈存学生持校园卡在校园内的任意一台圈存机上进行圈存，输入校园卡密码和充值金额即可完成充值。

3、校园卡充值缴费用户通过各种银行渠道对校园卡用户进行充值，银行系统完成充值交易后，通知校园圈存机前置充值缴费成功，同时校园卡圈存机系统中对该校园卡产生一笔待写卡记录，校园卡的持卡人可在任何时候任意一台校园圈存机上进行补写卡操作，从而完成校园卡充值。

接口约定：校园圈存机前置<－>银行银校通前置通讯方式“校园圈存机前置”通过专线向“银行银校通前置”相互请求，TCP/IP SOCKET 同步短连接方式。

报文协议报文协议：八位长度+定长报文头+报文体,长度不包括八位长度本身。

通讯包格式：定长格式。

上送下传报文头：requestid 10 学校代码（湘南学院 XNXY 银行 BANKCOMM）trancode 8 交易代码requesttime 14 交易时间(yyyymmddhhmmss)userid 10 请求的机具编号(圈存机编号)tranflowno 20 交易请求流水responsecode 6 返回码(成功000000 失败相应错误码) responsemsg 100 返回信息交易对照表：交易名称交易码备注校园卡圈存YXT10001 学校发起，银行提供服务校园卡圈存冲正YXT19001 学校发起，银行提供服务校园卡充值YXT20002 银行发起，学校提供服务校园卡充值冲正YXT29002 银行发起，学校提供服务学生基本信息查询YXT20003 银行发起，学校提供服务对账请求YXT30001 银行发起，学校提供服务1.圈存机圈存YXT10001（校园发起）1.1.功能描述圈存机圈存流程学生在圈存机上输入圈存金额校园卡系统向银行发起圈存请求银行根据学号查询出绑定的银行账户并进行圈存圈存成功后通知校园卡系统学号、圈存金额、姓名、身份证校园卡系统写卡同时银行校验校园卡的用户名、身份证等信息，必须本人信息学生通过校园圈存机发起圈存的请求，把学号、圈存金额、身份证、姓名等信息发送到银行校园卡前置，待银行完成账务处理后，返回处理结果给校园圈机前置，校园圈存机完成写卡后，交易结束。