财付通WAP支付网关商户开发指引-立付通.DOCVIP

立付通API接口文档 文档版本：1.0.1 接口版本：1.0  目录 1 引言 4 1.1 文档概述 4 1.2 阅读对象 4 1.3 业务术语 4 2 方案概述 5 2.1 行业背景 5 2.2 业务实现流程 6 2.2.1 支付业务 6 3 数据格式 7 3.1 提交数据 7 3.2 XML数据格式 7 4 数字签名 10 4.1 签名原始串 10 4.2 签名算法 10 5 补单机制 12 6 支付接口 13 6.1 初始化请求接口 13 6.1.1 业务功能 13 6.1.2 交互模式 13 6.1.3 请求参数列表 13 6.1.4 返回结果 15 6.2 原生态 js 支付接口 16 6.2.1 使用示例 16 6.2.2 交互模式 16 6.2.3 请求参数列表 16 6.2.4 获取当前微信版本号 17 6.3 JS 支付通知接口 18 6.4.1 通知结果参数列表 18 6.4.2 后台通知结果反馈 19 7 查询接口 20 7.1 订单查询接口 20 7.1.1 业务功能 20 7.1.2 交互模式 20 7.1.3 请求参数列表 20 7.1.4 返回结果 21 8 注意事项 23 9 wa p跳转微信公 众 号 支 付 24 9.1 请求参数列表 24 9.2 返回结果 26 9.3 提交步骤小结 26  1 引言 1.1 文档概述 本文件描述立付通针对线上 O2O 手机支付行业提供的支付解决方案。供内部相关开发和技术支持人员与商户平台服务方技术人员使用。文档分别从交互模式、签名、接口、注意事项等方面详细介绍了立付通支付的工作方式和开发过程，帮助开发人员快速入门并掌握开发技能，同时也可以作为日后接口参数以及参数类型的速查手册。 1.2 阅读对象 供商户开发人员与商户平台服务方技术或业务人员参考和查询。 1.3 业务术语 术语 值 说明 测试商户 号  商 户 调 用 接 口 时 可 用 此 测 试 商 户 号 对 应 参 数 mch_id 测试密钥 为保证通讯不被篡改，立付通系统与商户之间约定的 32位或 24 位字符串，算签名 sign 时使用 微信测试商户号 微信商户号、appid、appsecret为获取用户openid，当然商户也可以使用自己的微信商户信息获取，但需通过立付通进件 微信appid ? 微信appsecret 金额 1000 金 额 ， 默 认为 RMB ， 以 分 为 单位 。 1000 表 示 RMB10.00 2 方案概述 2.1 行业背景 Wap跳转微信支付，是基于浏览器跳转微信客户端提供的支付服务功能。同时向商户提供销售经营分析、 账 户和资金管理的功能支持。 用户通过浏览器调起微信支付模块完成支付。 2.2 业务实现流程 2.2.1 支付业务 3 数据格式 3.1 提交数据 采用 HTTP 标准的 POST 协议，为了保证接收方接收数据正确,传输数据必须签名。 3.2 XML数据格式 采用标准 XML 协议，所有参数只存在一级节点中，不采用多级节点嵌套。 一般有返回有 status 参数，0 表示调用成功；非 0 表示调用失败。 4 数字签名 为了保证数据传输过程中的数据真实性和完整性，我们需要对数据进行数字签名，在接收签名数据之后进 行签名校验。 数字签名有两个步骤，先按一定规则拼接要签名的原始串，再选择具体的算法和密钥计算出签名结果。 一般失败的结果不签名。 4.1 签名原始串 无论是请求还是应答，签名原始串按以下方式组装成字符串： 1 、 除 sign 字 段外 ， 所 有参 数按 照字 段 名的 ascii 码 从 小到 大 排 序 后 使用 QueryString 的 格式 （ 即 key1=value1key2=value2…）拼接而成，空值不传递，不参与签名组串。 2、签名原始串中，字段名和字段值都采用原始值，不进行 URL Encode。 3、立付通系统返回的应答或通知消息可能会由于升级增加参数，请验证应答签名时注意允许这种情况。 举例： 调用某个接口，接口有如下字段： 正确的签名字段排序为： 4.2 签名算法 目前暂只支持 MD5 签名 MD5 签名 MD5 是一种摘要生成算法，通过在签名原始串后加上商户通信密钥的内容，进行 MD5 运算，形成的摘要字符串即为签名结果。为了方便比较，签名结果统一转换为大写字符。 注意：签名时将字符串转化成字节流时指定的编码字符集应与参数 charset 一致。 MD5 签名计算公式： sign = Md5(原字符串key=商户密钥). toUpperCase 如： 假设以下