中国电信统一支付平台测试模拟客户端接口协议0.6.doc

中国电信股份有限公司 统一支付平台测试模拟客户端接口协议中国电信统一支付平台测试模拟客户端接口协议（征求意见稿）版本号：0.5中国电信集团公司上海院2007-7前 言本测试模拟客户端（含服务器）接口协议描述中国电信集团统一支付平台测试所需的模拟客户端所需的测试环境、测试接口、承载协议的要求。本测试模拟客户端接口协议根据中国电信统一支付平台业务规范制定。本规范由中国电信集团公司上海院提出并撰写。本方案起草单位： 中国电信股份有限公司上海研究院本方案主要起草人： 本方案解释单位： 中国电信股份有限公司上海研究院目录目录iii1目的42测试内容53模拟客户端64模拟客户端接口协议74.1固网POS接入平台与支付平台接口协议74.1.1消息头定义84.1.2建链消息体定义（暂不测试）94.1.3链路查询消息体定义（暂不测试）94.1.4支付接口消息体定义94.1.5查询银行卡余额消息体定义114.1.6平台订单下发消息体定义134.2网厅模拟客户端144.2.1重定向跳转订单下发：144.2.2查询余额184.2.3绑定接口：194.2.4授权接口：224.3IVR模拟客户端254.3.1消息头定义264.3.2建链消息体定义（暂不测试）274.3.3链路查询消息体定义（暂不测试）284.3.4支付接口消息体定义284.3.5查询电信卡余额消息体定义304.4SP模拟客户端314.4.1Http重定向下发接口314.4.2SP订单下发接口334.4.3冲正接口：354.5银行模拟服务端374.5.1网银支付接口：374.5.2查询接口394.5.3支付接口414.6BOSS模拟服务端434.6.1客户资料同步接口：434.7现网帐务中心销帐接口474.8附录：默认代码48 53 1 目的上海院为统一支付平台测试提供了6种模拟客户端，为有助于测试厂商的原型搭建，现把这些模拟客户端所采用的协议发给厂商参考，并欢迎你们在原型系统搭建过程中到上海院进行调试、联调，请你们对这部分材料保密。2 测试内容1. 测试内容包括平台侧接口，但不包括终端、接入系统、外围系统等。1）固网POS与网厅部分相关功能纳入测试范围，后面加以标注。2）与银行、CRM的接口只测业务功能流程，不单测接口协议。3)漫游功能暂不测。4). 请依据附录的默认代码填写各接口字段。5）除SP下发采用短连接外，其它socket接口采用长连接通信方式；6）由于网厅上缴话费是今年重点业务，帐务中心的销帐接口采用现网平台来测试，请你们给予重视。2功能/接口测试参见功能测试规范中测试用例3性能测试参见性能测试规范中测试用例3 模拟客户端上海院提供的模拟客户端/服务器包括：1. 模拟终端/接入系统： IVR、固网POS、网厅；2. 模拟SP3模拟银行4模拟CRM注：此处的模拟客户端是软终端，不单指硬终端，包括终端与接入系统。请你们自己准备数据库，数据规则请参考模拟客户端协议中附录部分，并请提供数据输入界面，测试人员将在测试前输入数据到你们的数据库中。4 组网方式1 功能测试2 性能测试5 模拟客户端接口协议5.1 固网POS接入平台与支付平台接口协议支付能力平台与接入平台间通信在TCP 网络连接上基于协议数据单元（PDUs）的交换。双方互为客户端和服务端，分别建立两条链路通信。当在连接上没有信息交换的时候，双方应该每C 分钟相互发送EnquireLinkReq PDUs，以保持连接。如果在T 秒之后，仍然没有响应信息回复，发送方应该再一次发送EnquireLinkReq PDUs。如果在发送方发送N-1 条EnquireLinkReq PDUs 到另一方之后，仍然没有响应信息回复，发送方应该关闭连接。在提供的系统中应该可以设定C，T，N 的值。C 的典型值为60 秒，T 是60 秒，N 是3次。如果在T 秒之后等候响应信息是超时或者在N-1 次重试之后停止发送，发送方应该立即发送请求。T 的典型值为60 秒，N 为3 次。 5.1.1 消息头定义字段名称类型字段含义长度备注mlenString报文长度4总长度（包含本身），右对齐，不足添0connecttypeString接入方式2填 01，见附录1)接入方式定义msgcodeString消息类型40001-BindReq1001-BindResp0002-EnquireLinkReq1002-EnquireLinkResp0003-Pstn_Pay_Req1003-Pstn_Pay_Resp0004-Pstn_CardQuery_Req1004-Pstn_CardQuery_Resp0005-Pstn_PlatOrder_Req1005-Pstn_PlatOrder_ResptradetypeString业务类型(交易类型)4见代码表sndcodeString发端代码4见附录收发端代码表rcvcodeString收端代码4见附录收发端代码表msgseqString消息流水号22格式YYYYMMDDH24MISS+8，请求方生成，响应方回填消息流水号resversed1String保留字段114全部填空格resversed2String保留字段28全部填空格5.1.2 建链消息体定义（暂不测试）5.1.2.1 BindReq定义BindReqsrcdevidString发端设备ID10由系统分配，遵循设备编码规范AuthenticatorSource String认证字36该域用来对发端进行鉴权(16进制表示的字符串)。它生成的MD5加密算法如下：发端认证号码发端设备ID+共享密钥+时间戳共享的密钥部分由统一支付平台和接入平台分配，时间戳由发端设备生成，格式是：YYYYMMDDHH24MISS，年月日时分秒。TimeStampString时间戳14时间戳由发端设备生成，格式是月日时分秒（YYYYMMDDHH24MISS）VersionString版本号4版本号,两位主版本号两位子版本好，本版本号为：01015.1.2.2 BindResp定义BindResp rspcodeString响应码200：成功 01：失败5.1.3 链路查询消息体定义（暂不测试）链路查询消息的请求和响应均没有消息体，只有消息头。5.1.4 支付接口消息体定义5.1.4.1 Pstn_Pay_Req定义Pstn_Pay_Req TmnumString终端标识40终端号码,如果涉及终端该字段需要保存终端号，左对齐不足填空格PsamnumStringPSAM卡卡号16PSAM卡号，左对齐不足填空格merchantcodeString身份标识20身份标识，唯一标识SP02八位流水号OrdertypeString订单类型200：普通流水号01：条形码02：二维条形码03: 合同号TransidString平台交易流水20平台交易流水，由平台产生左对齐不足填空格orderidString订单号34SP订单号，由SP产生（模拟客户端随机产生）OrderdateString时间戳14由SP提供，长度14YYYYMMDDHHMMSS格式NeeddateString订单缴费截止时间14缴费截止时间，用户必须在截止时间之前缴费，否则账单将自动失效PaytypeString支付方式2默认未授权00授权01PayorgtypeString支付机构标识类型2标识是银行卡支付或电信账户支付01 电信 02 银行PayorgString支付机构标识6401 统一支付平台 02银行左对齐不足填空格PetypeString支付账户类型200 统一支付账户01 银行卡号PeidString支付账号32左对齐不足填空格pesecurityString交易密码32用支付平台帐户填来自模拟终端的密码；左对齐不足填空格paymentString支付金额（单位为分）20右对齐，不足填 0curcodeString币种2固定填01人民币paralenString终端有效数据长度4右对齐，不足填 0paracontentString终端有效数据（从接入获得的银行卡或终端的相关信息）5.1.4.2 Pstn_Pay_Resp定义Pstn_Pay_RespOrderidString订单流水号34SP订单号，由平台产生PlatidString统一支付平台标识10rspcodeString响应码2见错误代码表rspstringlenString响应字符串长度4(处理统一支付帐户相关业务时有效)rspstringString响应字符串(处理统一支付卡相关业务时有效)您的XXXX卡号统一支付卡缴费XX.XX元成功。paralenString终端有效数据长度4(处理银行卡相关业务时有效)paracontentString终端有效数据(处理银行卡相关业务时有效)5.1.5 查询银行卡余额消息体定义5.1.5.1 Pstn_CardQuery_Req定义Pstn_CardQuery_Req 字段名称类型字段含义长度备注TmnumString终端标识40终端号码,如果涉及终端该字段需要保存终端号，左对齐不足填空格PsamnumStringPSAM卡卡号16PSAM卡号，左对齐不足填空格payorgtypeString支付机构标识类型2标识是银行卡支付或电信账户支付01 电信 02 银行PayorgString支付机构标识6401 统一支付平台 02银行左对齐不足填空格PetypeString支付账户类型200 统一支付账户01 银行卡号PeidString支付账号32左对齐不足填空格pesecurityString交易密码32用支付平台帐户填来自模拟终端的密码；左对齐不足填空格curcodeString币种2固定填01人民币paralenString终端有效数据长度4右对齐，不足添 0paracontentString终端有效数据5.1.5.2 Pstn_CardQuery_Resp定义Pstn_CardQuery_Resp字段名称类型字段含义长度备注rspcodeString响应码2详见响应码定义表(消息类型为统一支付卡查询响应时有效)rspstringlenString响应字符串长度4(消息类型为统一支付卡查询响应时有效)rspstringString响应字符串(消息类型为统一支付卡查询响应时有效)banlanceString余额20银行账户余额paralenString终端有效数据长度4(消息类型为银行卡查询响应时有效)paracontentString终端有效数据5.1.6 平台订单下发消息体定义5.1.6.1 Pstn_PlatOrder_Req定义Pstn_PlatOrder_Req字段名称类型字段含义长度备注TmnumString终端标识40终端号码,如果涉及终端该字段需要保存终端号，左对齐不足填空格payorgtypeString支付机构标识类型2标识是银行卡支付或电信账户支付01 电信 02 银行PayorgString支付机构标识6401 统一支付平台 02银行左对齐不足填空格merchantcodeStringSP身份标识20SP代码，唯一标识SP左对齐不足填空格OrdertypeString订单类型200：普通流水号01：条形码02：二维条码03: 合同号transidString平台交易流水20平台交易流水，由平台产生左对齐不足填空格orderidStringSP订单号34SP订单号，由SP产生左对齐不足填空格OrderdateStringSP订单创建时间14由SP提供，长度14YYYYMMDDHHMMSS格式NeeddateString订单缴费截止时间14缴费截止时间，用户必须在截止时间之前缴费，否则账单将自动失效PaymentString支付金额20右对齐，不足填 0curcodeString币种2固定填01人民币needreceiptString是否要收据或发票10 不需要1 需要paralenString终端有效数据长度4右对齐，不足填 0paracontentString终端有效数据订单内容5.1.6.2 Pstn_PlatOrder_Resp定义Pstn_PlatOrder_Res 平台定单下发响应字段名称类型字段含义长度备注rspcodeString响应码2rspstringlenString响应字符串长度4rspstringString响应字符串paralenString终端有效数据长度4paracontentString终端有效数据5.2 网厅模拟客户端5.2.1 重定向跳转订单下发：5.2.1.1 接口描述接口名称重定向跳转订单下发接口接口描述通过调用支付接口向统一支付平台发出支付请求,统一支付平台通过支付Portal与用户进行交互，完成支付处理后，重定向回应用系统接口提供者统一支付平台接口使用者应用系统5.2.1.2 请求参数：参数名称参数说明流水号应用系统产生的订单流水号时间戳支付请求发起的时间身份标识向统一支付平台表明支付请求发起者的身份，如哪个省的应用系统（SP编码）业务类型标识本次支付的业务类型客户标识标识通过应用系统进行支付的客户ID（可为空）产品标识标识通过应用系统进行支付的支付对象，对应中国电信的产品标识，如固话号码，宽带标识等金额需要完成支付的金额返回地址统一支付平台接受支付请求并完成支付处理后，需要重定向回应用系统的URL地址终端号Web绑定终端号备注其他需要扩展的信息5.2.1.3 应答参数：参数名称参数说明流水号应用系统提交支付请求时携带的交易流水号时间戳支付应答返回的时间操作标识标识支付成功与否失败原因如果支付失败返回失败原因5.2.1.4 接口定义（HTTP跳转）订单下发请求字段名称类型说明CMDID请求类型String(10)请求类型，各业务平台的请求默认填PAYMERCHANTIDSP身份标识String (30)由统一支付平台统一分配，028位流水MERCHANTNAME身份标识中文名称String (64)可不填ORDERID流水号 帐单号String (34)由SP提供，不小于8位，以日期时间（YYYYMMDDHHMMSS格式）加一固定长度流水号组成，如：2007071115242500001ORDERDATE时间戳String (14)由SP提供，长度14YYYYMMDDHHMMSS格式PAYMENT支付金额String (10)单位：分CURTYPE币种String (10)默认填 01ENCODETYPE加密方式String (1)0：不加密 默认1：MD5摘要ATTACH附加信息String (128)SP附加信息BUSINESSTYPE业务类型String (10)默认0004TMNUM终端号码String (40)终端号码, 如果涉及终端该字段需要保存终端号（注：如果在Web上选择固网POS支付，需要在页面上填电话终端号码）CUSTOMERID应用系统客户标识String (32)默认PRODUCTID应用系统产品标识String (20)默认MACMAC校验域String (32)默认为0，不加密； 当为1时加密方式有意义，采用标准的MD5算法，由SP实现MERCHANTURL回调地址响应字段名称类型说明CMDID请求类型String (10)请求类型，各业务平台的请求分类说明，默认填PAYTRADESEQUENCE流水号String (30)由统一支付平台提供，SP必须保存该信息，SP需保存，作为对帐依据MERCHANTID身份标识String (30)从SP传送的信息中获得ORDERID订单号String (34)从SP传送的信息中获得，SP需保存，作为对帐数据PAYMENT金额String (10)从SP传送的信息中获得，单位为：分。SP需保存，作为对帐数据RETNCODE处理结果码String (2)由统一支付平台统一定义，SP需保存，作为对帐数据。结果码为“00” 表示支付成功，其他值则表示支付失败！RETNINFO处理结果中文说明String (32)由统一支付平台统一定义PAYDATE交易时间String (14)由统一支付平台提供CURTYPE币种String (10)默认填 RMB 01ENCODETYPE加密方式String (1)0：不加密 (默认)1：MD5摘要ATTACHSP附加信息String (32)SP附加信息SIGN数字签名String (256)数字签名算法由统一支付平台统一提供，SP需保存，作为核查依据（为1时有效），默认为05.2.2 查询余额5.2.2.1 查询请求消息查询统一支付帐户余额，public QueryChargeRes QueryChargeReq() : （webservice接口）参数参数含义数据类型必填说明Ordered查询流水号String必填可选queryAccount查询帐户String必填统一支付帐户Password查询密码String必填Note交易备注String必填Digest数字签名String可选5.2.2.2 查询响应消息public class QueryChargeResString queryAccount;String charge;String param;String note;String digest;String respCode;参数参数含义数据类型必填说明queryAccount查询帐户String必填统一支付帐户Charge余额String必填余额，单位(分)Param返回参数String可选Note交易备注String可选Digest数字签名String可选RespCode查询结果String必填见附录5.2.3 绑定接口：定义：两个账户之间建立关联，使绑定方可以非面柜方式直接被绑定方向进行账户转账实现统一支付帐户与订单应用系统用户设定其应用系统客户ID与支付账户或支付终端间的绑定进行绑定，用户在网厅上进行绑定，实际绑定操作由统一支付平台完成。同步到应用系统。可以用户主动、或应用系统发起、支付平台主动发起。5.2.3.1 接口描述接口名称绑定接口接口描述应用系统用户设定其应用系统客户ID与支付账户或支付终端间的绑定关系接口提供者统一支付平台接口使用者应用系统5.2.3.2 请求参数：参数名称参数说明订单流水号应用系统生成的订单流水号，用于标识一次绑定交易时间戳发起绑定请求的时间身份标识本次绑定发起方的身份标识（即应用系统在统一支付平台登记的使用支付业务的身份编号）应用系统客户ID用户在应用系统中的客户ID支付机构标识标识是银行卡支付或电信账户支付分支机构标识如是银行卡支付，标识从哪个银行进行支付如是电信账户支付，标识是从虚拟账户支付还是产品帐号代收费支付账户类型如是银行卡支付，标识账户类型，如存折、借记卡、信用卡等如是电信账户中的产品帐号代收费，标识产品帐号类型，如固话、小灵通、宽带帐号等支付账号用于扣款的账号如是银行卡支付，输入银行账户号如是电信虚拟账户支付，输入电信虚拟账户帐号如是电信产品帐号支付，输入电信产品帐号交易密码账户的相应密码交易提示信息本次绑定的描述信息（如：用户将为某个客户ID绑定），金融机构可将该描述信息提示给用户5.2.3.3 应答参数：参数名称参数说明订单流水号支付平台产生的订单流水号统一支付平台标识标识统一支付平台支付结果本次绑定是否成功支付账号绑定的支付账户用户信息支付账户对应的用户信息，如姓名等错误描述如果失败，返回错误编码或错误描述5.2.3.4 接口定义绑定请求：Public BindReqResponse RequestBindReq()字段名称类型必填说明orderId订单流水号String必填应用系统生成的订单流水号，用于标识一次绑定交易orderDate时间戳String必填发起绑定请求的时间merchantId身份标识String必填本次绑定发起方的身份标识（即应用系统在统一支付平台登记的使用支付业务的身份编号）customerId应用系统客户IDString必填用户在应用系统中的客户IDpayOrg支付机构标识String必填可选默认 payOrgType分支机构标识String必填可选默认 peType支付账户类型String必填可选默认 peId支付账号String必填用于扣款的账号银行帐号peSecurity交易密码String必填账户的相应密码Credit信用卡有效期String默认为20091231creditCvv2信用卡CVV2码String默认为0openName账户开户名String可选默认为支付Identity身份证号码String可选默认为00tipInfo交易提示信息String本次绑定的描述信息（如：用户将为某个客户ID绑定），金融机构可将该描述信息提示给用户响应：public class BindReqResponsepublic string orderId;public string platId;public string resultCode;public string peId;public string userInfo;public string errorCode respCode;public string platBindId;字段名称类型必填说明orderId订单流水号String必填应用系统产生的订单流水号platBindId平台流水号string必填统一支付平台产生platId统一支付平台标识String必填标识统一支付平台resultCode支付结果（绑定结果）String必填本次绑定是否成功peId支付账号String必填绑定的支付账户userInfo用户信息String支付账户对应的用户信息，如姓名等errorCode respCode错误描述String如果失败，返回错误编码或错误描述，见附录5.2.4 授权接口：授权：授权是资源的所有者或者控制者准许他人访问这种资源，这是实现访问控制的前提。授权是指客体授予主体一定的权力，通过这种权力，主体可以对客体执行某种行为，例如登陆，查看文件、修改数据、管理账户等。授权行为是指主体履行被客体授予权力的那些活动。因此，访问控制与授权密不可分。授权表示的是一种信任关系，需要建立一种模型对这种关系进行描述。5.2.4.1 接口描述接口名称授权接口接口描述用户在应用系统上设定其应用系统客户ID与支付帐号的绑定关系后，授权应用系统可自动发起用户授权的支付操作接口提供者统一支付平台接口使用者应用系统5.2.4.2 请求参数：参数名称参数说明订单流水号支付平台生成的订单流水号，用于标识一次授权交易时间戳发起授权请求的时间身份标识本次授权发起方的身份标识（即应用系统在统一支付平台登记的使用支付业务的身份编号）应用系统客户ID用户在应用系统中的客户ID支付机构标识标识是银行卡支付或电信账户支付分支机构标识如是银行卡支付，标识从哪个银行进行支付如是电信账户支付，标识是从虚拟账户支付还是产品帐号代收费支付账户类型如是银行卡支付，标识账户类型，如存折、借记卡、信用卡等如是电信账户中的产品帐号代收费，标识产品帐号类型，如固话、小灵通、宽带帐号等支付账号用于扣款的账号如是银行卡支付，输入银行账户号如是电信虚拟账户支付，输入电信虚拟账户帐号如是电信产品帐号支付，输入电信产品帐号交易密码账户的相应密码信用卡有效期对于信用卡，需要提交有效期信用卡CVV2码对于信用卡，需要提交CVV2验证码账户开户名授权账户拥有者的姓名身份证号授权账户拥有者的身份证号交易提示信息扩展信息5.2.4.3 应答参数：参数名称参数说明订单流水号支付平台产生的订单流水号统一支付平台标识标识统一支付平台支付结果本次授权是否成功错误描述如果失败，返回错误编码或错误描述5.2.4.4 接口定义：授权请求：Public AuthorizeReqResponse RequestAuthorizeReq()参数名称类型必填说明orderId订单流水号String必填应用生成的订单流水号，用于标识一次授权交易orderDate时间戳String必填发起授权请求的时间merchantId身份标识String必填本次授权发起方的身份标识（即应用系统在统一支付平台登记的使用支付业务的身份编号）customerId应用系统客户IDString必填用户在应用系统中的客户IDpayOrg支付机构标识String必填可选标识是银行卡支付或电信账户支付payOrgType分支机构标识String必填可选如是银行卡支付，标识从哪个银行进行支付如是电信账户支付，标识是从虚拟账户支付还是产品帐号代收费peType支付账户类型String必填可选如是银行卡支付，标识账户类型，如存折、借记卡、信用卡等如是电信账户中的产品帐号代收费，标识产品帐号类型，如固话、小灵通、宽带帐号等peId支付账号String必填用于扣款的账号如是银行卡支付，输入银行账户号如是电信虚拟账户支付，输入电信虚拟账户帐号如是电信产品帐号支付，输入电信产品帐号peSecurity交易密码String账户的相应密码credit信用卡有效期String默认为20091231creditCvv2信用卡CVV2码String默认为0openName账户开户名String可选默认为支付Identity身份证号码String可选默认为00tipInfo交易提示信息String扩展信息授权响应：public class AuthorizeReqResponsepublic string orderId;public string platId;public string resultCode;public string respCode;public string platBindId;字段名称类型必填说明orderId订单流水号String必填应用系统产生的订单流水号platBindId平台流水号string必填统一支付平台产生platId统一支付平台标识String必填标识统一支付平台resultCode支付结果String必填本次授权是否成功errorCode respCode错误描述String如果失败，返回错误编码或错误描述5.3 IVR模拟客户端支付能力平台与接入平台间通信在TCP 网络连接上基于协议数据单元（PDUs）的交换。双方互为客户端和服务端，分别建立两条链路通信。当在连接上没有信息交换的时候，双方应该每C 分钟相互发送EnquireLinkReq PDUs，以保持连接。如果在T 秒之后，仍然没有响应信息回复，发送方应该再一次发送EnquireLinkReq PDUs。如果在发送方发送N-1 条EnquireLinkReq PDUs 到另一方之后，仍然没有响应信息回复，发送方应该关闭连接。在提供的系统中应该可以设定C，T，N 的值。C 的典型值为60 秒，T 是60 秒，N 是3次。如果在T 秒之后等候响应信息是超时或者在N-1 次重试之后停止发送，发送方应该立即发送请求。T 的典型值为60 秒，N 为3 次。 5.3.1 消息头定义字段名称类型字段含义长度备注mlenString报文长度4总长度（包含本身），右对齐，不足添0connecttypeString接入方式2默认填 01msgcodeString消息类型4默认填00000001-BindReq1001-BindResp0002-EnquireLinkReq1002-EnquireLinkResp0003-Pstn_Pay_Req1003-Pstn_Pay_Resp0004-Pstn_CardQuery_Req1004-Pstn_CardQuery_Resp0005-Pstn_PlatOrder_Req1005-Pstn_PlatOrder_Resp0010-IVR_Pay_Req1010-IVR_Pay_Resp0011-IVR_CardQuery_Req1011-IVR_CardQuery_ResptradetypeString业务类型(交易类型)4支付 0002查询 0003sndcodeString发端代码4默认填0300rcvcodeString收端代码4默认填0100msgseqString消息流水号22格式YYYYMMDDH24MISS+8，请求方生成，响应方回填消息流水号resversed1String保留字段114全部填空格resversed2String保留字段28全部填空格5.3.2 建链消息体定义（暂不测试）5.3.2.1 BindReq定义BindReq 请求消息体srcdevidString发端设备ID10由系统分配，遵循设备编码规范AuthenticatorSource String认证字36该