6接口-财付通企业版.doc

财付通H5支付网关商户开发指南  目 录 1 引言 3 1.1 版本 3 1.2 文档概述 4 1.3 阅读对象 4 1.4 业务术语 4 2 方案概述 4 2.1 行业背景 4 2.2 接口介绍 5 2.3 业务实现流程 5 2.4 页面回跳callback_url 6 2.5 结果通知notify_url 6 3 数据格式 6 3.1 GET或POST 6 3.2 XML数据格式 6 3.3 字符串格式 7 4 数字签名 7 4.1 签名原始串 7 4.2 签名算法 8 5 补单机制 9 6 接口 9 6.1 初始化请求接口 9 6.1.1 业务功能 9 6.1.2 交互模式 9 6.1.3 请求参数列表 9 6.1.4 返回结果和通知参数列表 11 6.1.5 接口调用注意事项（重要） 11 6.2 Wap支付接口 11 6.2.1 业务功能 11 6.2.2 交互模式 11 6.2.3 请求参数列表 12 6.2.4 返回结果参数列表 12 6.2.5 通知结果参数列表 13 6.2.6 后台通知结果反馈 14 6.2.7 接口调用注意事项（重要） 14 6.3 订单查询接口 14 6.3.1 业务功能 14 6.3.2 交互模式 14 6.3.3 请求参数列表 14 6.3.4 应答参数列表 15 6.3.5 接口调用注意事项（重要） 17 6.4 退款接口 17 6.4.1 业务功能 17 6.4.2 交互模式 18 6.4.3 请求参数列表 18 6.4.4 应答参数列表 19 6.4.5 接口调用注意事项（重要） 20 6.5 对账单下载接口 20 6.5.1业务功能 20 6.5.2交互模式 21 6.5.3请求参数列表 21 6.5.4应答参数列表 21 6.5.5接口调用注意事项（重要） 22 6.6 退款明细查询接口 23 6.6.1 业务功能 23 6.6.2 交互模式 23 6.6.3 请求参数列表 23 6.6.4 应答参数列表 24 6.6.5 接口调用注意事项（重要） 25 7 银行编码 25 8 注意事项 28 引言 版本 修订日期 修订内容 版本 修订人 1.1 weiminlin 文档概述 本文件描述财付通针对手机支付行业提供的支付解决方案。供内部相关开发和技术支持人员与商户平台服务方技术人员使用。文档分别从交互模式、签名、接口、注意事项等方面详细介绍了财付通的工作方式和开发过程，可以帮助开发人员快速入门并掌握开发技能，同时也可以作为日后接口参数以及参数类型的速查手册。 阅读对象 供财付通开发人员与商户平台服务方技术或业务人员参考和查询。 业务术语 术语 示例 说明 商户号 1900000109 1900000109为测试商户号，正式商户号会由财付通系统发邮件到贵司绑定的邮箱中，由财付通自动分配的10位数字 密钥 9ba2380ad9b2aacb96bca514eda27ac9 为保证通讯不被篡改，财付通与商户之间约定的32位字符串，算签名sign时使用 账户 jpgyf@ 财付通账户号，目前支持两种格式：qq号码和email账户 金额 100000 金额，默认为RMB，以分为单位。1000表示RMB10.00 方案概述 行业背景 在电子商务中，商家、买家、中间服务方是交易活动中的三个环节。买家选购商品下发订单，商家确认订单，买家通过中间服务方向商家支付货款，商家发货履行订单。在这个过程中商家的网站需要集成中间服务方的支付功能，让买家完成货款的支付。财付通作为一家专业的中间服务方除了提供支付接口外，还提供了支付结果查询接口和订单查询接口等，帮助商家记录货款的往来，让商家能把更多的精力集中到商品服务上。 商户的货款会按照合同约定以T0～T7的频率结算到商户的银行账户，同时收取手续费。这个过程由财付通自动完成，商户无需做相关开发工作。 接口介绍 接口名 请求URL 功能说明 结果说明 初始化接口 /app/mpay/wappay_init.cgi 调用该接口时指定支付参数，完成买家账户向商家账户的支付，采用页面跳转交互模式和后台通知交互模式 初始化wap请求，通过生成token_id来进行交互验证。 支付接口 /app/mpay/mp_gate.cgi 调用该接口时指定支付参数，完成买家账户向商家账户的支付，采用页面跳转交互模式和后台通知交互模式 结果分两路返回：一路为前台在callback_url后添加参数返回，表现为页面跳转；一路为后台在notify_url后添加参数返回，要求后台notify_url收到通知后进行响应。 订单查询接口 /gateway/normalorderquery.xml 商户在后