百付通企业网关接口规范.1.0.4.2.doc

百付通网企业网关接口规范 V1北京创融投资有限公司2005年4月17日一、 前言 1. 目的 该手册的主要目的是帮助百付通会员掌握百付通网络支付平台系统接口的安装与使用方法，以便接入到现有的系统中。 2. 使用对象 本文档的使用对象为使用百付通过企业型网关接口的商户的技术人员。 3. 运行环境 百付通企业网关接口采用标准的Web模型与MD5标准算法， 适用于任何平台中的任何语言，具备十分良好的兼容性，并且不需安装任何组件即可使用。 二、 术语说明1. 企业网关接口：接收用户传递过来的定单数据，并生成交易，在交易完成后实时返回结果到用户指定的接收地址。2. 商户密钥：用户在百付通设置的一个长度为128个字节的任意字符。 商户的密钥可以登陆百付通网站后自行设置，必须为128个字节的字符串，可以自行编设置，必须为128个字节的字符串，可以自行编写，也可点击生成按扭生成商户密钥，该密钥生成后，百付通会保存该密钥的副本，以核对数据，用户也需要妥善保管该密钥，用以签名要发送的数据和验证接收的数据。3. SSL(Secure Socket Layer)：一种基于网络传输层的安全网络传输协议，实现客户端与服务器端间的数据安全传递。4. MD5：摘要算法：摘要算法是将一个任意长度的数据变换为一个定长的数据串，这一定长的数据串被称为消息摘要，反向计算出消息本身在技术上是不可行的。 摘要算法的目标是用于证明原文的完整性，也就是说用于防止信息被篡改。通常也被称为：HASH算法、摘要算法、签名算法。它的特点是：从不定长的原文中产生一个固定长度（如MD5 是128 位）的对应结果 。数据发送方在数据发送前，首先用摘要算法对数据计算消息摘要，然后将数据和消息摘要一起发送给接受方。 接受方用相同的摘要算法对数据重新计算消息摘要，通过对二个消息摘要的比较，可以明确地判断出数据在传输过程中是否被篡改。 结果相同表示数据未被修改，而结果不同表明数据被修改或数据被丢失，从而保证数据在传输过程中的完整性。三、 接口规范1. 企业网关使用流程1) 客户在商户网站生成订单；2) 商户网站使用商户密钥对订单数据进行数字签名；3) 商户网站通过表单方式将订单数据及签名数据通过用户浏览器提交到支付网关；4) 支付网关使用商户密钥验证订单数据数字签名的合法性；5) 支付网关将订单数据处理，生成交易。6) 客户与商户之间完成正常的交易流程。7) 交易流程完成或者失败后，使用商户的密钥将结果数据签名并发送回商户指定的地址。8) 商户接收到数据后使用密钥验证数据的合法性。9) 商户验证合法性之后，根据支付结果数据完成余下的业务流程，为客户提供产品或服务。2. 数据提交商户的定单数据需要以POST方式提交到网关接口。生产系统网关地址为：/interface/Professional/paypre.aspx （注意是https）测试系统网关地址为：/interface/Professional/paypre.aspx (注意是http)提交的数据格式如下：(注：提交数据时请使用表单post方法) 参数参数名称类型长度区域说明1OrderType数字4必填网关代码，当前版本为10012CoagentID数字-选填暂时留空3InceptUserName字符串1-100必填收款人账户4PayUserName字符串0-100选填付款人账户5OrderNumber数字1-16必填订单号，当天不可重复的16位以内有效长整型数字6Amount数字1-9必填订单金额，最低为1，支持两为小数7MoneyCode数字4必填货币代码，1001-人民币8TransDateTime时间/选填交易时间，格式参照：2005-04-17 04:11:329TransType数字4选填1001-支付宝、1002-信用宝、1003-电汇宝10PledgeDay数字1-365选填到货保证期限，天为单位，1-365任意数字11TransTypeLock是(1)/否(0)1选填锁定交易类型，锁定后付款用户不可更改12PledgeDayLock是(1)/否(0)1选填锁定到货期限，锁定后付款用户不可更改13Title字符串0-100选填支付标题14Content字符串0-2000选填支付说明15Memo1字符串0-500选填备注116Memo2字符串0-500选填备注217CompleteReturn是(1)/否(0)1必填交易成功后是否返回结果数据给商户指定的地址18FailReturn是(1)/否(0)1必填交易失败后是否返回结果数据给商户指定的地址19ReturnValidate是(1)/否(0)1必填结果数据返回是否要求验证，如果需要验证，将需要确保数据返回地址真实有效，这样程序会验证数据返回是否成功，如果不成功将间隔一定时间重发一次。目前是隔10分钟重发一次，最多重发10次。20ReturnUrl字符串0-500ReturnUrl 和RedirectUrl至少选择一个用来接收反馈结果后台消息反馈的地址（该地址是商户用来接收百付通企业网关该交易的执行结果）21RedirectUrl字符串0-500页面消息反馈地址（该地址用来接收百付通企业网关该交易的执行结果。页面消息返回只发送一次，失败将不再重发。）22SignCode字符串32必填以上数据按从上至下顺序拼接，并且在末尾拼接您在Pay100上申请的密钥，再进行MD5编码，得到该字段。注：1、选填项没有填写时则直接忽略该字段。2、ReturnUrl和RedirectUrl可以同时使用，或者选择一种方式。如果两个字段都没有填写，则百付通无法向商户发送交易结果。商家必须至少选择一种返回方式， 3、结果返回 百付通在定单交易完成后，会自动给定单中指定的地址发送结果信息，如果设置了RedirectUrl，则使用页面POST的方式把结果发送到商户指定的RedirectUrl上，如果设置了ReturnUrl, 也会使用POST的方式把结果发送到商户指定的ReturnUrl上，但这种方式是不可见的（ 以非浏览器的方式进行POST ）。如果同时设置了RedirectUrl和ReturnUrl，结果消息会发送两次，商户在处理时应该注意这种情况。3. 结果返回百付通在定单交易完成后，会自动给定单中指定的地址发送一条结果信息，发送反馈消息也是采用post方式。返回的格式如下：参数名称类型长度说明OrderType数字4网关代码，当前版本为1001InceptUserName字符串1-100收款人账户PayUserName字符串0-100付款人账户OrderNumber数字1-16订单号，当天不可重复的16位以内有效长整型数字StateCode数字4定单结果，1001-成功、1002-失败Amount数字1-9订单金额，最低为1，支持两为小数MoneyCode数字4货币代码，1001-人民币TransDateTime时间/交易时间，格式参照：2005-04-17 04:11:32TransCompleteDateTime时间/交易成功时间，格式参照：2005-04-17 04:11:32TransType数字41001-支付宝、1002-信用宝，1003-电汇宝PledgeDay数字10-365到货保证期限，天为单位，1-365任意数字Memo1字符串0-500提交过去的备注1，原样返回Memo2字符串0-500提交过去的备注2，原样返回SignCode字符串32以上数据按顺序从上至下进行拼接，并且在末尾拼接您在Pay100上申请的密钥，然后进行MD5编码。选填项没有填写时则直接忽略该字段. 四、 测试步骤商户首先登录测试站点：注册一个用户，类型请使用商业用户。测试系统中新注册用户将有10000元帐户余额，这10000元虚拟货币可供测试使用。 注册成功以后登录到中，在左侧的“工具箱”中有“密钥管理”，进入到该模块配置您的商户密钥。商户的接口程序使用这个密钥和测试系统进行交易，当完成了支付与反馈结果接收的流程以后即可转入生产系统.注意：a) 测试系统与生产系统的数据库是不同的，请重新注册用户并配置商户密钥。b) 测试系统地址为http:/ 而生产系统为https:/c) 为了您的测试方便，我们提供了一个测试传至网关参数的地址：/interface/professional/test/ParamsCheck.aspx商户完成接口开发并上线后请放置百付通支付说明页面并添加百付通图标：三种尺寸的图标：/images/mlogo.png/images/mlogo_128.png/images/mlogo_100.png支付说明页面：商户可以直接使用我们制作好的Pay100Intro.htm这个html页下载链接：/pay100intro.htm或者自己制作一个支付说明页面，支付说明的内容如下：付款页面说明文字网上支付本服务通过百付通安全支付平台进行网上支付，目前支持银行：工商银行招商银行农业银行（电子支付卡）建设银行招行上海上海农信交通银行（上海）中信实业银行浦东发展银行光大银行华夏银行广东发展银行深圳发展银行中国发展银行（上海）兴业银行中国民生银行国际贷记卡 (国际信用卡) VISA特别提醒：如果您还没有相关银行网上支付的功能,一般情况下，请先申请，然后才可以进行网上支付（个别银行在某些地区可能已经不需要申请了）。如何申请，可以看相关银行的演示说明或者电话咨询当地银行 网上银行注册开通注：上面的注册开通链接地址为/Service/BankCardRegistration.aspx 这一步，有些初次使用网上支付的用户可能会遇到