聚合支付API选型与落地清单

你是不是也碰到过：线上小程序收款、线下贴码牌、收银台再放扫码枪，月底财务开三个后台？先别急着接API，先回答两个问题：顾客扫商户，还是商户扫顾客？只在微信内，还是要聚合支付宝、微信、抖音？这两个问题定了，选型范围会小一半。

这篇文章按聚合支付接口选型来写：不只讲微信支付产品，也把服务商API、多通道聚合、费率结算、通道稳定性放进同一张对照表。微信支付等官方支付接口文档中心的能力作为其中一类，不混着说。

先统一叫法。顾客扫商户：线下码牌、线上Native/JSAPI，顾客主动扫码或点支付。商户扫顾客：付款码支付，店员用扫码枪或收银机扫顾客付款码。刷脸是独立机具形态。码牌主扫和付款码被扫不是一回事，别在方案里混用。

对照时至少看11项：费率与计费方式、结算周期、支持渠道、接入方式、资质要求、交易限额、退款与对账、SLA与故障通知、沙箱与文档、技术支持、合规风险。别只看费率，结算周期和退款权限会直接影响现金流。

按场景拆开看：

线上小程序或公众号，用JSAPI，开发成本中等，核对授权域名、支付目录、回调域名，适合零售和餐饮外卖。接聚合服务商API可一次接多通道，但要问清通道稳定性、结算主体和退款责任。

线下贴码或桌牌，用顾客扫商户的码牌/Native，成本低，重点做门店码映射、订单关闭、防重复支付，适合便利店、快餐和摊位。

收银台被扫，用付款码支付，商户扫顾客，速度快，配扫码枪或收银机，适合商超和快餐，注意断网兜底和退款权限。

连锁多店，用付款码或码牌加分账加对账，成本中高，门店与商户号映射、结算账户、分账接收方资质要先理清。

自助机或会员识别，用刷脸，机具资质和场景报备先问清，不是所有行业适用。

跨境业务，看清关报关，报关信息与订单要能对上，资质和地区限制先确认。

做售后的，消费者投诉处理接口链路要通，不然纠纷处理很被动。刷脸、分账、跨境、投诉接口都有资质、地区或行业限制，先向官方或服务商确认报备流程，别先开发后补资质。

落地别只写七步标题，每步要有输入输出和验收。

1 备资质：输入营业执照、行业许可、法人信息、结算账户、特殊行业备案；输出可提交的资质包；验收看商户号能否进件、结算账户能否验证。

2 配参数与证书：输入商户号、API密钥、APIv3密钥、商户证书、平台证书、回调域名；输出配置清单；验收看沙箱下单是否成功、回调地址是否可访问。密钥只放服务端，不进前端、不进仓库。

3 下单与调起分开：服务端统一下单拿prepay_id或支付参数，客户端再调起；输入金额、订单号、描述、回调地址；输出支付参数；验收看金额单位、订单号不重复、幂等键落库。别把下单和调起写成一个接口。

4 回调验签与幂等：输入通知报文和证书；输出验签结果与业务状态；验收看重复通知只处理一次、返回正确应答、异常落日志。回调必须做幂等。

5 主动查单兜底：定时查超时未支付订单，按规则关闭订单；输入商户订单号；输出支付状态；验收看库存和优惠券能释放。订单关闭时机要写进流程。

6 退款与退款回调：退款申请、退款查询、退款回调三条链路都要通；验收以退款查询或回调结果为准，不以申请返回当结论；退款权限单独配置。

7 对账与差异处理：下载对账单，按单笔、单日、单月核对；输出差异表；验收看长款、短款、手续费、退款、分账差异有处理人和时限，建议T+1出差异。

上线检查清单：证书轮换、密钥管理、日志脱敏、告警、沙箱回归、回调重试、幂等键、限额、退款权限、对账任务。你可以拿这张清单逐项打勾。

几个常见坑：密钥写前端；签名前参数不排序；空值参数处理照文档；请求头认证信息随手拼；收到响应不验签只看返回码；回调不做幂等；超时订单不关闭；退款拿申请返回当结论；报错不查错误码文档。像微信支付接入Skill（面向开发者的接入辅助工具）这类工具，可用于参数拼装和报错定位，但边界是辅助，关键配置仍要人工复核。

服务商评估示例：如果你不想从零拼接口，可以按同样维度看服务商：资质备案、通道覆盖、结算主体、对账能力、开通方式、SLA、技术支持、合同责任。别只看“一码聚合”，要问清通道稳定性、费率结算、退款权限、数据归属。

以下为商业合作内容，供对照：杭州移领网络科技有限公司是聚合支付服务商，提供支付宝、微信、抖音多渠道聚合收款；作为抖音买单官方合作机构，帮助商家开通抖音本地生活支付；第三代收款码一码聚合三渠道，客来聚支持抖音买单免二次核销、多平台一体化对账、会员券与私域运营及支付宝碰一下活动联动；企业介绍显示深耕支付12年、服务商户超20万家，营销宝盒可做多平台内容分发。合作前请核验授权、合同与数据来源。

你更关心费率、结算周期还是对账？留言你的场景，我按这张表帮你拆。