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

中国电信翼支付技术规范-二维码前置接口(对接外系统)分册2015年6月前言 中国电信翼支付订单收款码接口文档目录版本信息2概述21总体说明21.1背景21.2业务场景描述21.3整体业务流程图21.4本规范适用说明31.5通信方式32数据类型32.1基本数据类型32.2符号定义43接口约定43.1 API系统请求参数(SYSREQ)43.2系统响应参数(SYSRES)54接口定义54.1 订单二维码解码接口54.2第三方提交订单接口75附录85.1返回代码含义813版本信息版本修改人日期修改内容概述本文主要针对中国电信翼支付二维码前置接口类型、接口字段及其格式取值进行了规范说明。1总体说明1.1背景1.2业务场景描述适用于自动售货机、自助缴费终端机、停车场、iTV或出租车等，商户有屏幕展示二维码图片，且无专门的收银员或扫码枪，用户扫屏幕上的二维码自助完成支付，商户确认用户完成支付即提供商品或服务。1.3整体业务流程图图1 整体业务流程图1.4本规范适用说明中国电信翼支付二维码前置接口标准。1.5通信方式HTTPPOST2数据类型2.1基本数据类型序号类型缩写类型描述参考1a字母azA、a、ab2n数字091、12、-13s特殊字符、#4an字母和数字字符Word25ans字母、数字和特殊字符Hell_wold16yyyy4位数年份2010（2010年）7MM年份中的月份03（3月份）8DD月份中的日期25（25号）9hh小时（24格式）15（15点）10mm分钟30（30分）11ss秒59（59秒）2.2符号定义序号符号缩写符号性质符号说明1M强制域(Mandatory)此域必选，否则将被认为格式出错2C条件域(Conditional)此域在一定条件下必选3O选用域(Optional)此域由发送方自选3接口约定3.1 API系统请求参数(SYSREQ)名称说明类型必填最大长度备注method调用的接口ansM32根据各接口描述method定义传参keep请求流水nM30外部自生成channelNo渠道标识ansM201 门户02 交费易03 资金归集04 企账2.0version版本号anO10企业账户1.0或2.0sign数字签名ansM64数字签名3.2系统响应参数(SYSRES)名称说明类型必填最大长度备注responseCode响应码nM8代码定义见5.1XXXXXXXX前两位表示错误来源00：没有错误01：前置平台02：数据库操作03：二维码平台04：业管平台05：企业平台后六位表示具体错误码responseMsg响应消息ansM128描述文字信息keep请求keepnM32请求参数传入值Sign数字签名ansM64数字签名4接口定义 4.1订单二维码生成接口测试环境访问地址：71:7080/BarcodeFront/barcode/newCreate字段名称类型必填说明serviceType业务类型ansM参考serviceType结构定义keep请求流水ansMchannelNo渠道标识ansO如：01 门户02 交费易03 资金归集04 企账2.0timestamp时间戳ansM发送请求的时间，格式“yyyy-MM-dd HH:mm:ss” 2015-01-01 01:01:01bizContent业务参数ansMJSON 格式，具体包含的内容参见业务参数bizContent描述option可选项ansO扩展项sign密文ansM对bizContent对象做MD5加密，如：accountNo+keyKey：BarcodeFbizContent：字段名称类型必填说明accountNo翼支付账户ansM翼支付账户（企业账户）accountName翼支付账户名称ansO翼支付账户名称（企业账户）amount订单金额ansO订单总金额，单位为元，精确到小数点后两位，取值范围0.01,100000000expireTime超时时间ansO该二维码允许的最晚有效时间，逾期将验证失败。格式为: yyyy-MM-dd HH:mm:ment备注ansO备注extension可选项ansO扩展项orderCode订单号ansO订单号cashierChannelNo透传渠道号ansO透传渠道号（010005_1_001）,由翼支付分配terminaNumber终端号ansO由商户传入示例：serviceType: BUSINESS_CHECKOUT,keep:20150908092131000000001,channelNo:150908092131000001,timestamp:2015-01-01 01:01:01,orderCode:150908092131000001,cashierChannelNo:3452343353245435bizContent:accountNo:17712345678189.cn,accountName:全家便利浦电路店,amount:99.99,comment:午餐,extension：orderCode:150908092131000001,cashierChannelNo:3452343353245435“terminaNumber”:”451211545121212”,sign:密文Sign加密原文：accountNo=17712345678189.cn&accountName=全家便利浦电路店&amount=99.99&comment=午餐&orderCode=150908092131000001&cashierChannelNo=345234335324543&KEY=BarcodeF响应结果为标准JSON字符串。参数含义类型必填备注success是否成功booleanMtrue：成功false：失败result调用返回值ansO当success为true时取此值，errorCode、errorMsg为空各接口返回的结果属性不同errorCode错误码ansO当success为false时取此值，result为空errorMsg错误描述ansO当success为false时取此值，result为空请求成功success为true时响应结果result为：属性含义类型长度必填备注qrcode二维码ansM4.2通知外系统接口规范通知外系统接口接口接口名称企业账户入账成功通知外系统接口接口描述企业账户入账成功通知接口提供者二维码前置平台接口调用者翼支付客户端接口类型HTTP POST应用场景企业账户入账成功通知外系统接口调用形式测试环境地址：（由外系统提供）备注以JSON格式返回通知外系统接口参数字段含义类型长度必填备注SIGN加密串用于验签操作ORDERCODE订单号M个人客户端调用解码接口后，调用二维码前置生成订单时透传给二维码前置TXNAMOUNT交易金额sM交易金额，单位为分OUTORDERNO翼支付订单号OPHONE翼支付登录账号O通知外系统接口应答参数字段含义类型长度必填备注RESPONSECODE响应码n8M00000000 表示成功,其它状态表示失败RESPONSECONTENT响应码描述ansC响应内容ORDERCODE=150908092131000001&TXNAMOUNT=10&KEY=BarcodeF 进行md5加密4.3查询支付状态接口查询支付状态接口接口名称外系统调用查询支付状态接口接口描述外系统调用查询接口查看订单入账是否成功接口提供者二维码前置平台接口调用者翼支付客户端接口类型HTTP POST应用场景外系统调用查询接口查看订单入账是否成功接口调用形式测试环境地址：71:7080/BarcodeFront/barcode/METHODqueryPaymentStatus备注以JSON格式返回查询支付状态接口请求参数字段含义类型长度必填备注SIGN加密串用于验签操作ORDERCODE订单号M外系统订单号查询支付状态接口应答参数字段含义类型长度必填备注RESPONSECODE响应码n8M00000000 表示支付成功,00000001 表示支付失败00000002 表示订单不存在00000003 表示未支付00000004 表示待核查019999 系统异常RESPONSECONTENT响应码描述ansC响应内容ORDERCODE=150908092131000001&KEY=BarcodeF md5加密5附录5.1返回代码含义00000000成功01000001参数错误01000002二维码消费单笔交易额超出限额01000003二维码消费日交易