中国银联股份有限公司企业标准Q/CUP071.2.5—2015全渠道平台产品接口规范第一卷商户卷第5部分手机支付——手机控件支付产品版本号:V1.22015-03-31发布2015-03-31实施发布Q/CUP071.2.5—2015I中国银联股份有限公司(以下简称“中国银联”)对该规范文档保留全部知识产权权利,包括但不限于版权、专利、商标、商业秘密等。任何人对该规范文档的任何使用都要受限于在中国银联成员机构服务平台()与中国银联签署的协议之规定。中国银联不对该规范文档的错误或疏漏以及由此导致的任何损失负任何责任。中国银联针对该规范文档放弃所有明示或暗示的保证,包括但不限于不侵犯第三方知识产权。未经中国银联书面同意,您不得将该规范文档用于与中国银联合作事项之外的用途和目的。未经中国银联书面同意,不得下载、转发、公开或以其它任何形式向第三方提供该规范文档。如果您通过非法渠道获得该规范文档,请立即删除,并通过合法渠道向中国银联申请。中国银联对该规范文档或与其相关的文档是否涉及第三方的知识产权(如加密算法可能在某些国家受专利保护)不做任何声明和担保,中国银联对于该规范文档的使用是否侵犯第三方权利不承担任何责任,包括但不限于对该规范文档的部分或全部使用。Q/CUP071.2.5—2015I版本控制信息版本日期修改人说明1.12015-04-30吴潇银行卡验证信息及身份信息的加密方式待系统开发上线后再修订;姓名字段长度改为301.12015-05-11吴潇数据元说明checkFlag的备注中“证件号后8位”改为“证件号”;交易状态查询交易请求报文的txnTime、orderId改为条件上送,并明确其上送的情况,明确queryId上送的情况;账单支付交易请求报文的txnAmt改为必送1.12015-05-19吴潇产品接口规范仅包含商户卷,机构可参考全渠道平台接入接口规范。1.22015-06-05吴潇修改消费交易请求报文的发卡机构代码的备注1.22015-06-12吴潇修改保留域、风控信息域的数据元说明,删除交易中这两个域的备注Q/CUP071.2.5—2015II目次前言............................................................................III1范围................................................................................12规范性引用文件......................................................................13业务方案说明........................................................................14总体技术方案........................................................................25报文数据元说明......................................................................76交易报文...........................................................................227对账文件...........................................................................548批量文件...........................................................................569附录...............................................................................56Q/CUP071.2.5—2015III前言本标准对全渠道平台商户侧的跳转产品——网关支付产品接口做具体规定。本部分为《全渠道平台接入接口规范》的产品分册第五部分:手机支付——手机控件支付产品。本部分由中国银联提出。本部分由中国银联组织制定和修订。本部分的主要起草单位:中国银联股份有限公司本部分的主要起草人:戚跃民、鲁志军、李伟、夏智、谭颖、查骏、齐宁、胡新松、吴潇Q/CUP071.2.5—20151银联全渠道平台产品接口规范第一卷商户卷第5部分手机支付——手机控件支付产品1范围本标准规定了商户与中国银联全渠道平台之间的手机支付——手机控件支付产品进行联机交易时使用的报文接口,包括联机交易报文的元素、报文格式以及相关说明。本标准适用于所有接入中国银联全渠道平台的商户。本规范对应的全渠道平台产品目录说明内容为:商户版银联在线支付网关产品及银联手机支付—银联手机支付—手机控件支付。2规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本标准。Q/CUP006《银行卡联网联合技术规范V2.1》Q/CUP001《银行卡信息交换术语》Q/CUP071.1《全渠道平台接入接口规范》3业务方案说明3.1应用场景手机支付控件是提供给商户移动客户端或WAP网站安全地调用银联手机支付(有卡或无卡)清算通道的软件包。手机支付控件提供内置模式或外调模式两种产品形态,供商户选择。内置模式采用SDK开发包,外置模式调用银联控件客户端。目前手机支付的手机控件支付产品支持消费功能、预授权功能。3.2业务流程主要页面展现:1、卡号支付:Q/CUP071.2.5—201522、账号支付:4总体技术方案4.1交易模式按交易模式进行分类,全渠道平台支持的交易可分为前台类交易、后台资金类类交易、后台非资金类交易、查询类交易、批量类交易。4.1.1前台类交易前台类交易是指交易请求方(如商户、收单机构)与全渠道平台之间的交易信息通过用户浏览器进行传递的交易,是一种异步的、需要持卡人参与完成的交易类型。对于涉及金额的前台类交易(即交易请求中有金额字段),全渠道平台系统均会给请求方后台通知,请求方也必须实现接收后台通知。对于交易状态未知的交易请求方必须发起交易状态查询交易。移动支付订单推送的交易流程是一种特殊的前台类交易,其交易流程如下:Q/CUP071.2.5—201538:返回支付结果手机客户端(含控件)全渠道系统商户系统3:处理请求数据4:返回交易流水号5:转发交易流水号6:调用支付控件,发送支付请求数据1:确认购买商品请求2:生成并推送订单信息7:处理请求交易9:客户端前台通知10:异步返回支付结果交易步骤:1、浏览并选购商品:用户通过手机客户端与商户系统交互浏览选购商品,客户端向商户系统发送购买商品请求数据。2、生成并推送订单信息请求数据:商户系统根据选购商品请求数据生成订单数据集,把构造完成的订单信息数据集合按照移动支付系统的订单信息推送接口,通过商户后台提交(POST)的方式传递给移动支付系统。3、移动支付系统对请求数据进行处理:移动支付系统得到这些集合后,会先进行安全校验等验证,一系列验证通过后便会处理这次发送过来的数据请求。4、返回交易流水号:移动支付系统返回商户系统交易流水号应答。5、转发交易流水号:商户系统转发交易流水号至手机客户端。6、调用支付控件,发起支付请求数据:手机客户端收到交易流水号等要素,调起支付控件,用户输入支付信息后,客户端按照移动支付系统的支付接口规则组装并发送支付请求数据至移动支付系统。7、移动支付系统对请求数据进行处理:移动支付系统得到这些集合后,会先进行安全校验等验证,一系列验证通过后便会处理这次发送过来的数据请求。8、返回支付结果:移动支付系统返回结果至手机客户端。9、返回支付结果:支付控件返回商户客户端支付结果(目前为了兼容控件第一期,未采用frontEndUrl方式来返回结果)。10、移动支付系统后台异步返回处理的结果数据:对于成功处理完成的交易,移动支付系统服务器主动发起通知,调用商户在请求时设定好的后台通知地址路径(参数backEndUrl),把支付结果数据反馈给商户。11商户对获取的返回结果数据进行处理:商户在前台通知处理页面(参数frontEndUrl指定页面)或服务器后台通知页面(参数backEndUrl指定页面)获取移动支付返回的结果数据后,可以结合自身网站的业务逻辑进行数据处理(如:订单更新等操作)。以后台通知为准。若未收到后台通知,需要发起交易信息查询请求。Q/CUP071.2.5—20154相关说明:商户后台接收到移动支付系统支付成功通知交易后,需返回全渠道系统后台确认已收到应答。4.1.2后台资金类交易后台类资金类交易是指交易请求方(如商户、收单机构),将交易信息(涉及资金清算的交易)直接通过请求方服务器发送至全渠道平台服务器的交易方式。是一种异步的、不需要持卡人参与完成的交易类型。因涉及资金的清算,全渠道平台系统均会给请求方后台通知,请求方也必须实现接收后台通知。对于交易状态未知的交易请求方必须发起交易状态查询交易。一般交易状态查询交易为前端主动发起,可查询N次(一般为5次),每次时间间隔2N秒发起。交易处理流程如下:商户银联全渠道交易系统1.商户组织交易报文,发送给银联全渠道系统3.银联全渠道系统组织受理结果报文,返回给商户5.商户未收到交易结果,可通过发起交易状态查询,查询处理结果2.全渠道系统完成商户的交易处理4.涉及资金类的交易,全渠道系统发送后台通知给商户交易步骤:1、商户组织交易报文,发送给银联全渠道系统;2、全渠道系统完成商户的交易处理;3、银联全渠道系统组织受理结果报文,返回给商户;4、涉及资金类的交易,全渠道系统发送后台通知给商户;5、如果商户没有收到交易结果,可通过向全渠道系统发起交易状态查询交易,查询交易处理结果。相关说明:1、每个交易需要的报文要素是不一样的,具体每个交易需要的要求,请参阅本规范第二部分对应交易的请求和应答报文;2、图中第3步中的应答仅代表该笔后台请求交易已经受理,不代表全部处理成功;是否处理成功,需通过接受后台通知或者发起“交易状态查询交易”进行查询;3、图中第4步后台应答返回的URL为请求报文中的“backUrl”字段指定的URL。4.1.3后台非资金类交易后台类非资金类交易是指交易请求方(如商户、收单机构)将交易信息(不涉及资金清算的交易)直接通过请求方服务器发送至全渠道平台服务器的交易方式。后台非资金类交易均为同步短连接方式,Q/CUP071.2.5—20155不需要持卡人参与完成的交易类型。若通讯超时,则交易请求方可以重复发起交易。交易处理流程如下:商户银联全渠道交易系统1.商户组织交易报文,发送给银联全渠道系统3.银联全渠道系统组织交易结果报文,同步返回给商户2.全渠道系统完成商户的交易处理交易步骤:1、商户组织交易报文,发送给银联全渠道系统;2、全渠道系统完成商户的交易处理;3、银联全渠道系统组织交易结果报文,同步返回给商户;4.1.4查询类交易查询交易是指交易请求方(如商户、收单机构)将交易查询报文信息直接通过请求方服务器发送至全渠道平台服务器的交易方式。查询类交易均为同步短连接方式,不需要持卡人参与完成的交易类型。若通讯超时,则交易请求方可以重复发起交易。交易处理流程如下:商户银联全渠道交易系统1.商户组织查询交易报文,发送给银联全渠道系统3.银联全渠道系统组织查询请求结果报文,同步返回给商户2.全渠道系统完成商户的交易查询请求处理交易步骤:Q/CUP071.2.5—201561、商户组织查询类交易报文,发送给银联全渠道系统