ICS 35.200 CCS L 65 T/CI 151 —2022 虚拟商品交付平台 充值数据接口 Recharge data interface of virtual commodity delivery platform 2022 - 12 - 19发布 2022 - 12 - 19实施 中国国际 科技促进会 发布 团体标 准 全国团体标准信息平台 T/CI 151—2022 I 目 次 前言 ................................ ................................ .................. II 1 范围 ................................ ................................ ................ 1 2 规范性引用文件 ................................ ................................ ......1 3 术语和定义 ................................ ................................ .......... 1 4 缩略语 ................................ ................................ .............. 1 5 系统架构及功能 ................................ ................................ ......2 6 报文和接口数据定义 ................................ ................................ ..2 7 充值申请 ................................ ................................ ............ 4 8 充值操作 ................................ ................................ ............ 6 9 充值异常 处理 ................................ ................................ ........ 7 10 账户和个人隐私保护 ................................ ................................ .7 11 对账文件处理 ................................ ................................ .......7 附录A（资料性） 错误代码 ................................ .............................. 10 全国团体标准信息平台 T/CI 151—2022 II 前 言 本文件依据 GB/T 1.1 —2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》给出的 规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本文件由 杭州润歌网络有限公司 提出。 本文件由 中国国际科技促进会 归口管理。 本文件主要起草单位： 杭州润歌网络有限公司、 浙江微能科技有限公司、杭州硕洋科技有限公司、 杭州润升网络科技有限公司、浙江元幸信息科技有限公司 、杭州毕博标准化技术有限公司 。 本文件主要起草人： 夏远波、柴建峰、 鲁明、诸葛晓辉、王士岳、杨磊、豆行枫、 鲍鑫杰。 本文件由杭州润歌网络有限公司制定、并负责解释。 全国团体标准信息平台 T/CI 151—2022 1 虚拟商品交付平台 充值数据接口 1 范围 本文件规定了虚拟商品交付平台充值数据接口的术语和定义、缩略语、 系统架构及功能、报文 和接 口数据定义、充值申请、充值操作、充值异常处理、 账户和个人隐私保护 、对账文件处理 。 本文件适用于虚拟商品交付平台充值数据接口的设计、开发和应用。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。 其中， 注日期的引用文件， 仅该日期对应的版本适 用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T 1988 —1998 信息技术 信息交换用七位编码字符集 GB/T 13000 —2010 信息技术 通用多八位编码字符集（ UCS） 3 术语和定义 下列术语和定义适用于本文件。 3.1 虚拟商品 交付平台 virtual commodity delivery platform 通过通信网络实现对 电子商务市场中的数字产品和服务 进行充值、 操作、处理 和对账的系统。 3.2 清分 clearing 对当日的全部 网络交易数据进行汇总、整理、分类的过程。 3.3 报文 message 通过接口方式与 虚拟商品 交付平台进行交互，不含传输 控制字符的 字节串。 4 缩略语 下列缩略语适用于本文件。 APP 应用（ Application ） JSON 脚本对象简谱（ JavaScript Object Notation ） UTF Unicode转换格式（ Unicode Transformation Format ） IP 网络之间互联的协议（ Internet Protocol ） MD5 密码散列函数（ Message -Digest Algorithm ） 全国团体标准信息平台 T/CI 151—2022 2 5 系统架构及功能 5.1 系统架构 虚拟商品交付平台的 充值数据接口 应按照充值申请、充值操作、充值异常 处理、对账文件处理的流 程进行规范，并约定报文 和接口数据要求。系统 充值架构 见图1。 图1 系统架构图 5.2 功能要求 虚拟商品 交付平台 充值数据 接口应符合下列要求： a) 应具备与商户的充值申请 、充值操作和充值异常处理 、对账文件处理等进行对接的功能； b) 应实现充值 数据的清分结算。 6 报文和接口数据定义 6.1 报文格式说明 报文格式应符合下列要求： a) 通信方式应采用请求 -响应协议 ，使用投递 方式提交请求 参数，编码字符集应 符合GB/T 1988— 1998和GB/T 13000—2010中8位元（UTF -8）的要求。数据的格式应为JSON格式。 示例：http://xxxxx.com/recharge/mobile/order?appId=90001&requestId=2019125101...&sign=e10adc3949ba5 9abbe56e057f20f883e b) 应答参数数据格式应为 JSON格式。 示例：{ "code": "0000" ， "data": { 全国团体标准信息平台 T/CI 151—2022 3 "status": 0 ， "tradeNo": “1111111111111111 ” }， "requestId": "9cf0287d -b87c-4386-9b8f-880c71d87fa9" ， "succeed": true ， "message": " 交易成功 "， "timestamp": 1576817044 } c) 报文中的数据应区 分大小写 。 d) 通信应使用短链接 。 6.2 报文安全说明 报文安全应符合下列要求 ： a) 报文内容中应包含签名信息，除字段“ sign”外所有非空字段应从 a到z的顺序排序，若首字 母相同，则依据第二个字母，以此类推。字段名与值之间以“ =”相连，两个字段之间以“ &” 相连，结果后面直 接拼接分配的密钥，对最终结果进行 MD5签名。当服务端验签失败时，应 返回“失败”并丢弃报文。 示例：field1=value1&field2=value2&field3=value3 …… 注：空字段不需要进行验签，但“ &”需参与签名。 b) 虚拟商品交付平台 对商户请求接口 IP地址进行绑定。开户时，商户提供生产 IP给虚拟商品交 付平台。 6.3 接口及数据域定义 接口及数据域定义应符合表 1的规定。 表1 接口数据域定义 序号 内容 参数名称 类型 备注 1 通用请求参数 appId String（32） 商户号， 虚拟商品交付平台 分配 2 requestId String（64） 用于追踪调用信息 3 timestamp Number 请求时间戳， Unix时间戳 4 sign String（64） 签名 5 充值交易参数 outTradeNo App-ld String（64） 商户订单号，唯一 6 tradeNo String（64） 虚拟商品交付平台订单号 7 proCode String（16） 商品代码 8 proName