腾讯财付通接口的开发.doc

财付通支付网关商户开发指南  目 录 1 引言 4 1.1 文档概述 4 1.2 阅读对象 4 1.3 业务术语 4 2 方案概述 4 2.1 行业背景 4 2.2 接口介绍 5 2.3 业务实现流程 6 3 交互模式 6 3.1 页面跳转交互模式 6 3.2 后台系统调用交互模式 7 3.3 后台通知交互模式 8 4 数据格式 8 4.1 GET或POST 8 4.2 XML数据格式 9 4.3 字符串格式 9 5 数字签名 9 5.1 签名原始串 10 5.2 签名算法 10 5.2.1 MD5签名 10 6 补单机制 10 7 接口 11 7.1 支付接口 11 7.1.1 业务功能 11 7.1.2 交互模式 11 7.1.3 请求参数列表 11 7.1.4 返回结果和通知参数列表 13 7.1.5 后台通知结果反馈 14 7.2 通知查询接口 15 7.2.1 业务功能 15 7.2.2 交互模式 15 7.2.3 请求参数列表 15 7.2.4 应答参数列表 16 7.3 订单查询接口 17 7.3.1 业务功能 17 7.3.2 交互模式 17 7.3.3 请求参数列表 17 7.3.4 应答参数列表 18 7.4退款接口 20 7.4.1业务功能 20 7.4.2交互模式 20 7.4.3请求参数列表 20 7.4.4 应答参数列表 21 7.5退款明细查询接口 23 7.5.1业务功能 23 7.5.2交互模式 23 7.5.3请求参数列表 23 7.5.4应答参数列表 24 8 实例 26 9 注意事项 28 引言 文档概述 本文描述了财付通针对合作商户提供的支付解决方案，帮助商户轻松实现在线收款的功能。文档分别从交互模式、签名、接口、注意事项等方面详细介绍了财付通的工作方式和开发过程，可以帮助开发人员快速入门并掌握开发技能，同时也可以作为日后接口参数以及参数类型的速查手册。 阅读对象 合作商户系统的技术开发人员，要求具有WEB程序开发背景，了解http和https请求和应答的格式和过程，对XML格式有所掌握。 业务术语 术语 示例 说明 商户号 1900000107 机票平台的账号，只用于记账，由财付通自动分配的10位数字 密钥 9ba2380ad9b2aacb96bca514eda27ac9 为保证通讯不被篡改，财付通与商户之间约定的32位字符串，算签名sign时使用 账户 jpgyf@ 财付通账户号，目前支持两种格式：qq号码和email账户 金额 100000 金额，默认为RMB，以分为单位。1000表示RMB10.00 方案概述 行业背景 在电子商务中，商家、买家、中间服务方是交易活动中的三个环节。买家选购商品下发订单，商家确认订单，买家通过中间服务方向商家支付货款，商家发货履行订单。在这个过程中商家的网站需要集成中间服务方的支付功能，让买家完成货款的支付。财付通作为一家专业的中间服务方除了提供支付接口外，还提供了支付结果查询接口和订单查询接口等，帮助商家记录货款的往来，让商家能把更多的精力集中到商品服务上。 商户的货款会按照合同约定以T0～T7的频率结算到商户的银行账户，同时收取手续费。这个过程由财付通自动完成，商户无需做相关开发工作。 接口介绍 接口名 请求URL 功能说明 结果说明 支付接口 /gateway/pay.htm 调用该接口时指定支付参数，完成买家账户向商家账户的支付，采用页面跳转交互模式和后台通知交互模式 结果分两路返回：一路为前台在return_url后添加参数返回，表现为页面跳转；一路为后台在notify_url后添加参数返回，要求后台notify_url收到通知后进行响应。 通知查询接口 /gateway/verifynotifyid.xml 商户在收到后台通知后根据通知ID向财付通发起通知内容的查询，采用后台系统调用交互模式 财付通把具体的通知内容按XML格式实时返回 订单查询接口 /gateway/normalorderquery.xml 商户在后台对任意一笔订单发起查询，采用后台系统调用交互模式 根据订单号以XML格式返回具体的订单内容和状态 退款接口 /refundapi/gateway/refund.xml 商户在后台对一笔已支付订单发起退款，采用后台系统调用交互模式 退款成功、失败或者退款流程中的结果实时返回 退款明细查询接口 /gateway/normalrefundquery.xml 根据退款ID查询具体的退款明细 退款明细数据实时返回 业务实现流程 2.0调用支付接口进行支付后，财付通返回支付结果给前台页面，同时会向商户的服务器发送支付是否成功的通知 3.0商户服务器在收到支付结果通知后可以根据通知ID查询通知内容，在确保