上海盛付通电子商务有限公司-盛付通即时到账收款接口文档.doc

盛付通即时到账收款服务接口文档 上海盛付通电子商务有限公司盛付通即时到账收款接口文档上海盛付通电子商务有限公司版 本 控 制文件状态 草稿 正式发布 正在修改 注销文档编号：当前版本：V1.5作 者：盛付通基础产品部（郭运畅）完成日期：2010.12.27备 注：修 改 历 史 记 录更新日期版本说明作者2010-08-18V1. 0盛付通即时到账接口说明盛付通基础产品部2010-08-20V1. 1更新了资金渠道列表盛付通基础产品部2010-10-19V1. 2修改了资金渠道的描述以及即时到账收款服务的描述盛付通基础产品部2010-12-17V1. 3修改了银行代码描述盛付通基础产品部2011-02-18V1.4修改了银行代码描述盛付通基础产品部2011-03-04V1.5增加12、13通道银行编码盛付通基础产品部目录1.文档概述12.业务术语23.服务描述24.使用说明35.加密与安全策略36.支付请求接口规范47.发货通知接口规范88.联系方式111. 文档概述本文档是盛付通专为合作商户提供的即时到账收款服务接口的说明文档。为了协助合作伙伴成功接入盛付通提供即时到账收款服务，分享盛付通积累多年的渠道优势，请务必依据文档内容开发部署。本版本适用的开发环境有：Java、PHP、ASP、.Net。特别声明：未经盛付通许可，不得将盛付通提供的接口技术、安全协议及证书等以任何方式提供给第三方使用。请合作伙伴妥善保存。本文档的解释权归盛付通所有，若内容有变，恕不另行通知。2. 业务术语名称 说明商户号 商户与盛付通合作后在盛付通产生的用户ID 接口名称 是盛付通针对一些外部接口业务的名字（service） 3. 服务描述即时到账收款服务基于买家对您信任，在买家完成订单支付后，交易资金立即到达商家盛付通账户上的收款服务，该服务可大大提升商家资金回笼速度和利用率，同时盛付通还为商家提供了强大的管理后台。 示意图：产品优势：资金到账迅速：无时间、区域限制，跨行、跨省、跨地区，交易资金瞬间到账，帮商家有效提升资金回笼速度和利用率； 强大的管理后台：便于商家进行交易管理，对账等操作；4. 使用说明支付请求采用http/https协议，商户需以POST方式传输给盛付通系统；盛付通使用的编码方式为：GBK/GB2312；传输参数需以Web Form（表单）方式提交；请严格依照参数规范设置参数，切勿遗漏“必填”参数，注意大小写区分；建议商户保留以下信息：签名信息、传输参数。5. 加密与安全策略可供商户选择的加密方式有3种： MD5散列算法、RSA公钥加密算法、PKI数字证书；MD5散列算法：（1） 开发环境为Java、PHP的，请使用MD5加密方式。（2） MD5 密钥生成后，登录盛付通商户控台上传即可。（3） 伪码如下：获取订单信息签名：signature = MD5(orderInfoString)验证签名是否有效：signature = MD5(callbackInfoString) If(signature=SignMsg)return true;RSA公钥加密算法：（1） 开发环境为ASP、.Net的，推荐使用MD5加密方式。（2） 私钥生成后请商户自行保管用于签名，同时，请上传生成的公钥至盛付通商户控台，以便验签。（3） 伪码如下：获取订单信息签名：signature = Sign(orderInfoString)验证签名是否有效 IsValidSignature = VerifySign(orderInfoString, signature)PKI证书加密算法：如需使用请联系盛付通技术人员联系方式见下文。注：请注意保管签名信息。密钥一旦上传确认后，商户无法自行修改。如需修改，请与盛付通技术人员联系。6. 支付请求接口规范.6.1. 请求地址： 正式环境请求地址：/paygate/default.aspx 测试环境请求地址：/paygate/default.aspx注：以Web Form（表单）方式提交参数至上述地址（请勿使用URL 链接后加参数的方式）6.2. Form输入参数规范：参数名称类型必填说明备注VersionString(10)版本号3.0AmountDecimal（10,2）支付金额必须含两位小数。如：2.00OrderNoString（16）商户订单号=32位,商户必须保证其唯一性,否则支付将失败MerchantNoString（6）商户号由盛付通商务人员提供MerchantUserIdString（50）商户用户商户的用户IDPayChannelString（10）支付渠道 支付渠道为两位数字，增加多个渠道请用逗号“，”隔开。PostBackUrlString（128）回调地址显示给终端用户的地址NotifyUrlString（128）发货地址服务器端发货通知接口BackUrlString（128）商户下单地址用户取消订单返回或者重新发起订单的地址OrderTimeString（14）订单日期必须为14位，格式:yyyyMMddHHmmssCurrencyTypeString（3）货币类型必须为：RMBNotifyUrlTypeString（10）发货通知方式http,https,tcp等SignTypeString（1）签名类型1:RSA 2:MD5 3:PKIProductNoString(32)商品编号商品的编号,由商户定义ProductDescString（256）商品描述商品的描述信息Remark1String（256）备注1Remark2String（256）备注2BankCodeString（10）默认银行当使用银行渠道时有效DefaultChannelString(2)默认渠道MACString（256）加密串由盛付通提供的签名组件加密6.3. 参数说明Version ：版本号，string类型，默认为3.0。Amount ：订单金额，decimal类型，必须大于0，包含2位小数。OrderNo ：商户订单号，最多32位，商户需保证其唯一性，且不能为空。MerchantNo：商户号，由盛付通提供给签约商户，可向技术人员索取。MerchantUserId：商户用户id，终端用户在商户系统内的账号，此字段非必需。可用于客服处理异常事件或商户控台。PayChannel：支付渠道，为2位数字，如增加多个渠道请用逗号“，”隔开。含义如下：03盛大一卡通支付，04银行卡支付，07-一点充支付，12大额b2c支付，13b2b支付，14钱包余额支付，18手机卡支付，19-储蓄卡、20-信用卡、24-大额信用卡、27-盛付通卡。传输本参数，用来设定用户可见的支付渠道，但需确保传入的支付渠道已经过协议授权；如果不传，则显示商户签约的所有支付渠道。PostBackUrl：客户端回调地址，支付成功后，将附带回调数据跳转到此页面，商户可以进行相关处理并显示给终端用户。NotifyUrl：服务端通知发货地址，支付成功后，盛付通将发送“支付成功”信息至该地址，通知商户发货，商户收到信息后，需返回相应信息至盛付通，表明已收到发货通知。返回信息只能定义为“OK”（注意为大写英文字母），返回其他信息均为失败。如未反馈或反馈信息错误，则盛付通将按预订策略补发发货通知。详细可参考【示例】。BackUrl：商户下单地址，支付过程发生异常或者用户取消、修改订单时可选择回到此页面重新发起订单，非必须。OrderTime：下单日期，用户在商户网站下单的日期。必需为14位数字，格式为yyyyMMddHHmmss。如：20090701121123。CurrencyType：货币类型，仅支持人民币，必需传入“RMB”。NotifyUrlType：发货通知方式，tcp，http，https等。一般为http。SignType：签名类型，1位数字。1RSA，2MD5，3 - PKI。RSA方式：提交订单时使用商户的私钥签名，盛付通使用对应的公钥验签；支付成功后盛付通使用盛付通的私钥签名，商户使用对应的公钥验签。MD5方式：商户和盛付通使用同样的MD5密钥，加密和解密均使用MD5。PKI方式：如需使用请联系盛付通技术人员。ProductNo：商品编号。商户可通过该参数定义不同商品，便于订单查询时区分。非必须。ProductDesc：商品描述。商品的名称，非必须。Remark1：备注1，非必须。Remark2：备注2，非必须。BankCode：默认银行，非必填，用户使用网银支付渠道时默认选中该银行。DefaultChannel：默认支付渠道 。非必须。用户进入支付网关时默认选择的支付渠道，需要包含在指定的PayChannel之内。如果不传，则显示PayChannel指定的第一个支付渠道。MAC：加密串。把上述所有字段按顺序直接连接，随后使用加密方式签名。6.4. MAC计算方式（签名）（1） 待签名串：OriginVersion + Amount + OrderNo + MerchantNo + MerchantUserId + PayChannel + PostBackUrl + NotifyUrl + BackUrl + OrderTime + CurrencyType + NotifyUrlType + SignType + ProductNo + ProductDesc + Remark1 + Remark2 + BankCode + DefaultChannel + ProductUrl；（2） 签名方式：RSA方式：MAC =RSASign.Sign (Origin)MD5方式：Mac=md5(Origin+md5key)注：具体调用方法请参考【示例】7. 通知返回接口规范..7.1. 使用说明盛付通唯有确认支付成功后，才会调用商户的发货接口；盛付通通过2种方式同时回调：即客户端方式（浏览器）与服务端方式；客户端方式对应的支付请求参数为：PostBackUrl；服务端方式对应的支付请求参数为：NotifyUrl；客户端回调方式，目的是通过网页方式向用户告知支付结果；服务端回调方式，则从底层，确保盛付通向商户系统传输正确的回调信息；以上两种方式都以Form（表单）方式回发参数（包括：订单号、支付金额、支付状态等）。7.2. 服务端发货通知接口说明服务端发货接口对应的支付请求参数为：NotifyUrl。该接口由商户提供。终端用户一旦支付成功后，盛付通将调用该接口，通过底层通知商户发货并执行相关业务操作。该接口验签成功及处理相关逻辑（如更新订单状态等）后，应返回信息“OK”。注意： 返回信息只能定义为“OK”（必须为大写英文字母），如返回其他信息均为失败。如失败，则盛付通系统将在24小时内反复调用该接口，过24小时后挂单，处理为补单失败。 该接口由盛付通平台调用，如果商户对安全要求很高，商户可以设置ip限制。 发货接口以Web Form（表单）形式提交。7.3. Form参数规范参数名类型说明备注Amountdecimal(10,2)订单金额两位小数点PayAmountdecimal(10,2)实际支付金额两位小数点OrderNostring(32)商户订单号=32位,商户必须保证其唯一性,否则支付将失败serialnostring(32)支付序列号Statusstring(2)支付状态01：成功 MerchantNostring(6)商户号由盛付通商务人员提供PayChannelstring(2)实际支付渠道 两位数字。03-盛大一卡通支付04-网银B2C支付等Discountdecimal(10,2)折扣SignTypestring(1)签名类型1:RSA 2:MD5 3:PKIPayTimedatetime支付时间yyyyMMddHHmmssCurrencyTypestring(3)货币类型必须为：RMBProductNoString(32)商品编号商品的编号,由商户定义ProductDescstring(256)商品描述商品的描述信息Remark1string(256)备注1Remark2string(256)备注2ExInfo额外信息MACstring(256)签名加密串由盛付通提供的签名组件加密“OK”string如处理成功，返回“OK”即可7.4. 返回参数规范参数名类型说明备注“OK”string如处理成功，返回“OK”即可7.5. MAC计算方式（加密）待签名串：Origin =Amount + | + PayAmount + | + OrderNo + | + serialno + | +Status + | + MerchantNo + | +PayChannel + | + Discount + | + SignType+ | + PayTime +| + CurrencyType + | + ProductNo + | + ProductDesc + | + Remark1 + | + Remark2 + | + ExInfo验签方式： RSA方式：IsSuccess = RSA.VerifySign(Origin,Mac);if(IsSuccess) Response.Write “OK”; MD5方式：Mac2 = MD5(Origin+| +MD5 Key );if(Mac=Mac2) Response.Write “OK”; 注：具体调用方法请参考【示例】7.6. 客户端发货接口说明客户端发货接口对应的支付请求参数为：PostBackUrl。该接口由商户提供。终端用户一旦支付成功后，盛付通将调用该接口，通过页面方式向商户通知发货并执行相关业务操作，同时用户可获知支付结果。该接口的参数规范与4.2服务端发货接口一致，但无需输出返回信息“OK”。7.7. 银行列表7.1. 综合网银编码列表BankCode参数银行名称BankCode参数银行名称SDTBNK测试银行NBCB宁波银行ICBC工商银行SZPAB平安银行CCB建设银行BOS上海银行ABC农业银行NJCB南京银行CMB招商银行SPDB浦东发展银行COMM交通银行GNXS广州市农村信用合作社CMBC民生银行GDB广东发展银行CIB兴业银行SHRCB上海市农村商业银行HCCB杭州银行CBHB渤海银行CEB光大银行HKBCHINA汉口银行CITIC中信银行ZHNX珠海市农村信用合作联社GZCB广州银行SDE顺德农信社HXB华夏银行YDXH尧都信用合作联社HKBEA东亚银行CZCB浙江稠州商业银行BOC中国银行BJRCB北京农商行WZCB温州银行PSBC中国邮政储蓄银行BCCB北京银行SDB深圳发展银行SXJS晋商银行7.2.大额B2C银行编码列表12大额B2C通道BankCode参数银行名称BankCode参数银行名称SDTBNK测试银行CCB建设银行ICBC工商银行7.3.B2B银行编码列表13B2B通道BankCode参数银行名称BankCode参数银行名称SDTBNK测试银行CCB建设银行ICBC工商银行ABC农业银行CMB招商银行CEB光大银行7.4.借记卡编码列表19借记卡银行列表BankCode参数银行名称BankCode参数银行名称SDTBNK测试银行CMBC 民生银行ICBC工商银行SPDB浦东发展银行CMB招商银行CIB兴业银行CCB建设银行BOC中国银行ABC农业银行SDB深圳发展银行SZPAB平安银行COMM交通银行HXB华夏银行CITIC中信银行CEB光大银行GDB广东发展银行BOS上海银行BJRCB北京农商行NBCB宁波银行SDE顺德农信社CBHB渤海银行PSBC中国邮政储蓄银行HKBEA东亚银行HCCB杭州银行G