中国联通电子渠道统一支付平台接入规范 支付机构 接入分册v1.5.

中国联通电子渠道统一支付平台接入规范支付机构接入分册中国联通电子渠道统一支付平台接入规范支付机构接入分册中国联通电子渠道中心2009年12月中国联通电子渠道统一支付平台接入规范支付机构接入分册变更记录31总体概述411方案适用范围412方案起草单位413方案的相关权利414名词解释42电子渠道统一支付平台接入总体方案521背景522统一支付平台523业务支付平台功能描述524支付机构功能描述63业务流程描述631支付流程632退款流程833对账流程94与支付机构之间的接口定义1041接入方式10411页面重定向方式10412点对点接口方式1042接口定义10421支付机构侧接口10422支付平台侧接口245附录2651加解密概述2652业务平台编码2753支付机构编码2754支付渠道编码2755统一支付平台流水规则2956统一支付平台返回编码29中国联通电子渠道统一支付平台接入规范支付机构接入分册变更记录序号变更内容说明版本号版本日期执笔人1讨论稿1020091110戴俊、张寅、梁晔2分离出支付机构接口分册1020091113梁晔3修改所有接口输入、输出字段1120091126梁晔4增加退款对账接口122009126钱宝超5修改加密顺序和实时订单查询接口字段132009128戴俊6修正了所有以ID结尾的参数的规范，统一定为ID将查询接口中MERCHANTID，与其他接口一致，修正为MERCHANTSID去除了实时订单查询接口中签名中的SIGN_HAMC字段扩展了商品名称、商品描述的长度142009128张寅7重新解释了PARTNERID的定义扩展了支付渠道编码中，对于企业帐户B2B的支持扩充了统一支付平台返回编码修正了退款接口异常返回情况修正了退款对账文件名修正了对账文件获取方式修正了对账文件的描述修正了支付机构编码新增了几家支付渠道、修正了支付渠道编码152010118张寅中国联通电子渠道统一支付平台接入规范支付机构接入分册1总体概述11方案适用范围为了实现对电子渠道现有具有支付功能的业务系统进行支付业务支撑，实现支付合作伙伴的统一接入，特制定本规范，本规范适用于接入电子渠道的各支付机构。12方案起草单位本方案的起草单位为中国联通总部电子渠道中心以及联创科技（南京）有限公司。13方案的相关权利本方案的解释权属于中国联通总部电子渠道中心。本方案增补、修订权属中国联通总部电子渠道中心。14名词解释名词与术语解释与说明业务平台通过统一支付平台使用支付功能的各业务系统。中国联通电子渠道统一支付平台接入规范支付机构接入分册名词与术语解释与说明支付机构具备接入支付渠道功能的支付提供商。对帐业务平台、支付平台、支付机构三方核对帐目的过程，分为支付平台与支付机构对账、支付平台与业务平台对账两部分。统一支付平台（UDP）接入支付机构，为业务平台提供支付服务的平台支付类型支付渠道的类别支付订单统一平台中所有支付交易的唯一标识支付渠道支付机构下属的各支付银行或支付账户2电子渠道统一支付平台接入总体方案21背景随着电子渠道系统建设的不断发展，系统积累越多，出于规划和长期发展的目的，需要对各系统的一些共性的东西提取出来单独处理，目前2G商城，3G商城，一卡充，固网交费，手机交费，都存在支付模块，为了拓展业务范围以及统一管理，建设统一支付平台。22统一支付平台统一支付平台主要是针对各业务系统中支付模块，提取出来，方便各业务系统的快速接入，以及各支付机构的快速接入，为各业务平台提供统一支付、统一退款、统一对账功能，为各支付机构提供统一管理、统一配置功能。23业务支付平台功能描述本规范业务平台指的是具有支付功能的电子渠道业务系统，诸如2G商城，3G商城，一卡充，固网交费，手机交费等。中国联通电子渠道统一支付平台接入规范支付机构接入分册24支付机构功能描述支付机构是指在业务平台需要支付功能的前提下，与统一支付平台与各支付节点之间建立的桥梁。它具有接入各支付银行与自己下属的各支付账户的能力。3业务流程描述31支付流程用户业务平台统一支付平台支付机构1选择商品2生成业务平台订单3发送支付请求4业务鉴权7生成支付平台订单6用户选择确认支付渠道5展示支付渠道选择页面8发送支付请求9处理支付请求10支付机构回调11发起支付回调验证12处理支付回调验证13支付回调验证成功14处理订单15支付平台回调16处理订单17展示交易结果页面支付流程详细描述1、用户在业务平台选择需要购买的商品，发起购买请求；2、业务平台生成业务平台订单；3、业务平台通过支付接口向支付平台发起支付请求；中国联通电子渠道统一支付平台接入规范支付机构接入分册4、支付平台通过对业务平台支付请求进行业务鉴权；1根据业务平台编码获取解密密钥对请求参数进行解密；2校验请求参数A判断业务平台功能是否具备支付请求的权限；B校验请求时间戳是否失效；3支付网关根据业务平台功能编码适配对应支付渠道5、展现对应支付渠道；6、用户选择支付渠道进行支付；7、支付平台生成支付平台订单；8、支付网关生成请求参数并向对应支付机构发起支付请求；9、支付机构处理支付平台支付请求；10、支付机构回调支付平台；11、支付网关接收到支付机构回调后，向支付机构发起订单验证请求备注支付网关判断支付机构是否支持防钓鱼功能，如果支付机构不支持该功能直接跳到第14步；12、支付机构处理支付平台回调验证请求；13、支付平台收到支付机构订单验证请求成功信息；14、支付平台处理支付平台订单；15、支付平台向业务平台发起订单回调请求；16、业务平台处理业务平台订单；17、展示交易结果页面。中国联通电子渠道统一支付平台接入规范支付机构接入分册32退款流程用户业务平台统一支付平台1用户选择退款2处理退款请求3向统一支付平台发起退款请求5处理业务平台退款请求6向支付机构发起退款请求4业务鉴权7支付机构处理退款请求9发起退款回调验证10处理退款回调验证11退款回调验证成功8支付机构回调支付平台13支付平台回调业务平台12处理订单14处理业务平台订单15展示退款结果退款流程详细描述1、用户在业务平台选择需要退款的订单，发起退款请求；2、业务平台处理退款请求；3、业务平台通过退款接口向支付平台发起退款请求；4、支付平台通过对业务平台退款请求进行业务鉴权；1根据业务平台编码获取解密密钥对请求参数进行解密；2校验请求参数A判断业务平台功能是否具备退款请求的权限；B校验请求时间戳是否失效；5、支付平台处理业务平台退款请求；6、支付网关生成请求参数并向对应支付机构发起退款请求；7、支付机构处理支付平台退款请求；8、支付机构回调支付平台；9、支付网关接收到支付机构回调后，向支付机构发起订单验证请求备注支付网关判断支付机构是否支持防钓鱼功能，如果支付机构不支持该功能直接跳到第12步；10、支付机构处理支付平台回调验证请求；11、支付平台收到支付机构退款订单验证请求成功信息；中国联通电子渠道统一支付平台接入规范支付机构接入分册12、支付平台处理支付平台订单；13、支付平台向业务平台发起订单回调请求；14、业务平台处理业务平台订单；15、展示退款结果页面。33对账流程业务平台统一支付平台支付机构1支付机构生成对账文件2上传至支付平台FTP服务器3支付平台内部对账4支付平台生成各业务平台对账文件5从支付平台FTP服务器获取对账文件6业务平台进行对账对账流程详细描述1、支付机构生成对账文件；2、支付机构在每日200以前将对账文件上传至支付平台FTP服务器指定目录下；3、支付平台进行内部对账；4、支付平台对账完成后根据对账结果按照业务平台生成单独业务平台对账文件；5、业务平台在每日300后从支付平台FTP获取对账文件；6、业务平台进行内部对账。中国联通电子渠道统一支付平台接入规范支付机构接入分册4与支付机构之间的接口定义41接入方式411页面重定向方式页面重定向方式是指通过用户的浏览器，从发起方系统页面跳转到落地方系统页面，整个过程是和用户进行交互的，需要用户输入相关验证信息以及拥有一些安全防盗机制。412点对点接口方式点对点接口方式是指通过用户的初始信息由发起方系统通过接口与落地方系统完成交互，整个过程对用户是透明的，用户在其中不进行交互。42接口定义注所有接口加密是按KEYVALUE，签名是按所列举的VALUE值，加密的顺序是按KEY的字母顺序排序，签名放在最后一个，而签名是严格按规范中的VALUE顺序签名。421支付机构侧接口4211支付接口接口采用HTTP协议。接口方法为HTTP/PAYPROVIDER/PAYPARTNERID100001SERVLETOUTPUTSTREAMPRINT“SUCCESS“SERVLETOUTPUTSTREAMFLUSH告知支付平台，已经成功处理，支付平台解析返回流，收到SUCCESS，则不需要再次回调。4222支付分账回调接口同4221支付回调接口注1、支付回调浏览器重定向回调优先级高于服务器点对点回调，支付机构回调支付平台时需要首先发起浏览器重定向回调，间隔2分钟后再发起点对点回调。支付平台第一次收到支付机构的点对点请求后，如果支付平台已经处理完毕该笔订单，则通过SERVLETOUTPUTSTREAMSERVLETOUTPUTSTREAMRESPONSEGETOUTPUTSTREAMSERVLETOUTPUTSTREAMPRINT“SUCCESS“SERVLETOUTPUTSTREAMFLUSH告知支付平台，已经成功处理，支付平台解析返回流，收到SUCCESS，则不需要再次回调。PAYPROVIDERORDER支付机构流水号STRING30是MERCHANTSID商户号STRING50是NOTIFYID订单验证IDSTRING50否用于验证订单合法性NOTIFYTYPE回调类型STRING2是1浏览器重定向2服务器点对点回调CURRENCY币种STRING10否默认是人民币RMBSERVICETYPE业务类型STRING10是支付默认为DIRECTPAYSIGN_HMAC数字摘要STRING50是中国联通电子渠道统一支付平台接入规范支付机构接入分册5附录51加解密概述统一支付平台要求报文在网络上传输时，通过密文形式。支持3DES、RSA两种加密方式，中国联通统一为支付机构不同的合作伙伴或者商户号分配密匙。支付机构根据自有平台特点，可以申请使用3DES对称加密，或者RSA不对称加密。52业务平台编码53支付机构编码名称英文名编码易宝YEEPAY01银联UNIONPAY02支付宝ALIPAY03类别平台名称平台英文名业务平台编码业务功能名称业务功能编码购买充值卡100001手机直充100002一卡充UPP10固网直充100003手机交费110001手机交费MOBILEPAYBILL11手机交费站110002交费充值类固网交费FIXPAYBILL12固网交费120001购买2G号码210001购买上网卡210002购买3G手机210003购买186号码210004购买上网本210005优惠购机210006IPHONE合约计划210007商城类联通商城UNICOMSALES21购买IPHONE210008中间帐户中间帐户EPAY31中间帐户充值310001中国联通电子渠道统一支付平台接入规范支付机构接入分册环迅INTERPAY04财付通TENPAY0554支付渠道编码在统一支付平台中，支付渠道是确定用户支付的标识，选择了不同的支付渠道，对于用户而言，就是选择了不同的支付方式。以下列表为默认使用个人银行帐户编码，如果支付机构支持企业帐户支付，即B2B的支付，则对应渠道编码在下表中的编码后面增加B2B后缀。如，使用中国工商银行个人帐户支付，则支付平台填写编码为ICBC，如果支付机构支持中国工商银行企业帐户支付，同时用户也选择使用企业帐户支付的情况下，支付平台填写给支付机构的编码为ICBCB2B。企业帐户的支付功能开通与否视各支付机构而定，由各支付机构提交本系统支持的企业帐户支付渠道。支付渠道名称支付渠道编码易宝自有帐户1YEEPAY01易宝自有帐户2YEEPAY02易宝自有帐户3YEEPAY03支付宝自有帐户1ALIPAY01支付宝自有帐户2ALIPAY02支付宝自有帐户3ALIPAY03财付通自有帐户1TENPAY01财付通自有帐户2TENPAY02财付通自有帐户3TENPAY03环迅自有帐户1INTERPAY01环迅自有帐户2INTERPAY02环迅自有帐户3INTERPAY03银联自有帐户1UNIONPAY01银联自有帐户2UNIONPAY02银联自有帐户3UNIONPAY03中国工商银行ICBC中国农业银行ABC北京银行BCCB交通银行BOCO建设银行CCB兴业银行CIB招商银行CMBCHINA中国民生银行CMBC光大银行CEB中国联通电子渠道统一支付平台接入规范支付机构接入分册中信实业银行ECITIC中国邮政储蓄POST深圳发展银行SDB上海浦东发展银行SPDB广东发展银行GDB上海农村商业银行SHRCB顺德农村信用社SDE广州农村信用社GNXS广州市商业银行GZCB南京银行NJCB华夏银行HXB渤海银行CBHB重庆银行CQB浙商银行CZB东亚银行HKBEA平安银行PAB南海农村信用社NHB中国银行BOC宁波银行NBCB厦门商业银行XMCCB中国信合CNRCU浙江稠州商业银行CZCB杭州银行HZB上海银行SHB北京农村商业银行BJNCB55统一支付平台流水规则统一支付平台中，所有接入的系统在保留原有业务平台流水的基础上，为了方便各业务平台系统之间的抽象、以及与统一支付平台系统的融合，需要在统一支付平台内增加属于统一支付平台的流水，生成规则如下123456789101112131415161718192021222324第1位至第3位为统一支付平台缩写，统一填写为UDP；第4位至第17位为精确到秒的时间戳，格式为YYYYMMDDHHMISS；第18位至第22位为可循环的自增长序列，从数据库获取；第23位至第24位为业务平台编码，共两位，参见业务平台编码。中国联通电子渠道统一支付平台接入规范支付机构接入分册56统一支付平台返回编码返回结果英文名称返回编码成功SUCCESS0000数字摘要错误HMAC_ERROR9001解密错误DECRYPT_ERROR9002未知错误UNKNOWN9999支付失败PAY_FAIL1000回调失败RETURN_FAIL2000验证失败VERIFY_FAI