腾讯公司财付通WAP支付网关商户开发指南.doc

腾讯公司财付通WAP支付网关商户开发指南 2009-12-21 All copyright reserved T Author: gregzhu 财付通科技有限公司 二〇〇九年十二月二十一日  文档历史 修订日期 修订内容 修订版本 修订人 200-12-21 创建 .0 gregzhu 2010-03-03 1，“4 MD5签名规则”增加描述：只有本文档协议中出现的参数才参与签名。 2，“第四章”增加说明：该接口通过后台调用，可支持https和http两种方式调用。 3，“第五章”增加出错时的返回格式。 4，“第七章”增加参数：charset，bargainor_id和attach 。 2.1 gregzhu  文档描述 1 文档说明 本文件描述财付通针对手机支付行业提供的支付解决方案。供内部相关开发和技术支持人员与商户平台服务方技术人员使用。 2 阅读对象 供财付通开发人员与商户平台服务方技术或业务人员参考和查询。 业务功能描述 1 作业流程简述 其中蓝色直线箭头表示系统调用，黑色直线箭头表示页面跳转。 商户请求交易初始化：商户根据客户的支付行为生成订单，包括商户号、商户订单号、金额、等支付要素。并提交请求进行交易初始化和获取tokenid。 财付通接收到商户的交易初始化请求后，系统创建财付通交易单，同时生成tokenid，并返回该tokenid。 商户请求WAP支付：商户根据tokenid生成WAP支付请求，通过页面跳转方式引导用户进入到财付通手机支付中心。 用户在财付通手机支付中心完成支付后，财付通调用notify_url通知商户交易结果。 商户返回通知结果：根据扣款成功通知，做发货等逻辑处理，并返回财付通处理结果。 财付通确认交易完成并回跳至商户的callback_url。 2 页面回跳callback_url callback_url应为WAP页面，给买家展示支付结果。 3 结果通知notify_url notify_url接收财付通从后台发出的支付结果通知。 在此通知接口模式中，商户需要确保notify_url稳定可靠。该notify_url完成接收财付通发送的支付结果信息，交易结果信息将以GET方式传递至商户。财付通只将支付成功的订单进行返回。 4 MD5签名规则 1）签名规则 先将参数串按照参数名（不包括sign自己）进行升序排序（若有多个相同参数名则继续按照其参数值进行升序排序），并将参数key及其值附加在排序后的参数串末尾，得到待签名字符串。 然后使用标准MD5 算法对字符串进行加密，加密结果全部转换成大写后，即为我们所需的订单MD5 校验码，将其写入sign字段即可。 2）签名注意事项 拼凑值不要有空格 空值参数无需传递，包含到待签名数据中。 签名时将字符转变成字节流时统一使用utf-8。 3）签名示例： sign=md5(attach=tenpaybank_type=0bargainor_id=1900000109cmdno=102dateesc=aabbccfee_type=1purchaser_idp_billno=778899tenpay112233notify_url=/tenpay.asptotal_fee=1transaction_id=1900000109200901011234567890ver=2key=8934e7d15453e97507ef794cf7b0519d) 5 安全控制 1.财付通采用加密和数字签名认证体系 2.通讯使用SSL协议（128位）+WTLS协议，对数据进行加密 3.商户和财付通间数据交互都使用加密，并使用数字签名进行数据验证，确保数据的完整性。  交易初始化请求接口协议 1 接入URL /cgi-bin/wappayv2.0/wappay_init.cgi 说明：该接口通过后台调用，可支持https和http两种方式调用。 2 接入方式 POST/GET方式 3 协议参数 字段名 填写类型 说明 ver 必填 版本号,ver默认值是1.0。目前版本ver取值应为2.0 charset 可选 1 UTF-8, 2 GB2312, 默认为1 UTF-8 bank_type 必填 银行类型:财付通支付填0 desc 必填 商品描述,32个字符以内 purchaser_id 可选 用户(买方)的财付通帐户(QQ 或EMAIL)。若商户没有传该参数，则在财付通支付页面，买家需要输入其财付通帐户。 bargainor_id 必填 商户号,由财付通统一分配的10位正整数(120XXXXXXX)号 sp_billno 必填 商户系统内部的定单号,32个