中国银联全渠道系统商户接入测试指引BB产品

2023-11-19实施2023-11-04发布中国银联股份发布中国银联全渠道系统商户接入测试指引-B2B产品2023-11-19实施2023-11-04发布中国银联股份发布中国银联全渠道系统商户接入测试指引-B2B产品Q/CUP006.0—2023Q/CUP中国银联股份规范性文档版本修订信息弃版本号无完成日期鸣发布日期水变更说明切播2023-父7-03孤2023-估7-03逝初稿鉴民2023-念11-04捕2023-驴11-05劝修改文档格羽式，新增测雹试地址与测这试卡号等信绢息目录1 文档说明 他5.4梢章节折。率后台资金交傅易河如果已收到架后台通知，绕则不需要发姑起查询。台在订单发起夜后半小时未马收到后台通樱知，则需要校发起查询。尾具体的查询慎交易开发方铲法可态参见4.蛮5敢章节。挺后台测非资金团交易夺后台交易采鲁用同步机制碑，交易结果讯同步返回。查询交易胁如果起已接收到明拖确的交易结倚果应答缴，则不需要艺发起查询。嘱前台交易印，咏若增未接收到嫁全渠道系统治的明确交易负应答时需发上起单笔查询疏交易，查询磨明确的牛交易结果借。悲后台交易，悲若出现交易律超时邻的情况则需刚要发起单笔炎查询交易，胆查询明确的进交易结果疫。签名机制脾对于报文的厚签名处理机晒制如下：盲首先，对报迟文中出现签艘名域（膊signa伞ture拿）之外的所始有数据元采驾用微key=v挨alue道的形式按照埋名称排序，依然后以使&吉作为连接符何拼接成待签计名串。其次艳，对待签名竹串使用损SHA-1女算法做摘要桌，并转成敬16傅进制，再使轮用银联颁发湖给商户的商倍户翁RSA债私钥证书对妻摘要做签名回操作（签名轰时算法选择危SHA-1阶）。最后，饱对签名做矩Base6恼4丧编码，将编糖码后的签名惹串放在签名归（葡signa胶ture所）表单域里佛和其他表单确域一起通过埋染Post宏的方式传输蔽给银联蔬全渠道系统弃支付平台。趴对于报文的宋验签处理机闹制如下：驻首先，对报继文中出现签闲名域（债signa阴ture虹）之外的所魂有数据元采诞用窄key=v蹲alue奸的形式按照池名称排序，查然后以埋&奖作为连接符晓拼接成待签舒名串。其次王，对待签名秆串使用冷SHA-1闷算法做摘要宗，并转成臭16律进制，再使绪用商户入网止时银联提供晌的银联挪全渠道系统垮支付通讯盖RSA聚公钥证书对案摘要和报文译中的签名信恩息做签名验西证操作。加密机制湾对于持卡人执密码银联柴全渠道系统丰支付平台使业用磁RSA砌公钥证书对尼ANSI虫X9.8绑带主帐号格稻式的萝PIN恭加密并做质Base6裹4教编码后传输瓶，以保障密谎码的安全性丈。依据商户赚可选配置，谁对于搬CVN2赞、有效期、爸卡号使用在RSA座公钥证书分柏别做加密并查Base6稿4荒处理。轻对于敏感信灯息银行卡验绝证信息及身截份信息部分担内容，采用曾Base6激4熊编码后传输坊，以做数据当屏蔽。破对于文件内牛容，使用循DEFLA祝TE舟压缩算法压搅缩后，嫌Base6糠4饭编码的方式疮传输，压缩哨编码后的内顿容参与签名百摘要运算。歇证书相关说袋明概述马1图.筛商户签名证援书：商户接予入银联支付堂后会收到两差码，通过在乡CFCA网搏站下载pf惠x证书。此奶证书用于请绒求报文的签恢名。警测试证书随缘开发包提供努。把2胸.写商户的密码之加密证书：挽商户会收到艰一个密码加吨密的公钥证爷书，此证书膊用于对银行宇卡密码的加础密、cvn窃2、有效期僵及卡号等的装加密。块测试证书随京开发包提供答。颤3真.兽商户的交易顷报文验证签果名证书：验般证银联支付云返回的报文遭是否合法。背测试证书随美开发包提供训。匠证书下载及膜导出流程埋(ok)蜓证书下载流镇程铸登入CFC何A官网绵嘉c腾fca.c牧om部，点击“生上产系统证书前下载”；状在生产证书昆下载选项中感点击胁证书下载铅；市首次下载证煤书怀,请朗按照页面提游示安装相应右程序，以保房证证书顺利上下载；坑点击左侧“思用户证书下零载”，并点提击“接受此雅协议”；茄输入CFC低A提供的两砌码（乞用户参考号氏、脂用户授权码沃），冈制证方式于默认，债软件CSP致默稼认，点击下卸完成下载操丽作后，页面学会出现下载加成功的提示远。下载的证骑书自动存放阵在IE中。挨10.2.换2面证书导出流鞭程促1.盟打开浏览器走，点选工孤具滩Inte谊rnet选省项斥内容侮证书；耽2.尚以商户号：铃70000兴00000宰00001喂为例勒说明整个导泽出流程醉在个人证书嚼中找到相对苍应的证书，脚点选导出；职3.首跳出证书导鸦出向导对话侵框，点击下程一步；领选择导出私借钥（如需要耗在服务网站嫁上传证书公纠钥，请选择刃第二个选项肤以下载公钥敢证书，后续钢操作选择默径认方式，再浇选择路径导佩出），点击穗下一步；翅导出文件格赏式默认点击躬下一步；稻键入证书私食钥，建议不裳要超过6位绵；佛指定导出证墙书的文件名键，并选择目锄录存放证书锹，点击下一神步；舰点击完成，耽证书导出成丽功。才开发包唇插件据使用殖插件包雪只是为了方可便商户测试畜而提供的样定例代码，商腐户可以根据赚自己网站的式需要，按照雨技术文档编慨写,并非一型定要使用该址代码。代码尘仅供参考罢J于SP/JA箱VA烧插件捕以玉JAR包尘的形式提供顽给商户，工黎程名称为获upacp月_sdk_帜java红。壳配置文件说临明搏1.滚log4j冠.prop捐ertie躁s畜:插件的日男志机制使用瞒log4j州实现，可将狱提供的配置冒文件合并到给项目的lo抹g4j配置驾中，并根据饲环境需要修锄改日志路径疫；左2.捡币acp_s个dk疲.prop伶ertie凭s:狸测试环境皂参数配置文增件乎（不含讨控件支付）万具体配置：后#####默#SD土K配置文阔件配置文件际中日志和证结书的存放路搭径根据实际害情况配置，抱交易地址和峡证书根据婚测试乐环境、生产荷环境配套配炸置####冈#镰#SDK狡日志目录配目置墓log.b诸ack.r枕ootPa架th赖=辨剃og赛#####定#####崭#####潜#####均#####证#由交易发送地假址配眨#####身#####鼠#####妻#####贡#####黎####饼#####搁#(以下配眯置为骂认证埋环境：入网龙测试环境用耻，生产环境宾配置见文档贵说明)##肢#####阻##前台交前易请求地址略acpsd渔k.fro晋ntTra叹nsUrl鬼=援s衡://10邻1.231跌.204.丽80:50蔑00/ga安teway蚁/api/毕front扣Trans吉Req.d守o乖##

ap收p

交易请屠求地址晌##间

acps镇dk.ap呼pTran曾sUrl=挡s利://10欣1.231他.204.佛80:50衡00/ga买teway追/api/早appTr勾ansRe甩q.do先##后台交稼易请求地址伍acpsd拢k.bac已kTran耀sUrl鹿=翼s螺://10卡1.231微.204.侮80:50纠00/ga尘teway次/api/量backT董ransR粘eq.do熄##后台交倒易请求地址赞(若为有卡列交易配置该远地址)捆#诞acpsd卫k.car姨dTran椒sUrl=辨s帽://10宪1.231泽.204.曲80:50装00/ga突teway鹊/api/腊cardT舞ransR皇eq.do碧##单笔查蔑询请求地址歼acpsd折k.sin矿gleQu徐eryUr团l惧=戏s蚀://10降1.231但.204.剖80:50主00/ga冻teway溜/api/玩query寸Trans太.do薄##批量交摸易请求地址鞋acpsd芹k.bat良chTra格nsUrl煌=霸s赴://10橡1.231及.204.米80:50洗00/ga贵teway肾/api/快batch晓Trans拍.do眠##文件传射输类交易地笔址枪acpsd城k.fil昆eTran涨sUrl悲=扶s狸://10育1.231闲.204.贡80:得9080烘/集#####黄#####代#####他#####牧###溉#签名证书递配置###竟#####纲#####顾#####晃#####蚕#####葬####宁#####吩#(以下配纤置为疲测试顾环境：入网脸测试环境用娘，生产环境酿配置见栋下述笋文档说明)笋#####妹##腰##签名证规书路径榨acpsd爽k.sig擦nCert苹.path坊=汉d:\\c狡erts\润\7000逆00000剪00000余1_acp停.pfx艘##签名证拒书密码颠acpsd耍k.sig叛nCert逢.pwd架=杜00000惠0殊##签名证己书类型帖acpsd夹k.sig淋nCert铲.type堵=族PKCS1枝2灿#####纪#####铲#####齐#####绍#####艳#加密证书航配置###载#####膜#####粥#####镰#####缸#####肯####蛋##密码加狸密证书路径悬acpsd歌k.enc魂ryptC恭ert.p值ath烘=油d:\\c锋erts\绵\encr砖ypt.c亏er吹3.缺acp_s性dk.pr辆opert烧ies:萍生产环境肝参数配置文侧件陵具体配置：贼#####贡#####贝#####钓#####赚#####运#饿交易发送地潜址配史#####咏#####践#####赠#####雄#####沾####热#####箱#(以下配猫置为趁生产寇环境用妻)阶#####翼##抓##前台交章易请求地址表acpsd考k.fro虎ntTra舍nsUrl柱=握s孝://塑gatew志ay.95魄516.c贞om璃/gate麻way/a犁pi/fr猫ontTr端ansRe蔬q.do占##

ap诵p

交易请籍求地址贤##陕

acps嫂dk.ap随pTran火sUrl=普s崖://赠gatew回ay.95鸟516.c村om诞/gat涨eway/喘api/a原ppTra脖nsReq乐.do滔##后台交钉易请求地址壳acpsd考k.bac悦kTran历sUrl僻=怜s拳://闸gatew熟ay.95着516.c赤om胀/gate坦way/a筐pi/ba挂ckTra森nsReq层.do绢##后台交玩易请求地址尺(若为有卡貌交易配置该矿地址)删#慕acpsd悟k.car启dTran吵sUrl=犯s双://提gatew稳ay.95洞516.c辆om售/gat服eway/污api/c困ardTr葛ansRe币q.do垮##单笔查怪询请求地址耗acpsd家k.sin粗gleQu臭eryUr样l阵=弦s由://舱gatew席ay.95享516.c喂om淡/gate给way/a律pi/qu戚eryTr余ans.d堵o魔##批量交在易请求地址码acpsd泥k.bat饿chTra倚nsUrl蚀=节s鸡://砌gatew贩ay.95落516.c碑om虎/gate跟way/a冒pi/ba驻tchTr牛ans.d便o项##文件传控输类交易地删址毕acpsd肯k.fil嚼eTran娃sUrl途=独s酬://厕filed裤ownlo嫁ad打.9551拦6索/墙广#####抹#####杂#####友#####井###罩#签名证书违配置###爹#####声#####湿#####竞#####熊#####定####沸##签名证菠书路径跟（请拿到生朋产环境证书底后修改签名技路径、证书醉名称、证书恭密码）膀acpsd踩k.sig残nCert程.path先=味d:\\c骨erts\测\7000脑00000叛00000薄1_acp伞.pfx陪##签名证外书密码班acpsd绒k.sig界nCert拳.pwd刑=恐12345翼6酱##签名证识书类型乒acpsd怪k.sig柔nCert沙.type驼=普PKCS1唇2抢#####碰#####美#####衔#####丛#####逐#加密证书鸡配置###谊#####裁#####与#####拼#####哄#####特####咐##密码加野密证书路径盟acpsd屡k.enc而ryptC育ert.p断ath状=恋d:\\c箱erts\谨\encr税ypt.c由er苍主要类和方受法站说明端主要类与方归法说明类com.u邻nionp拖ay.ac溜p.sdk瓜.SDK哈Confi哪g.jav摇a浴:负责读取着acp_s喊dk.pr好opert务ies及设喝置参数。深方法：苏publi池cvoi旧dloa戚dProp中ertie谎sFrom孩Src()置从标准CL朝ASS类路致径下LOA金D配置文件倦。朽方法：脖publi帝cvoi攀dloa悲dProp例ertie破sFrom满Path(延Strin驴groo石tPath零)偿从标准CL鸭ASS类路跨径下LOA骗D配置文件耗。腾方法：晶publi团cvoi鸟dloa羞dProp宅ertie惊s(Pro贩perti资espr寸o)妈使用传入的储Prope虾rties为对象LOA睁D配置。揉主要类与方嘱法说明滨com.u同nionp果ay.ac松p.sdk饶.SDKU起til.j劲ava杏：怠主要负责组廊装报文、证煎书签名、发猜送报文、接才收报文、验腐证签名、加爷密解密等操沸作，具体请蹈查看代码。卫方法：背publi截cstat三icSt棕ring艰send(面Strin槐gurl殖,Map企<Stri送ng,S常tring将>dat商a,St调ring袭encod闪ing,i亡ntcon找necti姐onTim球eout,朽intr宝eadTi暴meout欣)泽发送后台交狸易。愿方法：踩publi懒cstat鸡icboo粉lean窃sign(呀Map<S挠tring换,Str嫁ing>软data,姻Stri忘ngen换codin紫g)溪生成签名。出方法：撑publi仍cstat质icboo台lean第valid遥ate(M哑ap<St盒ring,券Stri葵ng>r烂esDat仇a,St躁ring苍encod尤ing)公验证签名。咱方法：娇publi尖cstat般icSt冷ring低cover漏Map2S普tring坦(Map<吓Strin街g,St毒ring>建data已)凡将Map形锦式的表单交翅易数据转换马为key1步=valu锯e1&ke鸟y2=va酬lue2的眨形式叮方法：哈publi济cstat颜icMa作p<Str洽ing,柴Strin欢g>co玉verRe柿sultS讲tring柿2Map(甲Strin柔gres各ult)恶将形如ke欺y=val皇ue&ke谷y=val闪ue的字符全串转换为相缠应的Map矮对象疲方法：蓬publi末cstat佣icSt位ring泥encry百ptPin查(Stri白ngca啦rd,S延tring床pwd,吧Stri里ngen泊codin酷g)铁密码加密，尤输入参数依占次为卡号、防密码、字符品集。饼主要类与方补法说明脉com.u称nionp钢ay.ac摸p.sdk苹.SDKC霸onsta女nts.j爸ava：常熔量类。匀定义可能用华到的各种常镜量和所有域废名。进主要类与方趟法说明弦com.u世nionp健ay.ac首p.sdk氏.Cert储Util.街java：抛证书操作扬工具类，主渣要是导入p喉fx、ce挺r等证书与遥获取获取私仅钥、获取公棍钥操作。餐主要类与方深法说明灿com.u赖nionp溪ay.疮acp.s慰dk歼.凭Secur件eUtil伯.java雷主要负责报忍文的签名、解验证签名及息加密解密；怜提供MD5狂、SHA-菊1以及RS短A签名的方滨法类。轨主要类与方少法说明扁com.u碍nionp垃ay.ac忘p.sdk衣.阶Clien仰t.jav稀a是通信捷类，具体请秒参考代码的血说明。恢提供和服务土器通信的H浙TTP客户叼端类。到方法：湾publi步cint榜send(派Map<S具tring声,Str玩ing>港data,纤Stri弯ngen键codin差g)th丧rowsE效xcept休ion复将请求参数坛以再表单的方式短进行一次H铁TTPP鱼OST通信浮。幻Sampl野e说明涛com.u岭nionp忘ay.扯acp.s筝dksam嘴ple头.fron聚t：包下为他前台交易d辩emo案方法：锋com.u根nionp牧ay.家acp.s黎dksam息ple刚.back腰：包下为后豪台交易de文mo奖具体内容见拜DEMO代仇码中的注释伴和说明。钩配置文件加钟载说明梢配置文件加遥载说明早acp_s撑dk油.prop访ertie仍s忧i.居 滨从clas咸spath饿加载斑SDK诚Confi植g.get配Confi院g().l别oadPr至opert泡iesFr或omSrc象();缝ii.裙 竖从prop嫂ertie擦s对象中加歼载肌SDK吉Confi只g.get速Confi弦g().l丹oadPr符opert放ies(p煤ro);串iii.驾 君从指定目录叠下加载ro晨otPat影h不包含文丘件名场SDK处Confi啄g.get荒Confi唯g().l波oadPr祥opert亦iesFr犬omPat敲h(roo剥tPath她);州log4j双.prop盗ertie两s汁:放在工程熔的clas奋spath引目录下，系标统自动加载PHP步插件按编码无为gbk编朋写，工程名株称为upa炉cp_sd对k_php听，供系统集话成。竭opens延sl证书需初下载使用颤其中的ph姨p_ope授nssl.程dll,s项sleay漠32.dl庭l,lib鸡eay32雄.dll3厌个文件拷到细win傻dows/蝴syste亲m32/文怒件夹下，在厘重启Apa运che服务衔配置坏文件浙说明孤1.SD求KConf吓ig.ph扬p测试环境扰配置文件：欺具体配置项咸和说明如下酬；使具体配置：恢#####庄#SD棵K配置文燥件配置文件杯中日志和证式书的存放路盟径根据实际签情况配置，桌交易地址和仿证书根据懂测试没环境、生产秃环境配套配毕置####酬#刃#####淹#####加#####读#####蝴#####缸#交易发送第地址配##监#####小#####螺#####克#####猎#####筝##遥#####搜#(以下配悲置为链认证童环境：入网玉测试环境用垂，生产环境骆配置见文档展说明)##晃#####吵##前台交票易请求地址译const浙SDK_吸FRONT握_TRAN交S_URL龙='h剑ttps:逃//101沟.231.盲204.8会0:500卵0/gat耍eway/雄api/f辨rontT渣ransR顽eq.do加';摇##后台交躬易请求地址辞const牙SDK_解BACK_着TRANS浇_URL寒='ht爪tps:/淡/101.供231.2瞎04.80僚:5000遵/gate贺way/a欢pi/ba灿ckTra耽nsReq诞.do';换##后台交慨易请求地址如(若为有卡杀交易配置该勉地址)番const届SDK_C脏ard_R弃eques派t_Url善='h遍ttps:余//101显.231.至204.8涨0:500火0/gat矮eway/灾api/c户ardTr向ansRe驴q.do'俱;担##单笔查恒询请求地址牛const薄SDK_墨SINGL谢E_QUE卫RY_UR刷L='臣s贞://10皂1.231淋.204.沙80:50林00/ga餐teway袍/api/里query涉Trans喷.do';娱##批量交俘易请求地址毅const落SDK_疤BATCH宾_TRAN态S_URL叨='h针ttps:惜//101典.231.墙204.8黄0:500捆0/gat赶eway/贼api/b移atchT溜rans.斤do';田##文件传促输类交易地甘址套const纲SDK_逝FILE_藏QUERY猾_URL裙='ht码tps:/霸/101.饰231.2纵04.80虑:9080蝴/';科##吃APP蜻交易地址慎const覆SDK_A刊pp_Re俩quest绳_Url棍='ht忆tps:/凡/101.蹲231.2僚04.80弦:5000闷/gate乎way/a陶pi/ap凶pTran甲sReq.房do';项#####椅#####锻#####赖#####猪####签花名证书配置贿#####拆#####夏#####挤#####笛#####衬#####恰##谈#####活#(以下配跌置为沫测试夜环境：入网弊测试环境用聋，生产环境半配置见全下述阶文档说明)伪#####宴##命##签名证现书路径蛋const馋SDK_仓SIGN_组CERT_很PATH方='D:河/cert档s/PM_颗70000择00000叮00001绒_acp.缩pfx';挤##签名证垮书密码腥const到SDK_娇SIGN_早CERT_俭PWD=视'000岭000';轿##签名证核书类型闭acpsd倘k.sig存nCert胆.type可=岭PKCS1饲2迎##联验签式const越SDK_悔VERIF钻Y_CER切T_PAT妇H='才D:/ce洲rts/v烘erify课_sign窄_acp.寨cer';仆##聪前台通知咽地址(商察户自行配置冻通知地址)狂const员SDK_简FRONT酸_NOTI满FY_UR狠L='怠:端//127骨.0.0.融1/upa方cp_sd互k_php绩/demo叛/resp中onse.径php';笼//后台葡通知地址葛(商户自行集配置通知地陡址)吹const吊SDK_还BACK_斥NOTIF绑Y_URL辱='h居ttp:/矛/127.畏奥/upac材p_sdk剪_php/施demo/骡respo便nse.p锦hp';缝//文件下饺载目录掘const而SDK_据FILE_指DOWN_晕PATH份='d:梦/file铃/';亮//日志搁目录恒const修SDK_拉LOG_F爷ILE_P堂ATH=圾'D:/欲logs/隔';否//日志级晋别匠const傍SDK_凡LOG_L先EVEL艇='IN快FO';乌#####序#####姥#####央#####企#####静#加密证书见配置###井#####立#####益#####馋#####丧#####颗####股##密码加秀密证书路径缺const粒SDK_趋ENCRY服PT_CE鼠RT_PA即TH=狐'D:/c脆erts/改encry柿pt.ce火r';添2.SD朽KConf死ig.ph锅p，生产血测试环境配焰置文件：具除体配置项和流说明如下；谅具体配置：然#####宗#####场#####献#####暑#####堪#交易发送驳地址配##森#####岂#####觉#####厨#####倚#####系##垃#####钞#(以下配折置为搜生产另环境用洗)址#####基##丽##前台交骗易请求地址修const炒SDK_窃FRONT命_TRAN宋S_URL绩='h些ttps:秒//gat辟eway.巴95516槽/中gatew渡ay/ap妹i/fro命ntTra肆nsReq岸.do';矩##后台交粒易请求地址基const孟SDK_金BACK_陕TRANS奇_URL老='ht差tps:/耀/gate际way.9尚5516.兄com/g雀atewa帽y/api简/back茄Trans论Req.d烈o';谢##后台交馅易请求地址冒(若为有卡昆交易配置该博地址)耽const熟SDK_C区ard_R介eques私t_Url温='h淘ttps:偿//gat物eway.突95516则/蜡gatew魄ay/ap哑i/car蝇dTran抛sReq.帽do';惕##单笔查悉询请求地址皮const胁SDK_惭SINGL婶E_QUE返RY_UR师L='饿s摆://ga踢teway璃.9551林6巾/gate和way/a斧pi/书query烤Trans描.do';抬##批量交篇易请求地址导const风SDK_船BATCH胶_TRAN安S_URL衔='h剂ttps:板//gat企eway.狮95516依/铸gatew颂ay/ap绩i/bat戏chTra份ns.do握';院##文件传愤输类交易地粗址寸const蔽SDK_润FILE_胆QUERY平_URL思='ht恐tps:/康/file据downl尽oad.9亡5516.殊com/'殃;栗##槽APP吩交易地址冻const烘SDK_A娃pp_Re累quest突_Url狡='ht挺tps:/压/gate绒way.9捐5516.向com/g便atewa警y/api壶/appT经ransR催eq.do蚁';口##前台通吗知地址(衣商户自行配禁置通知地址泻)伸const妨SDK_驱FRONT捎_NOTI页FY_UR捧L='寨:偶//127响.0.0.描1/upa宾cp_sd帮k_php塑/demo芬/resp解onse.厉php';高##后台通项知地址(姓商户自行配劈置通知地址结)到const室SDK_筋BACK_盼NOTIF挎Y_URL插='h股ttp:/殊/127.症山/upac霉p_sdk贩_php/熄demo/打respo宏nse.p架hp';办##文件下句载目录成const泊SDK_曾FILE_追DOWN_治PATH占='d:解/file盾/';枣##日志旷目录晕const哀SDK_委LOG_F累ILE_P惯ATH=腾'D:/编logs/卫';稻##日志级份别除const场SDK_属LOG_L陵EVEL距='IN可FO';雁#####劣#####绑#####祝#####锹####签墙名证书配置厘#####璃#####替#####秒#####冬#####械#####碧##段##签名证淹书路径俯（请拿到生扇产环境证书蛇后修改签名芹路径、证书总名称、证书杨密码）嗽const蔬SDK_汽SIGN_杜CERT_抛PATH晶='D:辫/cert灰s/PRO忙_7000慢00000灵00000市1_acp猛.pfx'刃;气##签名证甜书密码仰const蛮SDK_燃SIGN_胀CERT_让PWD=恐'000寄000';版##签名证税书类型块acpsd千k.sig蠢nCert谢.type细=鼻PKCS1筐2认##斧验签塘const招SDK_招VERIF朴Y_CER裳T_PAT幸H='得D:/ce鲁rts/U寻POP_V嚷ERIFY躺.cer'腥;答##纺验签证书路愉径怀const捞SDK_许VERIF饺Y_CER昌T_PAT急H='失D:/ce影rts/'兴;仆#####惧#####屯#####痰#####谨#####山#加密证书坏配置###喊#####吐#####眯#####伸#####亚#####舞####寇##密码加垒密证书路径崖const磁SDK_仍ENCRY润PT_CE借RT_PA笑TH=餐'D:/c哀erts/峡RSA20渡48_PR戚OD_in以dex_2允2.cer贫';丝主要庆类与叛方法说明宫主要类与方五法说明橡upacp押_sdk_发php.g茂bk.co联mmon.健php:负研责将桶请求报文排妥序后转化为跃字符串、将夜字符串转为爽数组未解压、压缩这、构建自动慧提交表单等减funct秒ionc胡overP社arams朴ToStr杯ing($郊param同s)畜功能:将先请求报文排泡序后转化为铸字符串缸输入:请生求数组果输出:排英序后的k些ey1=v嗓al1&k诉ey2=v究al2&.谎...垂funct闷ionc封overS蜡tring忆ToArr忧ay($s茄tr)艳功能:将似字符串转为售数组株输入:k瓶ey1=v胞al1&k除ey2=v枝al2&.历...窃输出:数幕组元素a慎rray(宰key1=巡>val1生,key2猎=>val真2...)天funct释iond挽eal_p沃arams活(&$pa集rams)唱功能:处增理返回报文烈解码客户右信息礼输入:客策户信息扬输出:将伞客户信息组摊装成cus纪tomer冷Info项糖funct染iond纳eflat地e_fil谣e(&$p疲arams夕)略功能:压讯缩文件身输入:带屿有文件上传犁的请求报文艰输出:将参上传文件压菜缩后组装进场报文煌funct雅iond躁eal_f塞ile($宁param狱s)选功能:解尖压缩文件裕输入:带肢有文件下载奏的返回报文依输出:处阿理文件内容津并保存到指梦定目录下胞funct衫ionc己reate皂_html涝($par申ams,榨$acti睬on)轻功能:构妨造自动提交魔的表单飞输入:请释求数组($其param蜘s),请鸡求的远程u边rl饥输出:自提动提交的f桑orm表单乳字符串旨主要类与方醋法说明捎upacp汪_sdk_萍php.g蜡bk.ht勒tpCli虏ent.p便hp:后台加交易客户茅端通信等言C杰lient沫.php群funct致ions乎endHt怪tpReq似uest(仁$para介ms,$妻url)匪功能:后湾台交易H棵ttpCl势ient通萌信纷输入:请腔数据,及远统程通信ur它l系输出:后洽台交易响应蓄信息校funct象iong案etReq超uestP恒aramS淡tring淹($par磁ams)激功能:请兼求数据u额rlenc唱ode处理粮后转为ke乡y=val妖&...串衡输入:请葛求数组响输出:u分rlenc律ode处理娘后的key住=val&抢...串其主要类与方久法说明郊upacp鬼_sdk_译php.g恩bk.se昌cureU书til.p雹hp:负责崖签名，验签器，加载证书零，取公钥/忠私钥，加密桐卡号/cv棍n2/有效宵期等方法类久secur贩eUtil惨.php感funct平ions姐ign(&谊$para晓ms)圾功能:请需求数据签名疏输入:请棕求数组蓬输出:带监签名的请求他数组远funct章ionv伶erify睬($par煮ams)蜂功能:验让签芽输入:返早回报文父输出:成玻功/失败循funct畏iong蚂etPul爬bicKe完yByCe嫁rtId(割$cert米Id)挖功能:根秋据证书ID驳加载证狡书真输入:证筐书ID最输出:证告书公钥信息加funct键iong天etCer捐tId($树cert_榆path)咳功能:取完私钥证书I个D络输入:私枣钥证书路径快输出:证穷书ID蝴funct求iong县etCer舱tIdBy仿CerPa棵th($c坟ert_p睬ath)妖功能:取渐公钥证书I胳D免输入:公季钥证书路径屋输出:证叨书ID瞒funct丢iong某etSig孤nCert亩Id()授功能:取尸签名证书I纹D怪输入:签消名证书路径可输出:证仰书ID剃funct闯iong遭etPub午licKe锄y($ce债rt_pa普th)仗功能:获疾取证书公钥判输入:证唱书路径述输出:公池钥造funct酒iong谷etPri笼vateK李ey($c溉ert_p乡ath)栏功能:获厅取证书私钥丑输入:证广书路径油输出:私酱钥西funct济ione蒜ncryp膨tPan(述$pan)砖功能:加渗密卡号炉输入:卡杂号禽输出:加刺密后卡号捞funct树ione挥ncryp断tPin(汤$pan,股$pwd啄)佣功能:p贞in加密辣输入:卡筋号,密码葵输出:加星密后密码季funct介ione眉ncryp维tCvn2贫($cvn潮2)光功能:c情vn2加啊密谦输入:c狮vn2姥输出:加葵密后cvn孩2泥funct复ione笔ncryp舟tDate鸽($cer济tDate耻)罪功能:有乞效期加密雹输入:有面效期露输出:加耽密后有效期榴主要类与方拾法说明撇upacp霜_sdk_淡php.g顽bk.Pu北blicE追ncryp炉te.ph原p:密码加狸密守upacp卖_sdk_跟php.g耕bk.Pi平nBloc商k.php日:密码转p亚in担upacp烦_sdk_浑php.g贼bk.lo糠g.cla辟ss.ph袍p:日志类东ASP.N魂ET能插件.ne问tFra办mewor黄k4.0环粘境以上编写籍，ICSh栗arpCo禾de.Sh芹arpZi没pLib手注动添加，引给用泰工程名称为铁upacp氏_sdk_逗php，供唱系统集成。蹈配置文件说努明料1.W钻eb.co垄nfig:槐入网测试锦环境参数配娇置文件辩具体配置：瞧#####睁#SD氏K配置文挎件配置文件遭中日志和证狱书的存放路焰径根据实际延情况配置，委交易地址和牵证书根据捷测试译环境、生产很环境配套配黎置####季#瓜#####截#####描#####考#####土#####拾#交易发送析地址配##随#####晋#####升#####筛#####屋#####曾##据#####盯#(以下配贿置为啦认证闻环境：入网叫测试环境用熊，生产环境用配置见文档纵说明)##胡#####宴##前台交芳易请求地址亏<add冲key="侵sdk.f奖rontT少ransU护rl"v商alue=缺"盘户01.23伍1.204酸.80:5箭000/g迈atewa粱y/api墨/fron凤tTran时sReq.壶do"/请>状##后台交娃易请求地址觉<add孝key="仅sdk.b饰ackTr乎ansUr次l"va歌lue="欣s格://10禁1.231辱.204.所80:50籍00/ga送teway具/api/器backT房ransR音eq.do眼"/>供##后台交钉易请求地址社(若为有卡各交易配置该蕉地址)寻<add捞key="恰sdk.c僻ardRe秩quest诵Url"戴value浆="htt停ps://睡101.2肢31.20礼4.80:芹5000/狡gatew着ay/ap仙i/car屑dTran尾sReq.斩do"/茎>杠##批量交死易请求地址肯<add缘key="快sdk.b拦atTra却nsUrl上"val资ue="h介ttps:希//101注.231.汁204.8啊0:500咸0/gat踪eway/柱api/b巩atchT寨rans.币do"/街>洪##肚查询昂地址搭<add姥key="这sdk.s颜ingle馆Query兵Url"炼value闪="htt杨ps://以101.2脸31.20衰4.80:藏5000/箩gatew剥ay/ap孔i/que随ryTra例ns.do鸡"/>厘##文件传闲输类交易地盾址匪<add康key="没sdk.f黎ileTr敬ansUr裙l"va做lue="吵s病://10股1.231宪.204.矿80:90翅80/"荣/>沃##刻APP购交易地址杀<add酿key="谦sdk.a吵ppReq越uestU破rl"v遇alue=赶"抵顾01.23遵1.204贵.80:5恢000/g剩atewa弄y/api掩/appT皆ransR倾eq.do活"/>晌#####伪#####阀#####步#####贞####签南名证书配置赤#####勺#####肿#####轰#####恢#####朽#####笛##爪#####询#(以下配击置为黑测试敬环境：入网吨测试环境用棒，生产环境答配置见签下述材文档说明)希#####错##吊##签名证舞书路径味<add糠key="展sdk.s叮ignCe肠rt.pa瓣th"v伏alue=推"d:\c收erts\烧PM_70遥00000长00000访001_a汤cp.pf凶x"/>丽##签名证剂书密码玉<add驻key="锣sdk.s咐ignCe烂rt.pw著d"va得lue="艰00000指0"/>服##签名证屑书类型好<add撞key="坐sdk.s伞ignCe想rt.ty威pe"v陆alue=式"PKCS玉12"/摧>饼##留验签童<add沾key="刷sdk.v秀alida永teCer麻t.dir秘"val丽ue="d必:\cer阵ts\"炊/>印#####煮#####短#####赞#####蛮#####贿#加密证书纺配置###痛#####哀#####查#####欢#####秩#####器####糊##密码加跪密证书路径余<add执key="录sdk.e秒ncryp担tCert暮.path筐"val水ue="d革:\cer失ts\en街crypt短.cer"候/>洞2弹.桨Web.除confi碑g:生产宜环境参数配路置文件袭具体配置：顾#####衰#####垮#####涂#####沫#####估#交易发送著地址配##当#####求#####很#####膝#####宗#####醉##加#####益#(以下配咐置为么生产承环境用轿)恒#####链##珍##前台交局易请求地址岸<add况key="毫sdk.f蒸rontT希ransU谢rl"v绘alue=盟"辟父atewa眯y.955用16.co膝m/gat辞eway/戚api/f仰rontT紫ransR踪eq.do杯"/>后##后台交炎易请求地址侦<add臂key="燃sdk.b挡ackTr误ansUr胸l"va磨lue="酒s根://ga俱teway绸.9551注6功/gate盒way/a迫pi/ba口ckTra赴nsReq筛.do"烘/>据##后台交辱易请求地址康(若为有卡绑交易配置该项地址)蜜<add掏key="煤sdk.c延ardRe者quest乔Url"非value光="htt探ps://肠gatew慈ay.95惊516.c乖om/ga拿teway岂/api/休cardT惊ransR邀eq.do裹"/>押##单笔查孤询请求地址灰<add体key="碧sdk.s醒ingle刻Query灭Url"密value块="htt摔ps://钱gatew艘ay.95穗516.c泛om/ga惨teway衫/api/您query扯Trans恶.do"护/>渡##批量交呜易请求地址毫<add型key="浑sdk.b夜atTra累nsUrl物"val自ue="h敞ttps:暖//gat室eway.扯95516谅/猴gatew斥ay/ap炕i/bat谱chTra略ns.do谋"/>绸##文件传叮输类交易地照址皆<add哪key="多sdk.f链ileTr限ansUr穗l"va江lue="颗s甲://fi毙ledow磁nload搅.9551请6豪/"/>表##免APP鄙交易地址介<add番key="左sdk.a企ppReq伯uestU叛rl"是value帮="htt下ps://图gatew肺ay.95队516.c寺om/ga麻teway届/api/搅appTr倾ansRe算q.do"拦/>闻#####盯#####辞#####赢#####螺####签挖名证书配置院#####太#####婆#####渐#####俩#####哪#####合##疑##签名证脉书路径糟（请拿到生厘产环境证书鞋后修改签名泪路径、证书扣名称、证书近密码）阔<add港key="汁sdk.s童ignCe拳rt.pa泼th"v万alue=语"d:\c溪erts\奖PRO_7惕00000歌00000移0001_扶acp.p蓬fx"/海>督##签名证充书密码创<add骂key="扩sdk.s泉ignCe本rt.pw在d"va沙lue="雹00000液0"/>丝##签名证叔书类型徒acpsd饺k.sig边nCert驴.type号=啦PKCS1纸2匹##汽验签沉<add份key="械sdk.v毙alida盼teCer避t.dir挡"val祖ue="d午:\cer冻ts\"普/>似#####莲#####帮#####唇#####略#####裂#加密证书姿配置###畜#####疲#####助#####原#####超#####耻####极##密码加森密证书路径总<add友key="叹sdk.e勒ncryp粗tCert湖.path临"val片ue="d刚:\cer宪ts\RS进A2048逗_PROD梨_inde直x_22.取cer"即/>益主要类和方呼法说明亿主要类与方逼法说明挨com.u渴nionp警ay.ac览p.sdk陵.SDKC愉onfig皮.cs:负窃责读取we举b.con劝fig睛//功能：桶读取配置文饲件获取签名项证书路径烛priva双test球atic常strin道gsig誉nCert锄Path搅=con眉fig.A债ppSet内tings甲.Sett捆ings[辩"sdk.住signC尖ert.p掀ath"]违.Valu绸e;黄//功能：吴读取配置文汇件获取签名起证书密码春priva锁test彻atic舅strin单gsig虽nCert篮Pwd=黎conf裁ig.Ap兼pSett圈ings.德Setti侦ngs["轿sdk.s里ignCe害rt.pw矩d"].V州alue;绝//功能：箩读取配置文待件获取验签糖目录塞priva丙test晚atic雕strin章gval恩idate酒CertD促ir=疯confi姿g.App趋Setti共ngs.S渠ettin迫gs["s漠dk.va西lidat仰eCert班.dir"碑].Val击ue;强//功能：干加密公钥证塞书路径滩priva枝test打atic吴strin细genc绣ryptC赏ert=孟conf射ig.Ap绸pSett望ings.巩Setti页ngs["裤sdk.e喇ncryp紫tCert尾.path肯"].Va箩lue;柄//功能：设有卡交易路拳径;鞭priva溪test荷atic写strin尊gcar税dRequ疲estUr丰l=c示onfig悄.AppS天ettin织gs.Se卵tting栋s["sd节k.car容dRequ求estUr慎l"].V黎alue;敢//功能：棋app交易阅路径;缎priva绣test搁atic而strin怠gapp底Reque鱼stUrl览=co消nfig.果AppSe干tting振s.Set小tings砍["sdk祝.appR巴eques鹅tUrl"花].Val跨ue;裁//功能：咏读取配置文德件获取交易粒查询地址妨烫priva茫test降atic毯strin墙gsin及gleQu摸eryUr千l=c太onfig纤.AppS娱ettin诵gs.Se浴tting工s["sd谋k.sin嘱gleQu泼eryUr倡l"].V气alue;驼//功能：录读取配置文企件获取文件垂传输类交易累地址量priva头test雪atic蠢strin答gfil乏eTran勾sUrl箩=con乡fig.A午ppSet碍tings摧.Sett己ings[畏"sdk.量fileT玩ransU朽rl"].挤Value垦;弃功能：读取屋配置文件获刮取前台交易汗地址贞priva对test宇atic阴strin宿gfro卧ntTra暖nsUrl驱=泳confi膨g.App阶Setti雾ngs.S浅ettin酒gs["s劲dk.fr沟ontTr置ansUr升l"].V趁alue;骑随功能：读取避配置文件获翼取后台交易筋地址回priva狼test扯atic唉strin脱gbac致kTran逮sUrl神=con钓fig.A血ppSet蠢tings末.Sett豆ings[侄"sdk.位backT乞ransU悄rl"].病Value往;座//功能：龙读取配批量象交易地址竿priva师test旁atic烦strin烛gbat信Trans弃Url=椒conf喜ig.Ap残pSett泊ings.财Setti躁ngs["柴sdk.b齿atTra呼nsUrl地"].Va逃lue;摔主要类与方箭法说明测com.u压nionp剪ay.ac堆p.sdk我.SDKU窜til.c羊s：主要负鼻责组装报文狱、证书签名咸、发送报文蚊、接收报文躁、验证签名晴、加密解密胆等操作，具光体请查看代波码。烘获取签名。流publi拜csta起ticb瞎oolS归ign(D印ictio哑nary<维strin毙g,st票ring>唇data程,Enc歼oding散enco截der)搭验证签名亮publi隐csta党ticb总oolV膊alida忘te(Di品ction断ary<s洋tring蹲,str具ing>班data,值Enco罗ding却encod任er)孕组装报文模publi堤csta奖tics闻tring卸Crea汗teAut营oSubm明itFor贺m(str斧ingu逃rl,D闻ictio屯nary<摧strin指g,st御ring>兰data船,Enc悠oding克enco瓣der)宗将Dict司ionar节y内容排序堂后输出为键植值对字符串怠,供打印报号文使用曾publ派icst悬atic歌strin浅gPri丑ntDic仍tiona歉ryToS伸tring捡(Dict寒ionar绘y<str松ing,照strin李g>da袖ta)情将形如ke吴y=val卡ue&ke长y=val淹ue的字符栗串转换为相巩应的米Dicti先onary钥对象驼publi棒csta笛ticD艇ictio众nary<兼strin喊g,st旷ring>友Cove患rstri互ngToD丰ictio歉nary(屑strin境gdat防a)面pinbl挣ock1员6进制计算蹈publi筹csta垦tics证tring彩prin说tHexS扶tring瑞(byte尼[]b)令密码加密，遗输入参数依那次为卡号、蜻密码、字符装集乘Publi殊cstat重ic迁s刺tring战encr英yptPi担n(关s竟tring要card像,梢s五tring天pwd,露索s容tring资enco税ding)贩数据加密，辫输入参数依煤次为数据、压字符集封Publi刷cstat员ic粥s刑tring灭encr个ypt轧Data絮(恩s拥tring欢盘data，吊s是tring竞enco趟ding)篇主要类与方宗法说明聚com.u箭nionp忙ay.ac鸭p.sdk姐.Cert展Util.瓶cs：证宜书操作工具攻类，主要是赠导入pfx宫证书与获取稍获取私钥操悼作。词获取签名证涉书私钥护publi饲csta拥ticR县SACry析ptoSe存rvice成Provi掠derG薪etSig蜂nProv昼iderF明romPf资x()爷获取签名证旷书的证书序纱列号乱publ被icst炉atic姨strin歼gGet端SignC笛ertId危()韵通过证书i洪d，获取验旧证签名的证猫书痰publi凑csta纪ticR预SACry敌ptoSe冻rvice拴Provi绕derG鄙etVal腿idate纪Provi艇derFr居omPat甩h(str奴ingc害ertId土)届主要类与方元法说明廉com.u因nionp补ay.黄acp.s两dk淋.性Secur磨eUtil吨.cs主要弓负责报文的艰软签名、验问证签名、加岩密；汇压缩、解压闹、Base燕64编码/芹解码,pi再nbloc难k计算等提协供SHA-助1及RSA丢的方法类。肾摘要计算圈publ企icst浴atic啄byte[岸]Sha端1X16(防strin跟gdat爹aStr,悟Enco犹ding租encod诊ing)埋软签名袖publ晌icst炼atic袄byte[乖]Sig执nBySo既ft(RS泽ACryp壶toSer戏viceP潮rovid帅erpr亿ovide台r,by碑te[]阅data)勾验证签名页publ拆icst稼atic民bool皂Valid比ateBy绑Soft(洪RSACr鞠yptoS连ervic城eProv腐ider谎provi午der,感byte[惑]bas拖e64De嘴codin炒gSign有Str,普byte[体]src天Byte)偶Base6刚4编码持publi锤csta墙tics狸tring浮Enco梅deBas茅e64(E谊ncodi苗ngen估code,染stri衔ngso妇urce)腿Base6盯4解码姻publ板icst贷atic瞧strin愤gDec成odeBa纲se64(薯Encod畜inge拼ncode裹,str拒ingr护esult量)扩Infla盛ter解压们缩否publi详csta知ticb活yte[]逆infl棕ater(吧byte[欢]inp怕utByt继e)铁defla惠ter压缩睁publ买icst永atic率byte[现]def供later暂(byte动[]in烧putBy平te)轧密码计算裹priva耗test至atic嚼byte[旬]pin奇2PinB详lock(剂strin怖gaPi严n)气获取卡号密木码pinb买lock计惑算歼publi艘csta啦ticb碰yte[]兴pin2玉PinBl辆ockWi州thCar泄dNO(s支tring耗aPin验,str梦inga勺CardN资O)些卡号计算守priva让test肥atic愧byte[餐]for杰matPa嘴n(str弊inga辱Pan)那加密妨publi馅csta惨ticb丛yte[]挣encr没ypted难Data(坊byte[犯]enc届Data)组主要类与方反法说明溜com.u切nionp殃ay.ac界p.sdk村.茅Clien崭t.cs斤是通信类，谅具体请参考绣代码的说明疼。严提供和服务酬器通信的H事TTP客户拒端类。和将请求参数缸以索表单的方式倦进行一次H喉TTPP未OST通信探。崇Publi盟cint为S亚end(鲜Dicti冤onary识<弃s优tring忍,遮s极tring题>搂sPara清Temp揉,木Encod躺ing纯encod恩ing)睡常见问题问乔答姐Q：如何获列取猴测试桐商户绕号与测试证唉书脚？计A：测试环茂境申请测试逐用户后点击盗“我的测试穿>测试参数吐”中查看商掘户号，并点稼击下载测试政证书，注册时地址：粥s访://op识en.un协ionpa龄y缓/ajwe骄b/reg扔ister按，生产环境扑请联系业务行部门，吴具体联系方砍式如下：奏发送邮件至混：ope猎ratio炊n@uni液onpay丙进标行业务申请忙和咨询，银派联有专门的瓜人员进行处病理。覆其他专项服跌务：请见《懂业务运营服剩务指引（商虽户）》日贩常业务运营锦服务。简Q：如何签棉名？酷A：认对报文中出溉现签名域（樱signa刘ture惜）之外的所鸭有数据元采码用按key=v僻alue盟的形式按照始名称排序，伞然后以柔&把作为连接符效拼接成待签都名串。其次浴，对待签名指串使用锋SHA-1淹算法做摘要渠，并转成争16跟进制，再使哗用银联颁发卡给商户的商呼户泥RSA挪私钥证书对素摘要做签名脱操作（签名地时算法选择葛SHA-1汉）。最后，罩对签名做境Base6醒4总编码，将编江码后的签名有串放在签名滑（郑signa忘ture持）表单域里睡和其他表单竞域一起通过弟胸Post纳的方式传输荣给银联刊全渠道系统券支付平台。岔Q：报文域满中与front贷Url陷和续back口Url鼠要填什么？造A鹅:汉front式Url琴和吹backU软rl瘦为报文上送顶要素据，茎银联系统将瞒前台通知报浊文返回到报据文中的fr不ontUr烫l地址，将恒后台通知报身文返回到报蹲文中的ba伤ckUrl远地址。塘Q：然如何获取与式配置银联什入网烂测试环境地煤址？涌A:可醉参见11章致节乖测试环境俊参数配置躁，配置文件拳可在开发包予中找到（开捐发包获取地接址：碧s袭://op置en.un谷ionpa稿y沈/ajwe拌b/hel浆p/fil占e/辩）。具体接掀入地址如下喂：异银联入网测鱼试环境地址脸：杯前台交易请亿求地址目s咏://10灭1.231邻.204.谱80:50栋00/ga授teway膜/api/控front沾Trans赤Req.d居o看后台交易请绒求地址培（无卡）娱s而://10飞1.231膏.204.桐80:50闭00/ga群teway潜/api/遗backT狱ransR睁eq.do葬后台交易请铲求地址顽（有卡）吵s阻://10谷1.231钓.204.叛80:50些00/ga勒teway题/api/奶cardT拒ransR剖eq.do折单笔查询请骗求地址芬s夏://10贡1.231山.204.贪80:50复00/ga政teway缘/api/驱query坑Trans广.do年批量交易请汁求地址扬s吵://10禁1.231拿.204.自8淹0:500母0/gat钉eway/除api/b服atchT判rans慨.do麦文件传输类壤交易地址膝s订://10偷1.231复.204.县80:构9080德/崭APP交易盐请求地址洲s瑞://10愁1.231健.204.陕80:50喜00/ga抬teway左/api/极appTr闷ansRe患q.do禾Q：银联滥全渠道系统征商户接入碧生产狮环境地址？测A:可吼参见11章既节丽生产衫环境违参数配置示，配置文件佳可在开发包叮中找到（开融发包获取地止址：呢s爽://op跟en.un孩ionpa下y却/ajwe蜓b/hel圈p/fil吓e/瞒）。将配置胶文件中测试纸地址修改为悄如下地址：邀银联入网测盯试环境地