国付宝人民币标准网关接口手册(新平台)V2.1

国付宝信息科技有限公司1/26国付宝人民币支付网关2.1接口文档[V2.1]国付宝信息科技有限公司GopayInformationTechnologyCompany,limited国付宝信息科技有限公司2/26日期版本说明作者2011-10-101.0初稿崔文才2012-02-011.1通知商户返回信息增加商品信息、买方信息马欢2012-06-061.2在网关报文加密域中增加国付宝服务器时间张雷2014-01-092.1新平台网关接口涂克中国付宝信息科技有限公司3/26目录1.前言..................................................................51.1目标............................................................51.2阅读对象........................................................51.3术语定义........................................................52.接入流程..............................................................62.1商户接入准备....................................................62.2交易流程示意图..................................................72.3交易流程........................................................72.4商户测试上线流程................................................83.参数说明..............................................................93.1商户发送参数列表................................................93.2返回商户参数列表...............................................124.防钓鱼机制...........................................................134.1域名防钓鱼机制.................................................134.2IP防钓鱼机制...................................................144.3时间戳防钓鱼机制（推荐商户使用）................................145.通知机制.............................................................156.交易结果处理.........................................................167.手工执行补单操作.....................................................178.联系我们.............................................................188.1公司相关信息...................................................188.2客服联系方式...................................................189.附录.................................................................199.1返回码列表.....................................................199.2银行代码列表...................................................21国付宝信息科技有限公司4/269.3关于商户识别码.................................................229.4关于加密域生成.................................................239.5相关规范说明...................................................259.6测试环境测试资源...............................................26国付宝信息科技有限公司5/261.前言1.1目标本文档对国付宝电子支付平台人民币支付网关的使用进行详细说明，帮助商户熟悉国付宝人民币支付网关的支付交易流程，达到方便商户系统集成，快速接入国付宝支付平台的目的。1.2阅读对象本文档的阅读对象是国付宝接入商户的应用开发人员、维护人员和管理人员。1.3术语定义缩写/术语解释商户接入国付宝的提供电子商务功能的企业平台。商户网站商户机构自身的电子商务应用网站卖家电子商务交易中出售商品收取货款一方。买家电子商务交易中购买商品支付货款一方。请求通过HTTP协议将报文数据发送给接收方的过程通知国付宝处理完成后将响应报文以前台或者后台的方式发送给商户网站的过程提留金商户想要直接从交易金额中提取的手续费金额防钓鱼防钓鱼用来一定程度上防止“黑客”利用欺骗性请求和伪造的Web站点来进行诈骗活动的发生。国付宝信息科技有限公司6/262.接入流程2.1商户接入准备1.商户在国付宝网站注册企业用户，并收取系统邮件进行激活。2.商户以邮寄、传真等方式将营业执照等复印件送国付宝运营平台审核，审核通过后商户可使用注册的email地址作为用户名登录国付宝。3.登录后首先开通企业结算虚拟帐户并设置支付密码。4.点击页面右上角的“开通商户服务”链接，并输入真实有效的商户申请信息，提交后等待国付宝运营人员审核。5.审核通过后请退出并重新登录商户企业用户，开通商户服务的企业用户将新增（商城\商铺服务）功能，并在安全中心功能中增加“设置识别码”功能，商户自行输入识别码后即可生效。关于识别码详见关于商户识别码。国付宝信息科技有限公司7/262.2交易流程示意图2.3交易流程1.买家在商户网站选择商品，商户生成支付交易报文(发送参数见商户发送参数列表)。表单格式示例如下：formaction=method=POST版本号:inputtype=textname=versionvalue=2.0/字符集:inputtype=textname=charsetvalue=1/语言种类:inputtype=textname=languagevalue=1/签名类型:inputtype=textname=signTypevalue=1/交易代码:inputtype=textname=tranCodevalue=8888/商户代码:inputtype=textname=merchantIDvalue=0000001502/订单号:inputtype=textname=merOrderNumvalue=2011092200001/交易金额:inputtype=textname=tranAmtvalue=10.00/手续费:inputtype=textname=feeAmtvalue=0/币种:inputtype=textname=currencyTypevalue=156/前台通知地址:inputtype=textname=frontMerUrlvalue=后台通知地址:inputtype=textname=backgroundMerUrl国付宝信息科技有限公司8/26value=交易时间:inputtype=textname=tranDateTimevalue=20081107094626/转入账户:inputtype=textname=virCardNoInvalue=0000000001000000001/用户IP:inputtype=textname=tranIPvalue=127.0.0.1/商品名称:inputtype=textname=goodsNamevalue=全聚德烤鸭一套/商品描述:inputtype=textname=goodsDetailvalue=全聚德烤鸭，肉香皮酥，好吃不贵/买方姓名:inputtype=textname=buyerNamevalue=张三/买方联系方式:inputtype=textname=buyerContactvalue=北京/商户备用字段1:inputtype=textname=merRemark1value=/商户备用字段2:inputtype=textname=merRemark2value=/系统备用信息:inputtype=textname=remarkvalue=/重复提交标志:inputtype=textname=isRepeatSubmitvalue=1/密文串:inputtype=textname=signValuevalue=3d810c55a350a53b2df5f19fc45d69bd//form密文串生成规则见关于加密域生成。2.商户将报文以POST的方式发送到国付宝网关，网关对报文进行校验，然后进行相应的账务处理。3.网关处理完毕后，将处理结果报文(返回参数见返回商户参数列表)通知到商户上送的前后台通知地址，具体通知机制见通知机制。2.4商户测试上线流程商户接入国付宝测试环境进行联调测试。商户接入国付宝正式环境进行联调测试。正式上线运营。国付宝信息科技有限公司9/263.参数说明3.1商户发送参数列表参数(所有参数都要传递)参数名称长度(类型均为String)参数说明是否可空样例version网关版本号5必须为2.1不可2.1charset字符集1格式：数字1GBK2UTF-8默认为1本域指明了商户端的编码格式，网关会依据此对中文域进行解析，响应信息按GBK编码方式返回可空1language网关语言版本1格式：数字1中文2英文本域为多语言支持预留字段不可1signType报文加密方式1格式：数字1MD52SHA默认为1报文签名域signValue的加密方式可空1tranCode交易代码4格式：数字本域指明了交易的类型，支付网关接口必须为8888不可8888merchantID商户代码10格式：字母/数字签约国付宝商户唯一用户ID不可0000001502merOrderNum订单号1-30格式：数字，字母，下划线，竖划线，中划线用于传送商户订单号信息，每笔新的交易需生成一笔新的订单号，如果isRepeatSubmit为1，则未支付的订单号可以重复提交，但要保证交易金额一致。不可20110922-00001tranAmt交易金额1-11格式：数字范围[0.01-9999999999.99]本域值仅包含交易本金，不包含任何服务费，且其值在交易的整个过不可10.00国付宝信息科技有限公司10/26程中保持不变feeAmt商户提取佣金金额1-12格式：数字范围[0.01-9999999999.99]本域值为提留手续费金额，且不能超过交易金额域tranAmt可空1.00currencyType币种3格式：数字多币种预留