网上支付的基本进程.doc

网网网 上上上 支支支 付付付 接接接 口口口 1 01 01 0 期 期 期 商户接口说明商户接口说明商户接口说明商户接口说明商户接口说明商户接口说明 版本 版本版本 1 051 051 05 北京珠峰伟业软件科技发展有限公司 北京珠峰伟业软件科技发展有限公司北京珠峰伟业软件科技发展有限公司 2002 20022002 年年 年 10 1010 月月月 181818 日日日 文档修改记录文档修改记录文档修改记录 版本日期说明编写者审核者 1 00 修改 1 0 期文档 1 012002 10 10 增加接收返回结果 1 022002 10 18 增加客户接收密码 1 032002 10 30 错误代码 1 042002 11 05 解决部分商户不支持中文 Mac 加密算法问题 1 052002 12 03 增加支持英文平台 1 062002 12 13 测试账号说明 1 072002 12 26 增加 vbscript 的 md5 加密算 法 1 072002 01 06 增加 php 程序的例子 说明 本文档中所包含的信息属于机密信息 如无 书面许可 任何人都无权复 制或利用 Copy right 2002 by Beijing Co Ltd 在例子中的所有的店铺号和密码均为测试账号 只用于商户进行测在例子中的所有的店铺号和密码均为测试账号 只用于商户进行测 在例子中的所有的店铺号和密码均为测试账号 只用于商户进行测在例子中的所有的店铺号和密码均为测试账号 只用于商户进行测在例子中的所有的店铺号和密码均为测试账号 只用于商户进行测在例子中的所有的店铺号和密码均为测试账号 只用于商户进行测 试 商户在自己程序正式上线前 请使用自己的店铺号及支付密码 试 商户在自己程序正式上线前 请使用自己的店铺号及支付密码 试 商户在自己程序正式上线前 请使用自己的店铺号及支付密码 试 商户在自己程序正式上线前 请使用自己的店铺号及支付密码 试 商户在自己程序正式上线前 请使用自己的店铺号及支付密码 试 商户在自己程序正式上线前 请使用自己的店铺号及支付密码 如果因为使用测试账号所引起的商务纠纷如果因为使用测试账号所引起的商务纠纷 如果因为使用测试账号所引起的商务纠纷如果因为使用测试账号所引起的商务纠纷如果因为使用测试账号所引起的商务纠纷如果因为使用测试账号所引起的商务纠纷 668866886688 网站概不负责 网站概不负责 网站概不负责 网站概不负责 网站概不负责 网站概不负责 目录 1 网上支付使用条件网上支付使用条件 1 1 1客户进行网上支付的条件 1 2 网上支付流程网上支付流程 2 2 1网上支付业务流程图 2 2 2商户的货款结算与对帐流程 3 3 客户客户 网关接口参数 中文 网关接口参数 中文 4 4 MAC 算法说明算法说明 对于商户端支持对于商户端支持 MD5 组件注册方式 请看以下说明组件注册方式 请看以下说明 6 5 具体用法见附件 具体用法见附件 7 6 MAC 算法说明算法说明 对于商户端不支持对于商户端不支持 MD5 组件注册方式 请看以下说明组件注册方式 请看以下说明 8 7 MAC 算法原理算法原理 10 8 支付网关支付网关 商户接口参数商户接口参数 12 9 英文支付网关英文支付网关 13 1 1 1 网上支付网上支付网上支付使用条件使用条件使用条件 1 1客户进行网上支付的条件 1 与 6688 签约的客户 客户已在 6688 签约 申请网上支付服务 客户签约的帐户 信用卡或储蓄卡帐户 可用于网上支付 2 2 2 网上支付流程网上支付流程网上支付流程 2 1网上支付业务流程图 网上支付业务流程步骤说明 1 客户登录商户网站 选择商品 2 商户网站通过 6688 资格验证 查询商户方支持的网上支付方式 3 商户网站给客户提供可选择的银行支付方式 由客户自行选择 4 客户选择商品及要进行支付的银行后 产生预定单信息 5 信息经过加密传到支付网关平台 商户提供商户代码 订单号 合计金额及订单备注等信息 此 四个信息必须提供 除此之外 商户方还必须将商户代码 订单号 合计金额及订单备注四个信息 利用 MAC 组件进行加密产生 MD5 校验码 最好以 post 方法传递到支付网关平台用以保证定单信息 的正确性 其中 订单备注信息可为各种其他订单信息拼成的一个字串 例如 订货人 id 收货人 地址等 商家网站将此信息传递给 6688 网站 6688 网站将保存这些订单信息 以便于今后的信息核 对 6 支付网关平台接收客户支付信息 转发到银行后台业务处理系统 7 银行后台会将支付成功与否的信息传送给支付网关平台 8 支付网关平台会根据商户提交过来的 URL 调用商户接收支付结果的页面 9 商户将用户的支付结果显示给用户 商户网关 guan 关 客户 银行后台 1 34 5 6 2 7 8 9 2 2商户的货款结算与对帐流程 1 客户在商户网站选择商品并下单 通过 6688 支付网关付款给银行后 商户记录相关客户信息 货 款记入 6688 在银行的专用结算帐户 含定单号信 息 中 由 6688 与商户按合同约定进行款项结 算 2 6688 负责到银行处查询该客户该笔订单付款信息 如果付款完成 由 6688 通知商户进行配货 网 上交易完成 商户通过 6688 提供的订单查询系统查询本商户的订单详细处理情况 并及时处理 并发货 3 3 3 客户客户客户 网关接口参数网关接口参数网关接口参数 中文 中文 中文 客户在商户网站选择商品后 商户网站生成以下信息 传送到网站 域名名称类型 长度备注 tmbrid 商家在 6688 的会员 号 CHAR 8 由 6688 提供 必填项目 toname 定货人姓名 CHAR 50 客户方订购人员姓名 可为空 tsummoney 订单总额 NUMBER 8 2 总金额 由商户提供 按实际 金额给出 必填项目 tContent1 定单内容 CHAR 500 商家可以将支付的订单商品信 息拼成一个字串 传到 6688 网 关 便于今后的信息核对和查询 必填项目 trphone 收货人电话 CHAR 20 可为空 trzipcode 收货人邮政编码 CHAR 20 可为空 trname 收货人姓名CHAR 50 可为空 traddress 收货人地址 CHAR 16 可为空 tremail 收货人 email CHAR 32 可为空 tuserurl 接收支付结果的 url CHAR 32 可为空 todrid 订单号 CHAR 6 商家网站方形成的订单号 传递 给 6688 网站 以便于今后的订 单查询和核对 必填项目 tSupperComRegflag 商户端是否能够支持 Md5 加密组件注册标 志 int 商户网站是否能够注册 Md5 加 密组件 解决一些商户由于是 租用 ISP 的服务器空间 不能 够注册组件的一个参数 默认为空或者 0 表示商户支持 MD5 组件注册 否则为 1 表示 不支持 必填项目 Mac MAC 校验域 CHAR 32 必填项目 采用标准 MD5 算法 由商户实 现 具体算法如下 注 1 备注栏目中有必填项目字样的是商家必须提供的 2 商户要保证定单号的唯一性 站点间接口的参数传送采用 post 方式 商户将以上信息包含在 FORM 中 在 SUBMIT 后将生成 URL 如下所示 tuserurltuserurltuserurl 参数是参数是参数是 668866886688 网站提供给商家银行支付结果信息的地址 商户在取得支付结果后网站提供给商家银行支付结果信息的地址 商户在取得支付结果后网站提供给商家银行支付结果信息的地址 商户在取得支付结果后 希望用户进入商户网站的某个页面的希望用户进入商户网站的某个页面的希望用户进入商户网站的某个页面的 URLURLURL 商户的接收程序可以根据支付是否成功而指定 商户的接收程序可以根据支付是否成功而指定 商户的接收程序可以根据支付是否成功而指定 不同的不同的不同的 URLURLURL 或者带不同的参数 商户可以根据参数的不同决定显示什么信息 如果成功 或者带不同的参数 商户可以根据参数的不同决定显示什么信息 如果成功 或者带不同的参数 商户可以根据参数的不同决定显示什么信息 如果成功 支付的情况 还可以根据参数的不同决定向用户提供什么服务 支付网关将传回支付的情况 还可以根据参数的不同决定向用户提供什么服务 支付网关将传回支付的情况 还可以根据参数的不同决定向用户提供什么服务 支付网关将传回 4 4 4 个参数 个参数 个参数 billNobillNobillNo amountamountamount succsuccsucc macmacmac 参数的具体意义详见 参数的具体意义详见 参数的具体意义详见 5 5 5 支付网关 支付网关 支付网关 商户接口参数 商户接口参数 商户接口参数 4 4 4 MACMACMAC 算法说明算法说明算法说明 对于商户端支持对于商户端支持对于商户端支持 MD5MD5MD5 组件注册方式 请看以下说明组件注册方式 请看以下说明组件注册方式 请看以下说明 参与 MAC 运算的字符及其顺序如下 mac dd string tmbrid cstr tmbrid byte tb char high tmp low String result new String len bySourceByte length for i 0 i 4 if tmp 10 high char a tmp 10 else high char 0 tmp result high tmp char tb if tmp 10 low char a tmp 10 else low char 0 tmp result low return result 在实施时若遇到具体问题 可由双方协商解决 4 附件 frame html 是 6688 网站成功接收商家信息后供用户选择支付方式的界面 5 其中 md5 子目录是关于 MAC 加密算法的不同语言版本 商家可根据自己的平台加入选择不同的算法 Md5java md5 for java 语言 的源程序算法 md5cpp md5 for C 语言 的源程序算法 md5c md5 for C 语言 的源程序算法 Md5js md5 for javascript 语言 的源程序算法和相关用法附件 包含 md5 inc 和 md5 js 建议不能安装 组件的商户使用 Md5perl md5 for perl 语言 的源程序算法 6 错误代码 1 7003 两边的加密密码不匹配 校验失败 2 如果有其它错误 系统会及时提示 8 8 8 支付网关支付网关支付网关 商户接口参数商户接口参数商户接口参数 在支付结束后 支付网关将支付是否成功与否的结果按商户传来的 URL 将支付结果返回 域名名称类型 长度备注 billNo订单号CHAR 6 商家网站方形成的订单号 amount订单总额NUMBER 8 2 订单金额 succ支付结果CHAR 1 Y 支付成功 N 支付失败 MacMAC 校验域CHAR 32 采用标准 MD5 算法 具体算法 如下说明 注 1 mac dd string billNo billNovalue amount amountvalue succ succvalue pwd pwdvalue 2 如果商户 支付网关的时候就没有传参数 tuserurl 支付网关就不会将支付结果传给商户 3 pwdvalue 如果为我们的支付网关的店铺 我们会在开店之后 发一封 email 在 email 中 我们 会告诵您的支付密码 该密码为此项的值 发送和接受的详细例子程序 详见 发送和接受的详细例子程序 详见 发送和接受的详细例子程序 详见 发送和接受的详细例子程序 详见 发送和接受的详细例子程序 详见 发送和接受的详细例子程序 详见 INFOPAGE ASP INFOPAGE ASPINFOPAGE ASP 用户的订单信息用户的订单信息用户的订单信息 SEND ASP SEND ASPSEND ASP 将用户的订单信息发送给支付网关的例子程序 对于商户端支持 将用户的订单信息发送给支付网关的例子程序 对于商户端支持 将用户的订单信息发送给支付网关的例子程序 对于商户端支持 将用户的订单信息发送给支付网关的例子程序 对于商户端支持 将用户的订单信息发送给支付网关的例子程序 对于商户端支持 将用户的订单信息发送给支付网关的例子程序 对于商户端支持 MD5MD5MD5 组件注册的方式 组件注册的方式 组件注册的方式 组件注册的方式 组件注册的方式 组件注册的方式 P ASP P ASPP ASP 将用户的订单信息发送给支付网关的例子程序 对于商户端不支持 将用户的订单信息发送给支付网关的例子程序 对于商户端不支持 将用户的订单信息发送给支付网关的例子程序 对于商户端不支持 将用户的订单信息发送给支付网关的例子程序 对于商户端不支持 将用户的订单信息发送给支付网关的例子程序 对于商户端不支持 将用户的订单信息发送给支付网关的例子程序 对于商户端不支持 MD5MD5MD5 组件注册的方式 组件注册的方式 组件注册的方式组件注册的方式组件注册的方式组件注册的方式 JSCRIPT JSCRIPTJSCRIPT PVB ASP PVB ASPPVB ASP 将用户的订单信息发送给支付网关的例子程序 对于商户端不支持 将用户的订单信息发送给支付网关的例子程序 对于商户端不支持 将用户的订单信息发送给支付网关的例子程序 对于商户端不支持 将用户的订单信息发送给支付网关的例子程序 对于商户端不支持 将用户的订单信息发送给支付网关的例子程序 对于商户端不支持 将用户的订单信息发送给支付网关的例子程序 对于商户端不支持 MD5MD5MD5 组件注册的方式 组件注册的方式 组件注册的方式组件注册的方式组件注册的方式组件注册的方式 VBSCRIPT VBSCRIPT VBSCRIPT GETRESULT ASP GETRESULT ASPGETRESULT ASP 从支付网关接收支付结果的例子程序 从支付网关接收支付结果的例子程序 从支付网关接收支付结果的例子程序 从支付网关接收支付结果的例子程序 从支付网关接收支付结果的例子程序 从支付网关接收支付结果的例子程序 PPHP PHP PPHP PHPPPHP PHP PHPPHPPHP 程序连接支付网关的例子 程序连接支付网关的例子 程序连接支付网关的例子 程序连接支付网关的例子 程序连接支付网关的例子 程序连接支付网关的例子 流程例子 流程例子 流程例子 流程例子 流程例子 流程例子 HTTP WWW 6688 COM PAYGATESAMPLE INFOPAGE ASPHTTP WWW 6688 COM PAYGATESAMPLE INFOPAGE ASPHTTP WWW 6688 COM PAYGATESAMPLE INFOPAGE ASP 流程例子 流程例子 流程例子 流程例子 流程例子 流程例子 HTTP WWW 6688 COM PAYGATESAMPLE P ASPHTTP WWW 6688 COM PAYGATESAMPLE P ASPHTTP WWW 6688 COM PAYGATESAMPLE P ASP 流程例子 流程例子 流程例子 流程例子 流程例子 流程例子 HTTP WWW 6688 COM PAYGATESAMPLE PVB ASP