中国电信融合支付平台技术要求全国平台接口分册（试行）.doc

中国电信融合支付平台技术要求全国平台接口分册（试行）中国电信集团公司2010年6月前言本规范根据中国电信翼支付产品（基础版）业务规范制定，描述中国电信融合支付全国平台的接口。本规范适用于中国电信融合支付全国平台的接口功能开发。本规范解释权属于中国电信股份有限公司。本规范起草单位：中国电信股份有限公司移动支付项目组。本规范主要起草人：陈洪目录1.概述12.引用标准13.名词解释14.系统架构25.与业务平台或商户系统的接口（IF1）35.1重定向支付接口35.1.1接口描述35.1.2请求参数35.1.3应答参数46.与银行/第三方支付平台的接口（IF2）57.与OTA平台的接口（IF3）58.与UDB平台的接口（IF4）59.与CRM枢纽的接口（IF5）59.1数据类型59.1.1基本数据类型59.1.2结构类型69.1.3符号定义69.1.4请求消息结构69.1.5响应消息结构79.2接口说明89.2.1开户发卡接口89.2.2开户接口99.2.3销户请求接口119.2.4营业厅挂失接口119.2.5营业厅解挂接口129.2.6状态同步接口139.2.7营业厅换卡接口149.2.8营业厅补卡接口159.3参数定义169.3.1CardType(卡类型)169.3.2IsApplyCert(是否申请个人证书)179.3.3CustomLevel(客户等级)179.3.4CustomType(客户类型)179.3.5LoginPassword (登录密码)179.3.6Sex(性别)179.3.7CertType(证件类别)179.3.8Apanage (属地码)189.3.9AreaCode (地区码)189.3.10CityCode (城市码)199.3.11ZipCode (邮政编码)199.3.12AcceptOrgCode(受理机构码)199.3.13AcceptChannel (受理渠道)209.3.14FeeFlag (服务收费标志)209.3.15AccountType (账户类型)209.3.16TransOrg (转接机构码)209.3.17PayOrg (支付机构码)209.3.18SupplyOrg (出单机构码)209.3.19MerchantCode (商户号)209.3.20AccountStatus (账户状态)219.3.21CommStatus (通信设备状态)219.3.22ResponseCode (响应码)219.3.23CardNo（翼支付卡卡号）219.3.24CustomerNo/AccountNo（客户/账户ID）229.3.25PWDType（密码类型）239.3.26ProductNo（电信产品号）239.3.27TerminalNo（终端号）239.3.28IsRealName（是否实名）239.3.29RegisterType（产品号类型）239.4附录A239.4.1错误代码含义239.4.2服务代码名称映射2610.与NSAG的接口（IF6）2611.与业务监控系统的接口（IF7）2712.与卡应用管理平台的接口（IF8）2713.与省平台的接口（IF9）271. 概述本文主要针对全国平台与周边系统的接口类型、接口字段及其格式取值进行了规范说明。2. 引用标准下列文件通过本文的参考而成为本技术要求的条款。凡是注日期的参考文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本文，凡是不注日期的参考文件，其最新版本适用于本文。【1】中国电信翼支付产品（基础版）业务规范（试行）【2】中国电信融合支付平台技术要求总册【3】中国电信融合支付平台技术要求全国平台功能分册【4】中国电信融合支付平台技术要求省平台功能分册【5】中国电信融合支付平台技术要求技术流程分册3. 名词解释术语术语描述翼支付账户中国电信向用户提供的电信消费账户中的在线支付账户翼支付卡已经写入电信翼支付账户的RFID UIM卡翼支付卡号为用户翼支付卡分配的翼支付卡号，存放在翼支付卡内，用以标识翼支付应用。翼支付账号翼支付账号是用户用来登录及使用翼支付账户的号码，翼支付账号编码同电信通行证编码。POSP终端（接收端机具）接入平台，分为全国、省两级。4. 系统架构图4-1 全国平台与周边系统接口示意图全国平台与外部存在以下一些主要接口：Ø 与全国业务平台或商户系统的接口（IF1）：主要是指在业务平台或商户系统发起支付时的页面跳转接口；Ø 与银行/第三方支付机构的接口（IF2）：当银行/第三方支付账户作为翼支付账户的充值资金源，此接口完成银行/第三方支付账户的认证扣款；Ø 与OTA平台的接口（IF3）：主要包括空中圈存、账户状态控制等接口；Ø 与UDB平台的接口（IF4）：此接口主要实现网上登录密码的认证；Ø 与CRM省前置的接口（IF5）：虚拟省的CRM前置系统通过此接口连入全国平台，实现开户、销户、状态同步、挂失解挂、补换卡等功能；Ø 与NSAG的接口（IF6）：提供短信能力，实现支付密码发送、支付结果通知等功能；Ø 与业务监控系统的接口（IF7）：通过此接口监控全国平台的运行；Ø 与卡应用管理平台的接口：实现卡信息同步、卡应用控制等功能；Ø 与省平台的接口：包括省内系统发起的与翼支付相关的各种接口；5. 与业务平台或商户系统的接口（IF1）5.1 重定向支付接口5.1.1 接口描述接口名称重定向支付接口接口描述业务平台或商户系统的门户网站将支付请求发送给融合支付全国平台，通过重定向的方式，将页面跳转到融合支付全国平台的网上支付页面，用户在融合支付全国平台的网上支付页面完成支付后再跳转回业务平台或商户系统的门户网站处理页面。 接口提供者融合支付全国平台接口使用者业务平台或商户系统的门户网站接口类型HTTP Redirect应用场景互联网接入流程中的翼支付账户支付备注5.1.2 请求参数字段含义类型长度必填备注URL交易URLans500 M提交交易数据的URL地址MerID商户代码n 15 MOrdID交易订单号n16 MTransAmt交易金额n12 M单位：分CuryType币种n3 M默认为人民币，156TransDate交易时间n14 M订单提交时间TransType交易类型n4MMerURL页面返回地址ans500 M页面交易接收URlBgRetUrl后台返回地址ans500M后台交易接收URLSign数字签名ans256M为此次交易提交关键数据的数字签名示例：<form action="https:/payment.BestP METHOD=POST> （这里action的内容为提交交易数据的URL地址）<input type=hidden name="MerId" value="808080290000001"/> （MerId为全国平台统一分配给商户的商户号，15位长度，必填）<input type=hidden name="OrdId" value="0000000010096806"/> （商户提交给全国平台的交易订单号，16位长度，必填）<input type=hidden name="TransAmt" value="000000001234"/> （订单交易金额，单位为分，12位长度，左补0，必填）<input type=hidden name="CuryType" value="156"/> （订单交易币种，3位长度，固定为人民币156，必填）<input type=hidden name="TransDate" value="20100118121212"/>（订单交易日期，14位长度，必填）<input type=hidden name="TransType" value="8888"/> （交易类型，4位长度，必填）<input type=hidden name="MerUrl" value="www.*.com/pay/Pgreturn.jsp "/> （页面交易接收URL，长度不要超过500个字节，必填）<input type=hidden name="BgRetUrl" value="www.*.com/pay/Pgreturn.jsp "/> （后台交易接收URL，长度不要超过500个字节，必填）<input type=hidden name="Sign" value="XX"> （256字节长的ASCII码，为此次交易提交关键数据的数字签名，必填）</form> 5.1.3 应答参数字段字段含义类型长度必填备注SendToMer返回地址n32M回填MerURLMerID商户代码n 15 MOrdID交易订单号n16 MTransAmt交易金额n12 M单位：分CuryType币种n3 M默认为人民币，156TransDate交易时间n14 M订单提交时间TransType交易类型n4MOrderStatus返回代码n4MSign数字签名ans256M示例：<form name="SendToMer" method="post" action=""> （这里action的内容为提交交易数据的URL地址）<input type="hidden" name="MerId" value="808080290000001"/> <input type="hidden" name="OrdId" value="0000000010096806"/><input type="hidden" name="TransDate" value="20070801"/><input type="hidden" name="TransAmt " value="000000001234"/><input type="hidden" name="CuryType " value="156"/><input type="hidden" name="TransType " value="8888"/><input type="hidden" name="OrderStatus " value="0000"/><input type="hidden" name="Sign" value=" XX "/></form> 6. 与银行/第三方支付平台的接口（IF2）以银行/第三方支付平台接口为准。7. 与OTA平台的接口（IF3）全国平台与OTA平台的接口主要是为离线应用服务，暂不建设。8. 与UDB平台的接口（IF4）以UDB平台接口规范为准，详见中国电信用户数据库接口与流程规范。9. 与CRM枢纽的接口（IF5）与CRM的接口采用WebService接口。9.1 数据类型9.1.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秒）9.1.2 结构类型序号类型缩写类型描述参考1AccountItem账户信息类型2CustomerItem客户信息类型9.1.3 符号定义序号符号缩写符号性质符号说明1M强制域(Mandatory)此域必选，否则将被认为格式出错2C条件域(Conditional)此域在一定条件下必选3O选用域(Optional)此域由发送方自选9.1.4 请求消息结构9.1.4.1 结构说明<?xml version="1.0" encoding="UTF-8"?><PayPlatRequestParameter><CTRL-INFO WEBSVRNAME="服务名称" WEBSVRCODE="服务编码" APPFROM="请求本服务的应用标识码"KEEP="本次服务的标识流水" /><PARAMETERS>.</PARAMETERS></PayPlatRequestParameter>9.1.4.2 元素说明序号元素名称元素说明次数1PayPlatRequestParameter该元素为根元素12CTRL-INFO标明本次请求控制信息。属于消息头。13PARAMETERS标明本次请求业务参数信息。属于消息体。19.1.4.3 属性说明序号属性名称属性说明1WEBSVRNAME服务名称，参考附录9.4.22WEBSVRCODE服务编码，参考附录9.4.23APPFROM请求此服务的客户端标识编码。建议格式：省份-应用系统名称-版本号4KEEP随机生成的流水，用于维持请求响应对9.1.5 响应消息结构9.1.5.1 结构说明<?xml version="1.0" encoding="UTF-8"?><PayPlatResponseParameter><RESPONSE-INFO REQWEBSVRCODE="服务编码" RESPONSETYPE="响应类型"KEEP="响应流水" RESULT="响应状态" /><RESPONSECODE>000000</RESPONSECODE><RESPONSECONTENT></RESPONSECONTENT><RESULTDATESET><DATAS/><DATAS/></RESULTDATESET></PayPlatResponseParameter>9.1.5.2 元素说明序号元素名称元素说明次数1PayPlatResponseParameter该元素为根元素12RESPONSE-INFO标明本次响应的控制信息。属于消息头。13RESPONSECODE标明本次响应业务参数信息。属于消息体。14RESPONSECONTENT标明本次响应说明信息。属于消息体。15RESULTDATESET标明本次响应包含结果集。属于消息体。016DATAS封装具体结果集。属于消息体。0N9.1.5.3 属性说明序号属性名称属性说明1REQWEBSVRCODE取自对应请求WEBSVRCODE2RESPONSETYPE查询类响应为20，其余都为103KEEP取自对应请求KEEP4RESULT如果成功”SUCESS”，如果失败”FAIL”9.2 接口说明9.2.1 开户发卡接口9.2.1.1 接口描述接口名称开户发卡接口接口描述用户在营业厅开通支付账户和翼支付UIM卡，省CRM将相应信息发至到融合支付全国平台接口提供者融合支付全国平台接口使用者CRM省前置接口类型Web Service应用场景营业厅开户流程备注9.2.1.2 请求参数字段含义类型长度必填参考CardNo卡号n32M见9.3.23CardType卡类型n1M见9.3.1Name用户名ans20M真实姓名，如张三LoginId登录号ans20M翼支付登录别名，初期采用NameProductNo产品号ans30M见9.3.25IsApplyCert是否已认证n1M见9.3.2CustomLevel客户级别n1M见9.3.3CustomType客户类别n1M见9.3.4UserMobilePhone联系手机n15M如18900000000UserEMail联系邮箱ans100M如18900000000LoginPassword登录密码n16O见9.3.5Sex性别n1O见9.3.6CertType证件类型n1M见9.3.7CertNum证件号码n20MCelphoneNum联系电话n15O如02188888888OtherTelNum其他电话n15OApanage属地n15M所开户的属地。见9.3.8AreaCode地区代码n6M所开户的地区。见9.3.9CityCode城市编码n6M所开户的城市。见9.3.10ContractAdd联系地址ans200OCompanyAdd单位地址ans200OCompanyZip单位邮编n6O见9.3.11CompanyCode单位代码n30OAcceptOrgCode受理机构代码n15M见9.3.12AcceptUID受理人n20OAcceptAreaCode受理地区代码n6M受理的地区。见9.3.9AcceptCityCode受理城市代码n6M受理的城市。见9.3.10AcceptChannel受理渠道n2M见9.3.13AcceptSeqNo受理流水n20MFeeFlag服务收费标志n1M见9.3.14FeeAmt服务收费金额n12M以分为单位InputUID操作人员代码n20OInputTime操作时间n14MyyyyMMddHHmmss格式CheckUID授权员工标识n20OCheckTime授权时间n14OyyyyMMddHHmmss格式9.2.1.3 应答参数字段含义类型长度必填备注ResponseCode响应码n6M见9.3.22ResonseDesc响应码描述ans100C当响应码不为0000009.2.2 开户接口9.2.2.1 接口描述接口名称开户接口接口描述用户在营业厅开通支付账户，省CRM系统将相应信息经集团枢纽发至到融合支付全国平台接口提供者融合支付全国平台接口使用者CRM省前置接口类型Web Service应用场景营业厅开户流程备注9.2.2.2 请求参数字段含义类型长度必填参考Name用户名ans20M真实姓名，如张三LoginId登录号ans20O翼支付登录别名，初期采用NameProductNo产品号ans30M见9.3.25IsApplyCert是否已认证n1M见9.3.2CustomLevel客户级别n1M见9.3.3CustomType客户类别n1M见9.3.4UserMobilePhone联系手机n15M如18900000000UserEMail联系邮箱ans100M如18900000000LoginPassword登录密码n16O见9.3.5Sex性别n1O见9.3.6CertType证件类型n1M见9.3.7CertNum证件号码n20MCelphoneNum联系电话n15O如02188888888OtherTelNum其他电话n15OApanage属地n15M所开户的属地。见9.3.8AreaCode地区代码n6M所开户的地区。见9.3.9CityCode城市编码n6M所开户的城市。见9.3.10ContractAdd联系地址ans200OCompanyAdd单位地址ans200OCompanyZip单位邮编n6O见9.3.11CompanyCode单位代码n30OAcceptOrgCode受理机构代码n15M见9.3.12AcceptUID受理人n20OAcceptAreaCode受理地区代码n6M受理的地区。见9.3.9AcceptCityCode受理城市代码n6M受理的城市。见9.3.10AcceptChannel受理渠道n2M见9.3.13AcceptSeqNo受理流水n20MFeeFlag服务收费标志n1M见9.3.14FeeAmt服务收费金额n12M以分为单位InputUID操作人员代码n20OInputTime操作时间n14MyyyyMMddHHmmss格式CheckUID授权员工标识n20OCheckTime授权时间n14OyyyyMMddHHmmss格式9.2.2.3 应答参数字段含义类型长度必填备注ResponseCode响应码n6M见9.3.22ResonseDesc响应码描述ans100C当响应码不为0000009.2.3 销户请求接口9.2.3.1 接口描述接口名称销户请求接口接口描述用户在营业厅销户，省CRM将相应信息发至到融合支付全国平台接口提供者融合支付全国平台接口使用者CRM省前置接口类型Web Service应用场景营业厅销户流程备注9.2.3.2 请求参数字段含义类型长度必填备注ProductNo产品号ans30M见9.3.25Name用户名ans20MCertType证件类型n1M见9.3.7CertNum证件号码n20MAcceptOrgCode受理机构代码n15M见9.3.12AcceptUID受理人n20OAcceptAreaCode受理地区代码n6M受理的地区。见9.3.9AcceptCityCode受理城市代码n6M受理的城市。见9.3.10AcceptChannel受理渠道n2M见9.3.13AcceptSeqNo受理流水n20MFeeFlag服务收费标志n1M见9.3.14FeeAmt服务收费金额n12MInputUID操作人员代码n20OInputTime操作时间n14MyyyyMMddHHmmss格式CheckUID授权员工标识n20OCheckTime授权时间n14OyyyyMMddHHmmss格式9.2.3.3 应答参数字段含义类型长度必填备注ResponseCode响应码n6M见9.3.22ResonseDesc响应码描述ans100C当响应码不为0000009.2.4 营业厅挂失接口9.2.4.1 接口描述接口名称营业厅挂失接口接口描述用户在营业厅挂失，省CRM系统将相应信息发至到融合支付全国平台接口提供者融合支付全国平台接口使用者CRM省前置接口类型Web Service应用场景营业厅挂失流程备注9.2.4.2 请求参数字段含义类型长度必填备注ProductNo产品号ans30M见9.3.25Name用户名ans20MCertType证件类型n1M见9.3.7CertNum证件号码n20MAcceptOrgCode受理机构代码n15M见9.3.12AcceptUID受理人n20OAcceptAreaCode受理地区代码n6M受理的地区。见9.3.9AcceptCityCode受理城市代码n6M受理的城市。见9.3.10AcceptChannel受理渠道n2M见9.3.13AcceptSeqNo受理流水n20MFeeFlag服务收费标志n1M见9.3.14FeeAmt服务收费金额n12MInputUID操作人员代码n20OInputTime操作时间n14MyyyyMMddHHmmss格式CheckUID授权员工标识n20OCheckTime授权时间n14OyyyyMMddHHmmss格式9.2.4.3 应答参数字段含义类型长度必填备注ResponseCode响应码n6M见9.3.22ResonseDesc响应码描述ans100C当响应码不为0000009.2.5 营业厅解挂接口9.2.5.1 接口描述接口名称营业厅解挂接口接口描述用户在营业厅解除挂失，省CRM系统将相应信息发至到融合支付全国平台接口提供者融合支付全国平台接口使用者CRM省前置接口类型Web Service应用场景营业厅解挂流程备注9.2.5.2 请求参数字段含义类型长度必填备注ProductNo产品号ans30M见9.3.25Name用户名ans20MCertType证件类型n1M见9.3.7CertNum证件号码n20MAcceptOrgCode受理机构代码n15M见9.3.12AcceptUID受理人n20OAcceptAreaCode受理地区代码n6M受理的地区。见9.3.9AcceptCityCode受理城市代码n6M受理的城市。见9.3.10AcceptChannel受理渠道n2M见9.3.13AcceptSeqNo受理流水n20MFeeFlag服务收费标志n1M见9.3.14FeeAmt服务收费金额n12MInputUID操作人员代码n20OInputTime操作时间n14MyyyyMMddHHmmss格式CheckUID授权员工标识n20OCheckTime授权时间n14OyyyyMMddHHmmss格式9.2.5.3 应答参数字段含义类型长度必填备注ResponseCode响应码n6M见9.3.22ResonseDesc响应码描述ans100C当响应码不为0000009.2.6 状态同步接口9.2.6.1 接口描述接口名称状态同步接口接口描述用户在营业厅变更翼支付账户状态，省CRM系统将状态变更信息同步给融合支付全国平台接口提供者融合支付全国平台接口使用者CRM省前置接口类型Web Service应用场景营业厅账户状态变更流程备注9.2.6.2 请求参数字段含义类型长度必填备注ProductNo产品号ans30M见9.3.25CommStatus通信状态n20M见9.3.21AcceptOrgCode受理机构代码n15M见9.3.12AcceptUID受理人n20OAcceptAreaCode受理地区代码n6M受理的地区。见9.3.9AcceptCityCode受理城市代码n6M受理的城市。见9.3.10AcceptChannel受理渠道n2M见9.3.13AcceptSeqNo受理流水n20MFeeFlag服务收费标志n1O见9.3.14FeeAmt服务收费金额n12OInputUID操作人员代码n20OInputTime操作时间n14MyyyyMMddHHmmss格式CheckUID授权员工标识n20OCheckTime授权时间n14OyyyyMMddHHmmss格式9.2.6.3 应答参数字段含义类型长度必填备注ResponseCode响应码n6M见9.3.22ResonseDesc响应码描述ans100C当响应码不为0000009.2.7 营业厅换卡接口9.2.7.1 接口描述接口名称营业厅换卡接口接口描述用户在营业厅要求补换UIM卡，省CRM系统将请求通知融合支付全国平台。接口提供者融合支付全国平台接口使用者CRM省前置接口类型Web Service应用场景营业厅补换卡流程备注9.2.7.2 请求参数字段含义类型长度必填备注OldCardNo旧卡号n32M见9.3.23NewCardNo新卡号n32M见9.3.23CardType卡类型n1M见9.3.1Name用户名ans20MProductNo产品号ans30M见9.3.25CertType证件类型n1M见9.3.7CertNum证件号码n20MAcceptOrgCode受理机构代码n15M见9.3.12AcceptUID受理人n20OAcceptAreaCode受理地区代码n6M受理的地区。见9.3.9AcceptCityCode受理城市代码n6M受理的城市。见9.3.10AcceptChannel受理渠道n2M见9.3.13AcceptSeqNo受理流水n20MFeeFlag服务收费标志n1M见9.3.14FeeAmt服务收费金额n12MInputUID操作人员代码n20OInputTime操作时间n14MyyyyMMddHHmmss格式CheckUID授权员工标识n20OCheckTime授权时间n14OyyyyMMddHHmmss格式9.2.7.3 应答参数字段含义类型长度必填备注ResponseCode响应码n6M见9.3.22ResonseDesc响应码描述ans100C当响应码不为0000009.2.8 营业厅补卡接口9.2.8.1 接口描述接口名称营业厅补卡接口接口描述用户在营业厅要求补翼支付UIM卡（包括新开户和普通UIM卡更换成翼支付UIM卡），省CRM系统将请求通知融合支付全国平台。接口提供者融合支付全国平台接口使用者CRM省前置接口类型Web Service应用场景营业厅补换卡流程备注