富滇银行网上支付商户直联企业端接口技术标准V10

富滇银行网上支付商户直联企业端接口技术标准1富滇银行网上支付商户直联企业端接口技术标准富滇银行网上支付商户直联企业端接口技术标准2前言本文档介绍富滇银行商户端直联企业端的技术标准，其中包括通知消息银行签名数据、报文的语法与语义、网络连接方式、安全规范等。参与富滇银行直联接口业务的各方必须遵守该技术规范，以实现准确、安全、方便的网上支付与相关业务。文档历史修订日期修订内容修订版本修订人2014/09/01文档初建V1.0guil富滇银行网上支付商户直联企业端接口技术标准3目录富滇银行网上支付商户直联企业端接口技术标准......................................................................1前言...............................................................................................................................................................................2文档历史.......................................................................................................................................................................2目录...............................................................................................................................................................................3第1章概述...........................................................................................................................................................41.1商户请求接入说明...................................................................................................................................41.2安全API说明...........................................................................................................................................4第2章商户直联API说明...................................................................................................................................62.1订单查询...................................................................................................................................................62.2退款提交.................................................................................................................................................112.3商户对账.................................................................................................................................................14第3章公共错误报文.........................................................................................................................................18第4章商户签名过程.........................................................................................................................................184.1使用安全客户端代理签名.....................................................................................................................184.2使用证书签名.........................................................................................................................................23第5章商户验签过程.........................................................................................................................................255.1商户验签描述.........................................................................................................................................255.2验签代码实例（java版）......................................................................................................................265.3验签代码实例（C#版）.........................................................................................................................28富滇银行网上支付商户直联企业端接口技术标准4第1章概述1.1商户请求接入说明商户报文通过post方式发送，使用https协议，并且请求报文头中User-Agent属性的值必须是NetPay，即设置setRequestProperty(User-Agent,NetPay)，具体代码实现方式根据商户业务规则来定。测试地址：生产地址：若有问题请联系富滇相关人员。1.2安全API说明为了保证商户提交订单数据和银行通知信息数据的完整性，不可抵赖性，现提供一套用于信息签名、验签和BASE64编解码的函数。商户开发时使用这套函数和富滇银行颁发的商户证书或使用安全客户端代理进行商户订单信息签名；签名数据项和顺序均固定，具体格式可参见商户签名过程、商户验签过程；同时使用这套API可以验证银行通知消息的有效性。1.3直联接入方式介绍富滇银行支持2种直联接入方式，商户可根据自己情况选择适于自己的接入方式。1.3.1企业端安全客户端代理接入方式如图所示，企业应用将交易请求发往企业端安全客户端代理（KoalSCPClient），KoalSCPClient接收交易请求（http方式），经过加密后（https方式）传送到富滇银行端服务，富滇银行进行处理交易并返回结果。富滇银行网上支付商户直联企业端接口技术标准51.3.2企业端直联接入方式如图所示，企业应用将交易请求将交易请求经过加密后（https方式）直接传送到富滇银行端服务，富滇银行进行处理交易并返回结果。富滇银行网上支付商户直联企业端接口技术标准6第2章商户直联API说明2.1订单查询2.1.1请求报文格式?xmlversion=“1.0”encoding=“UTF-8”?FDBankDataopReq!--交易请求数据--serialNo*********/serialNo!—序列号--bsnCode070001/bsnCode!—交易码070001--cstNo*********/cstNo!—商户客户号--userId*********/userId!—商户操作员号--reqTime*********/reqTime!--客户端请求时间（yyyymmddhhmmss）--reqParamorderNo查询订单号/orderNotransferType交易类型/transferTypetransferResult交易状态/transferResultbeginDate起始日期/beginDateendDate截止日期/endDateRESV商户端序列号/RESV/reqParam/opReqSignedPubKey签名公钥/PubKeySignedData签名数据/SignedData/Signed/FDBankData交易请求参数实体说明：Tag名称描述长度和精度约束备注serialNo交易序列号(客户端唯一标识)VARCHAR(20)必输域用于和返回数据中的serialNo进行验证bsnCode功能代码CHAR(6)必输域交易功能的代码订单查询为070001；订单退款为070002；商户对账为070003.富滇银行网上支付商户直联企业端接口技术标准7cstNo商户客户号VARCHAR(10)必输域银行端标识该企业的唯一编号userId商户操作员VARCHAR(6)必输域银行端标识该企业操作员的编号reqTime客户端请求时间VARCHAR(14)必输域yyyymmddhhmmssorderNo要查询的订单号VARCHAR(32）可空如果订单号、交易类型、交易状态、查询交易起始日期、查询交易截止日期、序列号都为空，那么会查询出商户的全部流水transferType交易类型CHAR(4）可空共4位：分别代表：支付、撤销、部分退款、全额退款4种交易；例如：1000代表支付；0100代表撤销；0010代表部分退款；0001代表全额退款；1101代表支付、撤销、全额退款；1111代表查询所有类型的交易；等等。transferResult交易状态VARCHAR(32）可空输入项的范围：100查询状态为成功的指令010查询状态为失败的指令001查询状态为可疑的指令111查询以上所有指令状态以上状态可自由组合富滇银行网上支付商户直联企业端接口技