中国电信翼支付技术规范-二维码前置平台接口分册(对接外系统)V1.0.0-20160406解读.doc

中国电信翼支付技术规范 --二维码前置接口(对接外系统)分册 2015年6月 前言 目录 版本信息 2 概述 2 1总体说明 2 1.1背景 2 1.2业务场景描述 2 1.3整体业务流程图 2 1.4本规范适用说明 3 1.5通信方式 3 2数据类型 3 2.1基本数据类型 3 2.2符号定义 4 3接口约定 4 3.1 API系统请求参数(SYSREQ) 4 3.2系统响应参数(SYSRES) 5 4接口定义 5 4.1 订单二维码解码接口 5 4.2第三方提交订单接口 7 5附录 8 5.1返回代码含义 8 版本信息 版本 修改人 日期 修改内容 概述 本文主要针对中国电信翼支付二维码前置接口类型、接口字段及其格式取值进行了规范说明。 1总体说明 1.1背景 1.2业务场景描述 适用于自动售货机、自助缴费终端机、停车场、iTV或出租车等，商户有屏幕展示二维码图片，且无专门的收银员或扫码枪，用户扫屏幕上的二维码自助完成支付，商户确认用户完成支付即提供商品或服务。 1.3整体业务流程图 图1 整体业务流程图 1.4本规范适用说明 中国电信翼支付二维码前置接口标准。 1.5通信方式 HTTPPOST 2数据类型 2.1基本数据类型 序号 类型缩写 类型描述 参考 1 a 字母a－z A、a、ab 2 n 数字0－9 1、12、-1 3 s 特殊字符 @、# 4 an 字母和数字字符 Word2 5 ans 字母、数字和特殊字符 Hell_wold1 6 yyyy 4位数年份 2010（2010年） 7 MM 年份中的月份 03（3月份） 8 DD 月份中的日期 25（25号） 9 hh 小时（24格式） 15（15点） 10 mm 分钟 30（30分） 11 ss 秒 59（59秒） 2.2符号定义 序号 符号缩写 符号性质 符号说明 1 M 强制域(Mandatory) 此域必选，否则将被认为格式出错 2 C 条件域(Conditional) 此域在一定条件下必选 3 O 选用域(Optional) 此域由发送方自选 3接口约定 3.1 API系统请求参数(SYSREQ) 名称 说明 类型 必填 最大长度 备注 method 调用的接口 ans M 32 根据各接口描述method定义传参 keep 请求流水 n M 30 外部自生成 channelNo 渠道标识 ans M 2 01 门户 02 交费易 03 资金归集 04 企账2.0 version 版本号 an O 10 企业账户1.0或2.0 sign 数字签名 ans M 64 数字签名 3.2系统响应参数(SYSRES) 名称 说明 类型 必填 最大长度 备注 responseCode 响应码 n M 8 代码定义见5.1 XXXXXXXX 前两位表示错误来源 00：没有错误 01：前置平台 02：数据库操作 03：二维码平台 04：业管平台 05：企业平台 后六位表示具体错误码 responseMsg 响应消息 ans M 128 描述文字信息 keep 请求keep n M 32 请求参数传入值 Sign 数字签名 ans M 64 数字签名 4接口定义 4.1订单二维码生成接口 测试环境访问地址：71:7080/BarcodeFront/barcode/newCreate 字段 名称 类型 必填 说明 serviceType 业务类型 ans M 参考serviceType结构定义 keep 请求流水 ans M channelNo 渠道标识 ans O 如： 01 门户 02 交费易 03 资金归集 04 企账2.0 timestamp 时间戳 ans M 发送请求的时间，格式“yyyy-MM-dd HH:mm:ss” 2015-01-01 01:01:01 bizContent 业务参数 ans M JSON 格式，具体包含的内容参见业务参数bizContent描述 option 可选项 ans O 扩展项 sign 密文 ans M 对bizContent对象做MD5加密，如：accountNo+key Key：BarcodeFront@ bizContent： 字段 名称 类型 必填 说明 accountNo 翼支付账户 ans M 翼支付账户（企业账户） accountName 翼支付账户名称 ans O 翼支付账户名称（企业账户） amount 订单金额 ans O 订单总金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000] expireTime 超时时间 ans O 该二维码允许的最晚有效时间，逾期将验证失败。格式为: yyyy-MM-dd HH:mm:ss。 comment 备注 ans O 备注 ex