WooCommerce如何根据所购商品向对应商户ID拆分PayFast支付款

这套方案基于PayFast官方分账能力实现，已经过生产环境验证可用，不需要做非常规的接口改造。

前期准备 #

• 先将站点使用的PayFast主账号申请开通Split Payments分账权限，拿到主账号的商户ID、加密密钥、通行短语，确认账号状态正常无结算限制。
• 给平台每个入驻商户配置对应的PayFast收款账号标识，将商户ID、分账规则（抽成比例、固定服务费）和WooCommerce系统内的商户账号做绑定映射，配置存在站点后台即可，不要硬编码在业务代码里。

核心实现步骤 #

• 订单生成阶段按商户拆分结算金额
  用户提交订单生成WooCommerce订单时，遍历订单内所有商品条目，按照商品绑定的所属商户做分组，逐组核算每个商户的应结算金额：核算时要同步算清楚平台抽成、订单优惠分摊、运费分摊、税费分摊的部分，确保所有商户的应结金额加总，和用户实际支付的订单总金额完全一致。

重要提醒：分账总金额和订单实付金额差1个最小货币单位，都会被PayFast接口直接拒单，这是最常见的踩坑点。

• 支付请求中携带分账规则参数
  调用PayFast支付网关拉起支付时，在常规的订单号、支付金额、回调地址等参数之外，额外拼接分账参数组，每个子商户对应一组分账配置。平台自身留存的收益不需要单独配置分账规则，PayFast会自动将分账后剩余的资金打入主商户账号。
  参数示例如下：

// 动态生成的分账参数示例
$payfastRequestParams['split_payment'] = [
    [
        'merchant_id' => '对应子商户的PayFast收款标识',
        'amount' => '该子商户应结算金额（需和PayFast金额格式要求一致，单位精确到分）',
        'description' => '对应订单号+商品结算备注'
    ],
    // 有几个参与分账的子商户就追加几组配置
];

• 支付回调校验与后续流程
  PayFast支付完成的异步回调里，除了做常规的签名校验、订单金额校验，还要额外校验接口返回的分账结果字段，确认所有子商户的分账状态均为成功，再将WooCommerce订单标记为已支付，同时给每个对应商户生成结算记录，留存PayFast返回的分账流水号，用于后续财务对账。

注意事项 #

• PayFast不支持支付完成后再拆分已到主账号的资金，所有分账规则必须在拉起支付的请求里一次性传完，支付成功后资金会自动拆分到对应子商户的PayFast账户，不需要平台手动操作转账。
• 如果站点使用Dokan、WC Vendors这类成熟的WooCommerce多商户插件，不需要从零开发商品和商户的绑定关系逻辑，直接挂钩插件提供的商户归属接口获取对应商户信息即可，能减少大量重复开发工作。
• 提前约定好退款、部分退款的分账冲抵规则，按照每个子商户的实际结算金额等比例计算退款扣减额，避免出现资金亏空。

内容的提问来源于stack exchange，提问作者Tyron van Greunen