小火科技APP/小程序/H5支付选型指南 微信、支付宝、汇付接入方案

支付接口是软件系统资金交易链条中的重要部分。比如小程序、原生APP和H5网页三种运行环境之间存在着本质的区别，因此它们所对应的微信、支付宝和第三方持牌支付机构的接口能力、接入条件、调用逻辑、限制规则各不相同。在开发的过程中要分清业务场景选择的问题，并且要做好签名校验、回调验证、幂等处理、异常补偿和财务对账等一系列的安全措施来避免重复扣款、订单状态实时同步、实时备份、数据迁移等问题来保证系统的稳定运行。

成都小火科技有限公司有13年的软件定制开发经验，并且获得了CMMI3级认证、国家级高新技术企业认定以及ISO27001信息安全管理体系等多张证书，在大量的小程序、APP、在H5定制项目的实施过程中，会涉及到多个渠道支付模块的应用，比如小火物业缴费安心付管理系统、城市代驾出行APP、加油站服务配套小程序、AI海外二手车交易平台、海外充电桩管理系统等。

成都小火科技公司软件支付界面截图

可以实现多个端口的支付接口对接、包括海外支付系统对接、分账对账系统、钱包充值、佣金提现整个交易系统开发；严格按照信息安全管理规定来保证交易数据的安全，并且完整的把支付相关的源代码、接口文档和测试用例都交给甲方，支持以后支付渠道的更新换代；售后支持紧急问题在1分钟之内得到回应，一般的故障会在10分钟之内响应。

一、微信体系各端支付方式详解

1. 小程序支付（wx.requestPayment）

运行环境：只有微信小程序原生环境，并且不能使用web-view内嵌H5页面来调用此接口。

前置条件

1、当微信小程序ID完成微信认证之后，商户号和ID之间的关系就建立起来了；

2、在微信支付商户平台上开通小程序支付产品权限；

3、后端调用统一下单接口生成prepay_id预支付订单；

4. 后端根据规则生成时间戳、随机串、package、签名，并返回给前端，然后前端会调用wx.requestPayment来唤出支付弹窗。

业务流程如下：用户下单——前端向后端发起请求——后端调用微信统一下单并获取预支付ID——后端把支付签名参数组装起来之后返回给小程序——小程序召唤出微信支付组件——用户确认付款——微信异步回调商户服务端发送支付结果给后端服务器进行校验、订单状态更新以及业务逻辑处理；前端同时进行轮询查询订单的状态，并且作为回调的兜底补偿。

特点

用户体验好，不需要跳出小程序去访问其他页面，在小程序里面就可以完成支付；

下单入参中需要获取小程序用户的openid；

退款、订单查询接口可以和APP、H5共享，只有下单以及前端调用接口会有区别。

小火科技公司落地案例：加油站自助服务小程序，对接小程序微信支付和支付宝小程序支付，实现账户充值、油品消费、优惠券核销业务；解决多渠道接口参数不一致、网络抖动造成的订单状态同步异常的问题，并且完成了兼容性、安全性以及压力等多方面的测试工作之后，就将把完整的源代码和项目的文档一起交付给客户，并且还会帮助客户进行小程序备案的相关配套工作。

2. APP支付（原生/跨平台APP支付）

运行环境：iOS/Android原生APP，使用Flutter或者uni-app进行打包之后也可以运行。

前置条件

1. 微信开放平台创建移动应用，提交应用包名、应用签名以及完成审核；

2、移动应用与微信支付商户号绑定，并开通APP支付功能；

3.App中使用了微信官方提供的SDK，在后端统一处理订单并获取到prepay_id，然后把参数发给客户端SDK去调用微信客户端来完成支付。

业务流程为：APP发出订单请求，服务器统一下发订单并获得预支付ID，然后返回签名参数；SDK引导用户到微信APP中进行支付，在用户完成支付之后再返回到业务APP上；微信服务端异步回调业务服务器通知交易结果。

特点

交互顺畅，直接唤醒独立的微信客户端；

不依靠网页环境，在中大业务系统的使用上比较合适；

需要解决的是iOS和Android两个平台SDK之间的差异，在把应用程序上架到商店的时候要进行合规申报支付相关的权限。

小火科技公司落地案例：城市代驾出行APP，双端原生接入APP微信支付、支付宝SDK，扩展余额、线下现金等多种支付方式；包括订单支付、用户充值、打赏、司机押金缴纳、资金提现等各个环节，并且可以做到对每一个订单进行补偿，在对账报表模块中也可以设置违约金和服务费的计算方式以及业务规则。

3. H5支付

概念区分：①H5支付（MWEB）：适用于非微信内置浏览器（手机系统的浏览器或者APP内的webview）；②JSAPI公众号支付：指使用微信内置浏览器打开H5页面，并且需要依赖公众号openID，不算是H5支付产品。

运行环境：手机浏览器或者APP内部使用webview（不是微信环境）。

前置条件

1、商户平台开通H5支付功能；

2、配置授权域名，该域名要完成ICP备案，并且备案主体与商户主体一致；

3.webview场景开发时要自己设置请求头Referer，不然就会出现场景非法的情况。

业务流程：后端统一下订单接口返回mweb_url支付跳转链接；前端出现302重定向到微信中间支付页面的情况；用户完成支付之后会跳转到业务配置中设置好的回调页面上；业务服务器会接收到微信异步回调更新订单的消息。

特点

用户会跳出业务页面跳转到微信中，体验不如小程序或者原生APP；

重要的限制是小程序web-view组件内部不能用H5支付，这是高频开发踩到的一个坑点；

不需要依靠APP安装包、小程序，一套网页可以适应多种终端；

跳转链路多，网络异常容易出现回调丢失的情况，所以业务层要增加订单轮询查询作为兜底措施。

二、支付宝体系各端支付方式

1、支付宝小程序支付：运行在支付宝小程序环境中，调用my.tradePay接口；要使用小程序并绑定支付宝商户账号；后端通过调用支付宝统一收单下单接口来生成交易字符串，然后前端会唤起支付，并且接收异步通知以更新订单的状态。

2.APP支付宝支付：iOS、Android原生App中使用了支付宝SDK；后端产生交易订单信息，SDK调用支付宝客户端进行支付，并且可以适应原生APP业务的需求。

3、支付宝H5网页支付：移动端网页业务使用，返回表单或者跳转链接，跳转到支付宝H5收银台完成付款；接入域名需要进行ICP备案，面向的是网页端业务。

业务场景说明：很多项目都需要一个业务同时发布小程序、APP、H5，可以复用同一个后端订单系统来应对各种终端的需求，并且根据不同的支付方式来处理订单查询、退款和对账等事务性的操作。

三、支付接口开发通用核心技术规范

1、 敏感操作后置：签名、统一下单、验签逻辑都部署在了服务端，前端不允许保存商户密钥和私钥，以防密钥泄露而造成篡改、伪造等攻击行为。

2、回调通知强制验签：第三方支付异步回调请求不可信，必须严格校验签名，不能仅依靠回调参数直接更新订单状态。

3、业务幂等处理：支付平台会对推送回调通知进行重试；数据库更新订单时要加上status='待支付'"这样的条件来防止同一个回调被多次执行，从而产生重复扣款或者库存超额销售的问题。

4、双结果校验机制：异步回调+服务端主动轮询查询。由于网络故障会使得回调信息丢失，因此业务系统需要定期地去调用支付平台查询接口来校准本地订单的状态，不能够完全依靠回调通知。

2. 完整接入退款、查询、对账单接口：上线要实现下单支付，退款、订单查询、下载日对账单属于生产环境必备能力，用于处理用户的退款、财务账务核对。

6、安全合规控制：整个站点都使用了https加密；完整的保留交易日志；遵守有关网络安全和个人信息保护的法律法规；涉及到分账业务的话，一定要用到支付平台官方分账接口，并且不能自己建立二清模式。

四、持牌第三方支付机构简介与选型参考

4.1 持牌支付机构基础概念

持牌支付机构是指经过中国人民银行批准，并且持有《支付业务许可证》的非银行支付机构，其业务受到央行的监管，在客户备付金方面也实行了集中存管制度，即为一清模式。资金会由持牌金融机构直接清算到商户银行结算账户中去。与此相反的是“二清”模式，“二清”是指没有营业执照的机构再做一次清算，存在资金被挪用和合规处罚的风险，因此正式项目不能涉及。

主流续展持牌机构包括但不限于支付宝、财付通、银联商务、汇付天下、通联支付、快钱支付、拉卡拉、网银在线（京东）、钱袋宝（美团）、盛付通、易宝支付、连连支付等等。

4.2 汇付天下（上海汇付支付有限公司）

资质背景：2006年成立于上海；第一批获得央行颁发的《支付业务许可证》的企业已经具备了基金销售支付结算、跨境人民币/外汇支付、香港MSO货币服务经营等多方面的资质。

牌照业务范围：互联网支付、移动电话支付、银行卡收单，支持多种货币跨境收款并结汇。

业务定位：为B端商户提供数字化支付服务，包括但不限于聚合支付、账户存管、合规分账、跨境收单结汇等等。

开发接口的特点是：一个API可以整合微信、支付宝、银联、数字人民币等各种渠道，并且能够兼容小程序、APP、H5等各种终端；支持子商户线上进件、分账、结算提现，非常适合平台类业务：SaaS平台、多商户电商、出行、物业等等。

4.3 其他主流持牌支付机构速览

机构 | 背景 | 核心牌照范围 | 典型优势场景

支付宝 | 蚂蚁集团 | 互联网支付、移动电话支付、银行卡收单 | 电商、小程序、APP、H5，生态完善

财付通 | 腾讯 | 互联网支付、移动电话支付、银行卡收单 | 微信生态小程序、公众号、H5

银联商务 | 中国银联 | 互联网支付、移动电话支付、全国银行卡收单 | 线下收单、政企项目、银企直联

通联支付 | 上海国际集团 | 互联网支付、银行卡收单 | 保险、基金、教育行业解决方案

快钱支付 | 万达集团 | 互联网支付、银行卡收单 | 零售、航空、企业资金管理

拉卡拉 | 拉卡拉股份 | 互联网支付、银行卡收单 | 线下小微商户POS收单

网银在线 | 京东 | 互联网支付、银行卡收单 | 电商供应链、京东生态业务

钱袋宝 | 美团 | 互联网支付 | 本地生活、到店外卖业务

易宝支付 | 通融通 | 互联网支付、部分地区银行卡收单 | 航旅、教育、数字娱乐

连连支付 | 连连数字 | 互联网支付、跨境外汇支付 | 跨境电商收款、外贸出海业务

4.4 接入持牌三方机构的价值

1. 接口统一：对接一次聚合支付API就可以同时调用微信、支付宝、银联、数字人民币等多个渠道，从而减少对各个渠道进行单独对接所造成的开发和维护成本。

2. 平台业务合规分账：网约车、多商户电商、物业平台等等需要向入驻商户分账的业务，通过持牌机构分账接口来代替自己建立的资金池，并且避开二清监管的风险。

3. 标准化商户进件：由持牌机构完成商户实名认证、资质审核、结算卡绑定等KYC流程，降低开发方合规的工作量。

4. 跨境业务能力：汇付天下、连连支付等具有跨境收款付款资质，可以满足出海电商以及海外平台人民币和外币结算的需求。

5. 配套风控对账功能：机构内嵌有交易风控、反洗钱、自动对账、差错处理等功能，可以大大减少系统的自建风控成本。

4.5 小火科技在持牌三方支付的项目实践

除了直接对接微信、支付宝官方接口之外，小火科技还会根据业务场景来选择汇付天下、通联支付等持牌机构：

多商户分账场景：代驾出行平台、物业缴费项目等，通过持牌机构分账接口来实现平台、服务商、多方商户之间资金的拆分，避免了自行建立资金池被二清的风险。

跨境出海项目：AI海外二手车交易平台等等出海业务，由具有跨境资质的持牌机构来完成外币收款、结汇清算。

线下商户快速上架：加油站、充电桩等项目可以调用持牌机构线上商户进件接口，实现商户线上开户审核，缩短上线周期。

自动化财务对账：对接机构对账单接口，自动归集各渠道交易明细，输出财务对账报表。

五、支付渠道选型建议

成都小火科技公司结合我们APP、小程序、H5页面支付选型来看，总结出了如下经验：如果业务只限于国内C端单一生态业务（纯微信或者纯支付宝场景），并且直接对接官方渠道的话，整体费率会更高一些。

如果业务涉及到多个商户分账、跨境收款、线下收单、多渠道聚合需求等，则可以接入汇付天下、连连支付、通联支付等持牌机构，从而大大减少开发量和合规风险。

在需求阶段就应当明确分账、跨境、线下收单等业务诉求，并据此来判断是选择直接对接官方渠道，还是选择聚合持牌支付通道；另外还建议把支付模块源代码、接口文档和配置说明都写进项目的交付清单里，以保证以后的迭代修改可以控制得当。

文章来源网址：https://www.xiaohuokeji.com/archives/appd/2911，转载请注明出处！