财付通中介支付开发指南

《财付通中介支付开发指南》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、腾讯公司财付通中介支付开发指南Version:2.0Publicdate:2008-09-25AllcopyrightreservedTenpay.com第一章文档描述1文档说明本操作手册用来指导财付通用户实现与电子商务支付网关系统的顺利对接。请相关技术人员详细阅读本手册。文中黑粗的内容表示要重点注意的内容。2版本接口基于HTTP协议实现，各种平台，只要支持HTTP协议，各种语言均可实现。开发包中只给出了asp,php,jsp,c#四种常用语言的demo。其他语言请参照协议自行编写。3阅读对象商

2、户开发人员腾讯科技(深圳)有限公司财付通支付网关相关技术人员4接口联系人职责业务支持姓名田昕晨电话0755-86013388-84564Emailorangetian@tencent.comQQ88881486职责技术支持姓名朱磊电话0755-86013388-88285Emaildavidzhu@tencent.comQQ88881535职责技术支持姓名许小强电话0755-86013388-82208Emailxiaoqiangxu@tencent.comQQ88881535第一章业务功能描述

3、1作业流程简述1)商户根据客户的支付行为生成订单，包括商户号、订单号、金额、等支付要素，并提交付款请求。2)用户支付成功，财付通将后台调用方式将支付结果实时返回商户系统mch_returl。3)商户接收到支付成功请求后，输出反馈信息给财付通，并完成相关业务逻辑。4)财付通接收到商户返回的成功信息，再将用户引导回商户网站show_url。1接口通知流程1)返回结果在此通知接口模式中，商户需要确保mch_returl稳定可靠。该mch_returl完成接收财付通发送的支付结果信息，交易结果信息将以G

4、ET方式传递至商户。财付通只将支付成功的订单进行返回。在传送给商户的参数中，包含使用双方约定的MD5密钥签名的sign参数，商户应该先验证该数字签名，确认该通知信息的合法性。然后完成相关业务逻辑。1)输出反馈财付通要求商户系统mch_returl输出以下代码：财付通不允许在mch_returl中发生任何跳转，并要求商户系统第一时间输出

5、_PAYMENT"content="ChinaTENCENT">此为财付通系统判断是否成功返回支付结果的唯一凭证。2)用户返回财付通接收到以上反馈信息后，将引导用户返回show_urll进行浏览1安全控制1．财付通采用加密和数字签名认证体系2．通讯使用SSL协议（128位），对数据进行加密3．商户和财付通间数据交互都使用加密，并使用数字签名进行数据验证，确保数据的完整性第二章支付请求接口协议1接入URLhttp://service.tenpay.com/cgi-bin/v3.0/payservi

6、ce.cgi2接入方式POST/GET方式3协议参数目的URLhttps://www.tenpay.com/cgi-bin/med/show_opentrans.cgi字段名必填类型长度说明version是整数[1,4]版本号，取值如下：1：先前版本。2：本次更新的版本。对于旧版本，不此字段，对于新版本，此字段必填。cmdno是整数[1,4]任务代码，取定值：12encode_type是整数[1,2]1：GB2312编码，默认为GB2312编码。2：UTF-8编码。chnid是字符串[1,65]

7、平台提供者的财付通账号,与seller一致seller是字符串[1,65]收款方财付通账号，与chnid一致mch_name是字符串[1,32]商品名称，不能包含<>’”%特殊字符mch_price是整数[1,10]商品总价，单位为分。transport_desc是字符串[32]物流公司或物流方式说明transport_fee是整数[1,10]需买方另支付的物流费用。如已包含在商品价格中，请填写0。如果不填，默认为0。单位为分mch_desc是字符串[1,64]交易说明，不能包含<>’”%特殊字

8、符need_buyerinfo是整数[0,1]是否需要在财付通填定物流信息，1：需要，2：不需要。mch_type是整数[1,1]交易类型：1、实物交易，2、虚拟交易。mch_vno是整数[12]商家的定单号mch_returl是字符串[1,255]回调通知URL,如果cmdno为12且此字段填写有效回调链接,财付通将把交易相关信息通知给此URLshow_url是字符串[1,255]支付后的商户支付结果展示页面。attach是字符串[1,200]该参数财付通不做处理。回调时原样返回。为商户可能的