SP接口规格(v2.8.2)

1、 SP交易接口规格书SP交易接口规格书 版本2.7.7移动支付平台斯凯文软件技术（广东）有限公司版本控制版本作者说明完成日期0.92003-03-201.02003-04-201.0.12003-05-171.52003-10-152.02003-10-242.12003-11-192.2Joseph详细描述接口功能说明、通信方式说明补充信息范例更正附录的代码列表中的错误2003-12-152.5Kevin增加了返奖接口2005-12-192.6Kevin修改返奖接口2005-12-222.7Kevin增加了“4.15 MPS通知SP用户已确认交易”接口说明2006-06-202.7.1马宏伟

2、增加了”4.16 用户余额查询请求/回复“接口说明2008-03-042.7.3陆小博增加了一个重新开发的用户余额查询，增加了一个品牌判断查询2008-04-242.7.4陆小博增加归属地查询接口2008-04-302.7.5陆小博增加智能网扣费的错误代码说明2008-05-042.7.6陆小博增加扣费响应中，对需短信确认的说明2008-8-272.7.7陆小博删除“术语”中“手机钱包”，“虚拟货币”，“积分平台”，“银行接口”相关内容删除 4.7返款请求/回复删除 4.10手机钱包对账请求/回复删除 4.11明细账上传请求/回复删除 4.16用户余额查询请求/回复修改 4.17用户余额查询接

3、口，在URL后增加端口7001修改 4.18用户号码网络类型判断，在URL后增加端口7001修改 4.19用户归属地查询，在URL后增加端口7001附录一 增加交易代码“06”通宝支付请求附录四 修改错误代码600301细化错误描述附录四 修改错误代码600307细化错误描述附录四 修改错误代码600308细化错误描述附录四 修改错误代码800014细化错误描述增加 4.2 节“通宝支付接口”说明2008-12-292.7.8李振雄增加4.2合单交易请求/回复附录四 增加 以 98和988开头的错误代码2009-04-072.7.8b陆小博增加4.1.4直接支付的通宝认证参数 4.4.4 撤销

4、交易的通宝认证参数2009-04-232.8.0陆小博删除掉4.6退款 4.7返款 4.8返奖删除 2.2 SP请求批量交易删除 3.6 返奖增加第五节 接入说明增加对SP订单号生成规则的说明2009-07-01281李振雄增加610102、610103、610104、610105、610107这几个错误代码2009-12-072.8.2陆小博扩展4.13 查询网络类型接口2010-03-15目录版本控制2目录41. 前言71.1 范围71.2 缩写和专用名词71.3 参考资料92. 接口通信协议92.1 SP请求实时交易的通信方式92.2 SP接收MPS通知消息的通信方式133. 接口功能1

5、43.1 直接支付14基本流：14备选流：153.2 预授权支付17基本流：17备选流：183.3 取消预授权20基本流：20备选流：213.4 请款22基本流：22备选流：233.5 撤销25基本流：25备选流：263.6 交易自动取消通知28基本流：28备选流：283.7 短信确认通知30基本流：30备选流：303.8 对账32基本流：33备选流：333.9 查询订单34基本流：34备选流：353.10 查询订单交易明细36基本流：36备选流：363.11 查询SP账户37基本流：37备选流：374. 信息规格394.1 直接支付请求/回复 (PayReq/PayRes)394.2 合单支

6、付请求/回复 (PayReq/PayRes)424.3 撤销支付请求/回复 (CancelPayReq/CancelPayRes)454.4 预授权请求请求/回复 (AuthReq/AuthRes)484.5 取消预授权请求/回复 (AuthReReq/AuthReRes)514.6 预授权请款请求/回复 (AuthPayReq/AuthPayRes)554.7 对帐请求/回复 (BatchReq/BatchRes)594.8 订单查询请求/回复 (OrderQryReq/OrderQryRes)614.9 订单交易明细查询请求/回复 (TrxQryReq/TrxQryRes)644.10 账

7、户查询请求/回复 (AccQryReq/AccQryRes)674.11 MPS通知SP用户已确认交易694.12 用户余额查询接口714.13 用户号码网络类型判断734.14 用户归属地查询745. SP接入说明765.1 申请开通业务765.2 SP接入调测766. 附录796.1 附录一：交易类型代码列表796.2 附录二：订单状态代码列表796.3 附录三：交易状态代码列表796.4 附录四：错误信息代码表806.5 附录五 归属地代码清单841. 前言移动支付平台为GMCC提出，面向广大移动用户的便捷支付方式。SP或商户在正式开始使用此一支付方式进行收款前，必需先完成必要的申请程序

8、，并完成与移动支付平台的联线模块开发及测试后，才能正式上线。本规格书定义了SP或商户在开发连线模块的信息接口技术规格，以作为SP/商户开发的依据。本规格书如遇变动，当遵照项目变更管理办法提交变更申请、评估实施变更。1.1 范围本规格书描述了以下MPS、SP接口：n 直接支付n 预授权支付n 取消预授权n 请款n 撤销n 交易自动取消通知n 短信确认通知n 对账n 查询订单n 查询订单交易明细n 查询账户n 返奖本规格书将说明以上接口的用途、交互方式、报文数据格式。1.2 缩写和专用名词英文缩写英文全称说明MPSMobile Payment Server移动支付平台（本系统）。BOSSBusin

9、ess Operation Supporting System中国移动业务运营支撑系统SPService ProviderSP企业（参见业务术语）HTTPHypertext Transfer Protocol参见HTTP SPEC业务术语：用户移动手机用户，为全球通签约用户/ 或预付费用户手机号段移动全球通签约手机用户/ 或预付费手机用户的有效号段，在号段范围内的用户可使用移动支付平台的服务。用户状态包括：开机、停机、销号等，MPS根据用户状态决定是否允许用户使用话费支付服务（即黑名单功能）黑名单被禁止使用话费支付服务的用户的名单，称为黑名单，黑名单定时根据计费系统所传送的用户状态进行更新。用

10、户帐户指手机用户在MPS系统中的账户，账户中最主要的信息，除用户的手机号外，还包括各类支付账户和交易额度信息。移动电子帐户绑定到银行账户，由MPS进行额度管理，通过银行接口实现转账。或在营业厅存现金到此账户话费账户绑定到BOSS系统账户，由MPS、BOSS系统进行额度管理，通过BOSS接口实现收费结算。话费手机用户的手机通话费，在MPS中，话费也被用于进行小额支付话费支付以手机用户的通话费进行小额支付的方式，由SP在发生和用户的交易时提请，包含直接支付和预授权+请款两种方式，根据业务设定，可以请求手机用户通过短信确认，确认后即可认为支付成功，SP可实施与用户的交易。此后由MPS向移动计费系统请

11、款，移动公司再向用户收取实际费用，属于风险交易。话单移动公司用于记录手机用户的通话记录，用于进行收费，在MPS中，话单也用于记录手机用户的小额支付交易。话费充值用户采用现金、充值卡缴付话费的方式，在MPS中，也可用虚拟货币进行话费充值。虚拟货币虚拟货币是由手机积分根据一定比率兑换得到，虚拟货币可等同现金进行小额支付（受业务风险控管），也可兑换成话费进行充值。交易额度为了防止交易风险，在 MPS中设置了交易额度，根据不同的账户类型有不同的风险控制规则；对于话费支付，用户一段时间内累计的消费额度不能超过最高限额，交易额度可周期性地恢复。可用余额用户的账户余额中，除冻结的额度外，为可用余额。冻结额度

12、当执行需要短信确认的支付交易、或预授权交易后，交易金额并不会立刻从用户帐户扣除，而是被“冻结”，保留不可用作其它支付，被冻结的金额称为冻结额度。支付类型指话费支付、虚拟货币支付、移动电子帐户支付、手机钱包支付等，分别对应于不同类型的用户支付账户。交易在MPS中，交易代表一次事务处理，包括支付请求、预授权请求、请款都是不同类型的交易。交易流水号由MPS系统自动生成、不连续、循环使用的数字序列号，用于记录、跟踪交易的执行情况。短信确认为了防止交易风险，移动公司可要求自用户的账户转出交易金额前，用户通过短信加以确认。订单支付交易的对象实体，订单记录实际的购物信息，并用于跟踪交易的状态。SP企业与移动

13、公司达成协议，提供移动通信相关增值服务的企业；在MPS中特指提供小额支付服务，采用移动支付平台服务的企业。SP业务类型SP业务类型是指SP提供的服务种类，业务类型用于控制SP采用移动支付平台时的交易方式、支付方式，属于风险控管手段。撤销交易如果话费支付交易已经成功后，SP因任何原因需要撤销交易，可以向MPS提请，MPS视情况向计费系统申请退款，移动公司执行实际业务退返相应的金额给手机用户。外系统指除本系统以外，移动支付平台的接口系统，包括计费系统、积分平台、短信网关系统、银行接口系统等计费系统即BOSS系统，完成话费支付的收费结算等功能1.3 参考资料1GMCC移动支付平台 需求分析规格书（2

14、003年12月，2.0版）2GMCC移动支付平台二期需求分析规格书（2005年8月，4.0.版）2. 接口通信协议MPS系统共用到三种通信方式：1. SP请求实时交易通信方式2. SP请求批量交易通信方式3. SP接收交易通知通信方式2.1 SP请求实时交易的通信方式SP通过页面数据提交(HTTP)方式发送实时交易请求。实时交易请求包括：n 直接支付请求n 预授权支付请求n 对账n 手机钱包对账n 订单查询n 订单交易明细查询n SP账户查询n 撤销交易HTTP 方式指SP通过HTTP协议的POST/GET方式提交数据，请求MPS服务器返回相应页面的方式。SP提交的数据包含交易请求数据信息，而

15、MPS服务器返回的页面是XML格式的交易处理结果。2.1.1 实时交易的处理流程SP通过HTTP 提交一组数据到MPS服务器，MPS处理交易请求，并实时返回交易处理结果（成功或失败）。1. 提交实时交易请求2. 接收MPS回复SP/商户连线模块MPS交易步骤：1. SP通过HTTP 提交交易请求数据，发送到MPS交易处理系统。2. MPS处理交易请求，并回复处理结果。3. SP接收MPS回复结果，并解析结果作相应的交易处理。说明：l 采用HTTP 1.1协议以POST/GET方式传递/接收数据。l 交易请求/回复在同一个Socket连接（即一次HTTP REQUEST/RESPONSE）中完成

16、。l 对于无法立刻知道交易结果的请求，例如需要短信确认的支付交易，只要交易合法有效，即认为交易成功，在用户确认后MPS会通过HTTP 方式发送通知消息给SP,通知的URL由SP在业务开通申请表中的“回复地址”指定。l 如果交易请求在规定的时间内未收到MPS的回复(MPS建议为180秒)，则可能是网络通信故障或移动支付平台故障。此时，SP应通过4.10节的订单查询接口查询订单状态，然后根据查询结果进行处理。l 上述情况下，如果SP发送的是支付类的交易请求，包括直接支付、预授权或撤销，并且SP因为业务实时性的原因已经将交易置为失效，则SP应该按4.4节的接口向小额支付平台发起撤销交易（非全球通品牌

17、的用户暂不支持撤销交易）。2.1.2 如何使用HTTP 发送实时交易请求建议SP可通过ASP或JSP页面方式来提交实时交易请求。以下例子假设MPS的交易处理系统安装于35端口为7001，相应的URL地址是：35:7001/gmccwebapp/spservletSP可以通过提交页面请求到如上的URL来完成交易请求，相应的HTML form的代码如下：<form action=”35:7001/gmccwebapp/spservlet” method=post><!Form v

18、airables here -></form>其中Form Variables是一组MPS系统预定义的变量，根据请求交易种类的不同填写不同的内容，具体变量名称和数据类型参见本文档后续章节。MPS根据预定义的变量接收和识别交易请求，如果交易请求中未包含必要的变量，MPS将返回错误信息；如果交易请求中包含非MPS预定义的变量，该变量将被丢弃，MPS对余下的数据变量按正常方式处理。以下是一个实时交易请求的实际例子：<form action=”35:7001/gmccwebapp/spservlet” method=”post”>&l

19、t;input name="MPS_SPID" type="hidden" value="100001"><input name="MPS_SPPIN" type="hidden" value="1234"><input name="MPS_ServiceID" type="hidden" value="100001001"><input name="MPS_TrxTyp

20、e" type="hidden" value="00"><input name="MPS_PayType" type="hidden" value="0"><input name="MPS_Subscriber" type="hidden" value="quot;><input name="MPS_Amount" type="hidden&quo

21、t; value="123.56"><input name="MPS_OrderNum" type="hidden" value="123456789"><input name="MPS_SPTimestamp" type="hidden" value="20031220151530"><input name="MPS_OrderDesc" type="hidden" value=

22、"a sample trx request"></form>对应的HTTP报文内容为：HTTP Request InformationPOST 35:7001/gmccwebapp/spservlet HTTP/1.1HeaderAcceptimage/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/vnd.ms-excel, application/vnd.ms-powerpoint, application/msword, application/x-sho

23、ckwave-flash, */*Referer35:7001/newgmcctestweb/test.htmlAccept-Languagezh-cnContent-Typeapplication/x-www-form-urlencodedUser-AgentMozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; .NET CLR 1.1.4322)Content-Length220Pragmano-cacheHost(automatic)Cookie(automatic)Post DataMPS_SPID=

24、100001&MPS_SPPIN=1234&MPS_ServiceID=100001001&MPS_TrxType=00&MPS_PayType=0&MPS_Subscriberamp;MPS_Amount=123.56&MPS_OrderNum=123456789&MPS_SPTimestamp=20031220151530&MPS_OrderDesc=a+sample+trx+request2.1.3 接收和处理实时交易回复信息SP发送了实时交易请求后，必须等待MPS的回复结果，建议SP可以采用HTT

25、P协议的相关工具包来编程实现。例如：在JAVA中，可以通过HttpURLConnection.getContent()来实现。MPS完成交易处理后，给出HTTP RESPONSE响应信息，其正文内容为XML格式的报文。SP通过接收回复的数据，解析XML报文，判断交易的处理结果。视处理结果不同，回复的信息分为两类：成功和失败信息。当交易处理失败时，返回错误信息，错误信息仅包含订单号和错误代码（当SP身份鉴别失败、或非支付类交易请求时，仅回复错误代码，不包含订单号）。以下是一个实时交易失败回复的实际例子：<?xml version="1.0" encoding="

26、;UTF-8" ?> <Result><MPS_OrderNum>123456789</MPS_OrderNum><ResultCode> 860005</ResultCode> </Result>其中的错误代码的含义请参考本文档附录。对应的HTTP报文内容为：HTTP Response InformationHTTP/1.1 200 OKHeaderDateSat, 20 Dec 2003 15:15:31 GMTContent-Typetext/htmlServerWeblogic 7Content-L

27、ocation35:7001/gmccwebapp/spservletLast-ModifiedSat, 20 Dec 2003 15:15:31 GMTContent<?xml version="1.0" encoding="UTF-8" ?> <Result><MPS_OrderNum>123456789</MPS_OrderNum><ResultCode> 860005</ResultCode> </Result>当交易处理成功

28、时，返回成功信息，成功信息XML格式根据请求的交易不同而不同。一般情况下，包括SP请求的原始交易数据、交易成功代码（代码为0）、MPS分配给该交易的流水号等，具体的信息格式请参考本文档后续章节。以下是一个实时交易成功回复的实际例子：<?xml version="1.0" encoding="UTF-8" ?> <PayRes><MPS_TrxType>00</MPS_TrxType> <MPS_ServiceID>100001001</MPS_ServiceID> <MPS_P

29、ayType>0</MPS_PayType> <MPS_OrderNum>123456789</MPS_OrderNum> <MPS_Subscriber>lt;/MPS_Subscriber> <MPS_Amount>123.56</MPS_Amount><BankID>000000</BankID> <MsAccount>123456</MsAccount> <MPS_TrxID>2003122000000077</M

30、PS_TrxID> <MPS_ResultCode>0</MPS_ResultCode> <MPS_Timestamp>20031220151531</MPS_Timestamp> <MPS_OrderStatus>00</MPS_OrderStatus> </PayRes>对应的HTTP报文内容为：HTTP Response InformationHTTP/1.1 200 OKHeaderDateSat, 20 Dec 2003 15:15:31 GMTContent-Typetext/htmlServ

31、erWeblogic 7Content-Location35:7001/gmccwebapp/spservletLast-ModifiedSat, 20 Dec 2003 15:15:31 GMTContent<?xml version="1.0" encoding="UTF-8" ?> <PayRes><MPS_TrxType>00</MPS_TrxType> <MPS_ServiceID>100001001</MPS_ServiceID> &

32、lt;MPS_PayType>0</MPS_PayType> <MPS_OrderNum>123456789</MPS_OrderNum> <MPS_Subscriber>lt;/MPS_Subscriber> <MPS_Amount>123.56</MPS_Amount><BankID>000000</BankID> <MsAccount>123456</MsAccount> <MPS_TrxID>20031220000000

33、77</MPS_TrxID> <MPS_ResultCode>0</MPS_ResultCode> <MPS_Timestamp>20031220151531</MPS_Timestamp> <MPS_OrderStatus>00</MPS_OrderStatus> </PayRes>2.2 SP接收MPS通知消息的通信方式MPS在收到用户确认支付短信或自动取消交易时，会主动向SP发送通知消息。MPS以页面数据请求（HTTP ）方式发送此类通知消息，目标URL是在SP业务申请表中的“回复地址”指定的

34、；SP必须按接口规格编制连线接口模块，以HTTP服务器模式运行在约定的端口上，侦听来自MPS的通知消息，并作相应的处理。MPS发送的通知消息包括：n 用户短信确认支付请求通知n 交易超时自动取消通知2.2.1 通知交易的处理流程参见 MPS通知SP用户已确认交易2.2.2 如何接受MPS发送通知消息参见 MPS通知SP用户已确认交易3. 接口功能3.1 直接支付3.1.1 功能描述当SP与用户完成实物交易后，用户同意通过移动支付平台进行支付时，SP可以向MPS请求直接支付。与预授权支付不同，直接支付交易成功后，用户的账户上相应的金额被立刻扣除，转入到SP的收款账户上。根据与移动事前达成的协议，

35、SP可以请求用户采用话费支付。3.1.2 事件流基本流：A SP向移动支付平台以HTTP 方式提交支付请求数据B 移动支付平台验证SP信息合法性；l 检查SP标识及密码l 检查SP请求交易的IP地址l 检查交易请求数据的格式l 检查SP是否支持直接支付交易l 检查SP是否已注销或冻结l 检查订单号是否重复C 移动支付平台检查手机用户的合法性：l 检查用户手机号是否在号段。l 检查用户手机是否在黑名单中l 检查用户是否支持请求的支付方式D 移动支付平台检查SP业务的合法性：l 检查SP是否支持请求的业务l 检查该业务是否支持请求的支付方式l 检查该业务是否已注销或冻结E 移动支付平台检查用户帐户

36、的可用交易额度F 移动支付平台检查该业务是否需要用户短信确认G 如果不需要短信确认，从用户可用余额里扣除交易金额。H 通过外系统接口将金额转入SP的收款账户I 移动支付平台为本次交易分配交易流水号，并记录本次交易。J 移动支付平台记录交易的订单信息K 移动支付平台以HTTP RESPONSE形式返回交易结果L 用例结束备选流：n 第一备选流：A 如果SP请求的业务需要用户短信确认B 移动支付平台为该交易分配短信确认流水号C 移动支付平台冻结请求支付的额度（额度予以保留不允许再支用）D 移动支付平台发送短信（包含短信确认流水号）给用户请求确认。E 移动支付平台为本次交易分配交易流水号，并记录本次

37、交易。F 移动支付平台记录交易的订单信息G 移动支付平台以HTTP RESPONSE形式返回交易结果H 用例结束n 第二备选流：A 如果SP请求的交易数据不合法B 移动支付平台为本次交易分配交易流水号，并记录本次交易。C 移动支付平台以HTTP RESPONSE形式返回交易失败信息D 用例结束n 第三备选流：A 如果手机用户不合法B 移动支付平台为本次交易分配交易流水号，并记录本次交易。C 移动支付平台以HTTP RESPONSE形式返回交易失败信息D 用例结束n 第四备选流：A 如果SP请求话费支付方式，而手机用户的话费支付账户不存在B 移动支付平台为该用户默认开户C 继续用例n 第五备选流

38、：A 如果SP请求的业务不合法B 移动支付平台为本次交易分配交易流水号，并记录本次交易。C 移动支付平台以HTTP RESPONSE形式返回交易失败信息D 用例结束n 第六备选流：A 如果移动支付平台无法选择到合适的SP收款账户B 移动支付平台为本次交易分配交易流水号，并记录本次交易。C 移动支付平台以HTTP RESPONSE形式返回交易失败信息D 用例结束n 第七备选流：A 如果移动用户帐户的可用余额不足B 移动支付平台为本次交易分配交易流水号，并记录本次交易。C 移动支付平台以HTTP RESPONSE形式返回交易失败信息D 用例结束3.1.3 特殊要求l SP当于移动支付平台登记的IP

39、地址发起交易请求；l 如果SP请求的业务需要用户短信确认，只要SP请求的交易数据正确，用户帐户合法有效，MPS即认为交易成功，但不保证最终支付成功；l 上述情况下，SP可以通过接收MPS的通知消息，在用户确认后完成与用户的最终实物交易，或通过查询订单接口了解订单的支付状态；l 如果SP提交交易请求成功后，未收到MPS的回复信息，则SP须通过查询订单接口了解订单的当前支付状态。l SP应当记录MPS回复的交易流水号，以备后续查询、对帐3.1.4 前置条件SP已在移动支付平台开户，并已开通业务、设定各类支付方式的收款账号3.1.5 后置条件用户帐户的指定金额被扣除，转入SP的收款账户；或者，用户帐

40、户的指定金额被冻结，等待用户短信确认后转帐。3.1.6 扩展点l 预授权支付l 用户短信确认通知l 交易自动取消通知l 查询定单l 查询订单交易明细3.2 预授权支付3.2.1 功能描述当SP与用户达成购物协定后，用户同意通过移动支付平台进行支付时，SP可以向MPS请求预授权支付；待交易最终完成后，SP可向移动支付平台请款。与直接支付不同，预授权支付仅将用户账户上指定的金额冻结，被冻结的额度被保留不可再用作其它支付用途，待SP请款后，被冻结的金额被扣除，转入到SP的收款账户上。3.2.2 事件流基本流：A SP向移动支付平台以HTTP POST方式提交预授权支付请求数据B 移动支付平台验证SP

41、信息合法性；l 检查SP标识及密码l 检查SP请求交易的IP地址l 检查交易请求数据的格式l 检查SP是否支持预授权支付交易l 检查SP是否已注销或冻结l 检查订单号是否重复C 移动支付平台检查手机用户的合法性：l 检查用户手机号是否在号段。l 检查用户手机是否在黑名单中l 检查用户是否支持请求的支付方式D 移动支付平台检查SP业务的合法性：l 检查SP是否支持请求的业务l 检查该业务是否支持请求的支付方式l 检查该业务是否已注销或冻结E 移动支付平台检查用户帐户的可用交易额度F 从用户可用余额里冻结指定的交易金额。G 移动支付平台检查该业务是否需要用户短信确认H 如果需要短信确认，移动支付平

42、台分配短信流水号，并发送短信确认通知给用户。I 移动支付平台为本次交易分配交易流水号，并记录本次交易。J 移动支付平台记录交易的订单信息。K 移动支付平台以HTTP RESPONSE形式返回交易结果。L 用例结束。备选流：n 第一备选流：A 如果SP请求的业务不需要用户短信确认B 移动支付平台为本次交易分配交易流水号，并记录本次交易。C 移动支付平台记录交易的订单信息。D 移动支付平台以HTTP RESPONSE形式返回交易结果。E 用例结束。n 第二备选流：A 如果SP请求的交易数据不合法B 移动支付平台为本次交易分配交易流水号，并记录本次交易。C 移动支付平台以HTTP RESPONSE形

43、式返回交易失败信息D 用例结束n 第三备选流：A 如果手机用户不合法B 移动支付平台为本次交易分配交易流水号，并记录本次交易。C 移动支付平台以HTTP RESPONSE形式返回交易失败信息D 用例结束n 第四备选流：A 如果SP请求话费支付方式，而手机用户的话费支付账户不存在B 移动支付平台为该用户默认开户C 继续用例n 第五备选流：A 如果SP请求的业务不合法B 移动支付平台为本次交易分配交易流水号，并记录本次交易。C 移动支付平台以HTTP RESPONSE形式返回交易失败信息D 用例结束n 第六备选流：A 如果移动支付平台无法选择到合适的SP收款账户B 移动支付平台为本次交易分配交易流

44、水号，并记录本次交易。C 移动支付平台以HTTP RESPONSE形式返回交易失败信息D 用例结束n 第七备选流：A 如果移动用户帐户的可用余额不足B 移动支付平台为本次交易分配交易流水号，并记录本次交易。C 移动支付平台以HTTP RESPONSE形式返回交易失败信息D 用例结束3.2.3 特殊要求l SP当于移动支付平台登记的IP地址发起交易请求；l SP请求预授权成功后，如果与用户取消了购物协定，可以向MPS请求取消预授权，以返还用户被冻结的额度。l SP请求预授权成功后，如果与用户最终完成了购物交易，可以向MPS请求请款，将冻结的额度转入SP的账户。l 如果SP在规定的时间内（移动支付

45、平台建议为7天），未向MPS请款，该预授权交易将被自动取消，冻结额度被返还用户。l 如果SP请求的业务需要用户短信确认，只要SP请求的交易数据正确，用户帐户合法有效，MPS即认为交易成功，但不保证SP请款时支付成功；l 上述情况下，SP可以通过接收MPS的通知消息，在用户确认后向MPS请款，并完成与用户的最终实物交易，或通过查询订单接口了解订单的支付状态；l 如果SP提交交易请求成功后，未收到MPS的回复信息，SP须通过查询订单状态接口进行查询，根据查询结果设置订单状态l SP应当记录MPS回复的交易流水号，以备后续查询、对帐3.2.4 前置条件SP已在移动支付平台开户，并已开通业务、设定各类

46、支付方式的收款账号3.2.5 后置条件用户帐户的指定金额被冻结，等待SP请款或等待用户确认。3.2.6 扩展点l 取消预授权l 请款l 直接支付l 用户短信确认通知l 交易自动取消通知l 查询定单l 查询订单交易明细3.3 取消预授权3.3.1 功能描述当SP向MPS请求预授权后，如果与用户取消了购物协定，SP应当请求MPS取消预授权，以返还用户被冻结的额度。3.3.2 事件流基本流：A SP向移动支付平台以HTTP FILE UPLOAD方式提交取消预授权请求报文B 移动支付平台验证SP信息合法性；l 检查SP标识及密码l 检查SP请求交易的IP地址l 检查交易请求报文的格式l 检查SP是否

47、已注销C 移动支付平台备份SP的交易请求报文D 移动支付平台约定交易处理结果的文件名称，并将该文件查询路径通过HTTP RESPONSE形式回复SPE 移动支付平台定时处理取消预授权交易请求（大约每15分钟）F 移动支付平台解析报文，检查和处理报文中的每个交易请求G 移动支付平台生成交易处理结果文件H 移动支付平台检查原预授权交易是否合法：l 检查原交易是否存在。l 检查原交易是否由该SP发起l 检查原交易是否预授权交易l 检查原交易订单数据是否与SP提供的一致I 移动支付平台根据原交易流水号找到订单记录J 移动支付平台检查该订单的交易状态：l 检查订单是否已经取消l 检查订单是否已经请款l

48、检查订单是否已经撤销K 移动支付平台修改订单的状态，标记为已取消L 移动支付平台根据原订单找到用户付款帐号M 移动支付平台判断是否需要返还用户冻结的额度N 如果需要，将原订单冻结额度返还为可用额度O 移动支付平台为本次交易分配交易流水号，并记录本次交易。P 移动支付平台将处理结果记录在交易结果文件中。Q 移动支付平台重复以上步骤，完成每一笔交易的处理。R SP向移动支付平台提交HTTP请求，按约定的URL地址查询交易处理结果。S 移动支付平台以HTTP RESPONSE形式返回交易结果文件。T 用例结束。备选流：n 第一备选流：A 如果SP请求的交易报文不合法B 移动支付平台备份SP的交易请求

49、报文C 移动支付平台以HTTP RESPONSE形式返回交易失败信息D 用例结束n 第二备选流：A 如果取消预授权报文中指定的原交易不合法B 移动支付平台为该交易分配交易流水号，并记录该交易。C 移动支付平台将失败的交易处理结果记录在交易结果文件中。D 继续用例n 第三备选流：A 如果原订单不能取消（已取消、已请款或已撤销）B 移动支付平台为该交易分配交易流水号，并记录该交易。C 移动支付平台将失败的交易处理结果记录在交易结果文件中。D 继续用例n 第四备选流：A 如果原交易是话费支付方式，而请求取消时，用户的话费支付额度已定期恢复B 则不需要返还原订单冻结的额度C 继续用例3.3.3 特殊要

50、求l SP当于移动支付平台登记的IP地址发起交易请求；l SP取消预授权后，不可以再行请款或再次取消。l SP取消预授权，必须取消原预授权的全部金额，不能部分取消。l 如果SP在规定的时间内（移动支付平台建议为7天），未向MPS请款或取消，预授权交易将被自动取消，冻结额度被返还用户。l 无论是否需要用户短信确认或用户是否已经确认短信，SP都可以取消预授权。l 除了SP被注销的情况外，包括SP被冻结、业务被冻结或注销，SP都可以取消预授权。l SP预授权成功后，无论用户是否被列入黑名单或帐户被冻结，SP都可以取消预授权。l SP必须在请求预授权时，记录MPS回复的交易流水号，并在取消预授权时提供

51、该流水号。l SP请求取消时，提供的订单数据必须与原预授权交易一致。l SP收到MPS回复的查询结果地址后，必须等待一段时间（15分钟以上），才能发起HTTP查询请求l 如果SP提交交易请求成功后，未收到MPS的回复信息，则须通过查询订单状态接口得到订单状态，然后根据查询结果进行处理。l SP应当记录MPS处理结果中的交易流水号，以备后续查询、对帐3.3.4 前置条件SP已请求预授权支付3.3.5 后置条件原订单冻结的额度被返还用户帐户。3.3.6 扩展点l 预授权支付l 请款l 交易自动取消通知l 查询定单l 查询订单交易明细3.4 请款3.4.1 功能描述当SP向MPS请求预授权后，如果与

52、用户最终完成了购物协定，SP可以向MPS请款，以将用户被冻结的额度转入SP的收款账户。3.4.2 事件流基本流：A SP向移动支付平台以HTTP FILE UPLOAD方式提交请款请求报文B 移动支付平台验证SP信息合法性；l 检查SP标识及密码l 检查SP请求交易的IP地址l 检查交易请求报文的格式l 检查SP是否已注销C 移动支付平台备份SP的交易请求报文D 移动支付平台约定交易处理结果的文件名称，并将该文件查询路径通过HTTP RESPONSE形式回复SPE 移动支付平台定时处理请款交易请求（大约每15分钟）F 移动支付平台解析报文，检查和处理报文中的每个交易请求G 移动支付平台生成交易

53、处理结果文件H 移动支付平台检查原预授权交易是否合法：l 检查原交易是否存在。l 检查原交易是否由该SP发起l 检查原交易是否预授权交易l 检查原交易订单数据是否与SP提供的一致I 移动支付平台根据原交易流水号找到订单记录J 移动支付平台检查原订单的业务状态l 检查业务是否已注销K 移动支付平台检查原订单的用户状态l 检查用户是否已被列入黑名单L 移动支付平台检查该订单的交易状态：l 检查订单是否已经取消l 检查订单是否已经请款l 检查订单是否已经撤销l 检查订单是否需要短信确认/用户是否已经确认M 移动支付平台修改订单的状态，标记为已请款N 移动支付平台根据原订单找到用户付款帐号O 移动支付

54、平台解除原订单冻结的额度P 移动支付平台根据原订单找到SP收款帐号Q 通过外系统接口将金额转入SP的收款账户R 移动支付平台为该交易分配交易流水号，并记录该笔交易。S 移动支付平台将处理结果记录在交易结果文件中。T 移动支付平台重复以上步骤，完成每一笔交易的处理。U SP向移动支付平台提交HTTP请求，按约定的URL地址查询交易处理结果。V 移动支付平台以HTTP RESPONSE形式返回交易结果文件。W 用例结束。备选流：n 第一备选流：A 如果SP请求的交易报文不合法B 移动支付平台备份SP的交易请求报文C 移动支付平台以HTTP RESPONSE形式返回交易失败信息D 用例结束n 第二备

55、选流：A 如果请款报文中指定的原交易不合法B 移动支付平台为该交易分配交易流水号，并记录该交易。C 移动支付平台将失败的交易处理结果记录在交易结果文件中。D 继续用例n 第三备选流：A 如果原订单的SP业务已被注销B 移动支付平台为该交易分配交易流水号，并记录该交易。C 移动支付平台将失败的交易处理结果记录在交易结果文件中。D 继续用例n 第四备选流：A 如果原订单的用户已被列入黑名单B 移动支付平台为该交易分配交易流水号，并记录该交易。C 移动支付平台将失败的交易处理结果记录在交易结果文件中。D 继续用例n 第五备选流：A 如果原订单不能请款（已取消、已请款、已撤销或用户未确认）B 移动支付平台为该交易分配交易流水号，并记录该交易。C 移动支付平台将失败的交易处理结果记录在交易结果文件中。D 继续用例3.4.3 特殊要求l SP当于移动支付平台登记的IP地址发起交易请求；l SP请款后，不可以再次请款或请求取消。l SP请款，必须请求原预授权的全部金额，不能部分请款。l 如果SP在规定的时间内（移动支付平台建议为7天），未向MPS请款或取消，预授权交易将被自动取消，冻结额度被返还用户。l 如果需要用户短信确认而用户尚未确认，SP不可以请款。l SP可通过接收MPS发送的用户短信确认通知消息，或通过查询订单接口了解订单的状态