Mollie Connect 平台级集成 - 帮你的 SaaS 或市场内商户收单

什么是 Mollie Connect

Mollie Connect 是一套面向平台建设者的 API——如果你的产品是"给其他商户用的平台"（比如一个 SaaS ERP、一个多商户电商市场、一个发票 App），Connect 让你可以：

1. 通过 OAuth 让你的平台内的商户连接他们的 Mollie 账号
2. 替商户操作 Mollie 的全部功能（收单、退款、订阅、结算）
3. 自动向商户收取应用服务费（Application Fee）——从每笔交易里抽一个固定金额或百分比，由 Mollie 自动路由

┌─────────────────────────────────────┐
│ 你的平台（Organization）              │
│                                     │
│  Platform 收服务费到自己的 Mollie 余额   │
│                                     │
│  ┌──────┐  ┌──────┐  ┌──────┐       │
│  │商户A  │  │商户B  │  │商户C  │       │
│  └──┬───┘  └──┬───┘  └──┬───┘       │
│     │          │          │          │
│  各自的 Mollie 账号（OAuth 连接到你的平台）│
└─────────────────────────────────────┘

两种模式：Platform vs Marketplace

Connect 提供两种模式，适合不同的平台形态：

Platform 模式

适合：你有自己的收单关系，但想帮商户自动开通 Mollie——本质是"白标"或"代运营"。

• 商户自己持有 Mollie 账号（他们自己做 KYC、自己绑定银行）
• 你的平台替商户操作（OAuth 授权后，你可以用商户的 Access Token 创建 Payment、退款等）
• 应用服务费：你从商户的每笔交易里收一个固定金额或百分比，Mollie 自动把这部分路由到你的平台 Mollie 余额
• 资金流：客户 → Mollie → 商户 Mollie 余额（扣掉 Mollie 费率 + 你的应用服务费）→ 商户银行

客户支付 €100
  │
  ├── Mollie 费率：€2.00
  ├── 你的应用服务费：€3.00
  │
  ├── 商户 Mollie 余额：€95（100 - 2 - 3）
  └── 你的平台 Mollie 余额：€3（应用服务费）

Marketplace 模式

适合：你是一个市场平台（类似 Airbnb、Amazon Marketplace）——客户从你平台上的多个卖家买东西。

• 支付款项先进入 Mollie 托管余额（Holding Balance），不会先直接分给任何卖家
• 你自己决定怎么分钱：可以在 checkout 前就指定每个卖家分多少（Upfront Routing），也可以等交易完成后再分（Delayed Routing，推荐）
• 佣金：你不分给卖家的部分就是你的佣金，留在你的 Marketplace 余额
• 资金流：客户 → Mollie 托管余额 → 按你的 Routes 分 → 各卖家余额 + 你的佣金余额

客户在 Marketplace 买了 A 的 €60 商品 + B 的 €40 商品
  │
  ├── €100 先进入 Mollie 托管余额
  │
  ├── 你创建 Routes：
  │     ├── Seller A：€60
  │     ├── Seller B：€40
  │     └── 你（佣金）：€0（如果不收）或自行留一部分
  │
  └── Mollie 按 Routes 分到各余额

OAuth 接入流程

不管哪种模式，商户连接你平台的过程都是标准 OAuth 2.0 流程：

商户在你平台点 "Connect with Mollie"
  │
  ├── 你把商户重定向到 Mollie OAuth 页面
  │     └── 商户登录 Mollie 账号
  │     └── 商户同意授权 scopes
  │
  ├── Mollie 重定向回你平台，附带 authorization_code
  │
  ├── 你的服务器用 authorization_code 换 access_token + refresh_token
  │     └── access_token：短期（60 分钟），用来调 API
  │     └── refresh_token：长期，用来换新 access_token
  │
  └── 连接完成！你可以替商户操作了

Scopes（权限范围）

OAuth 授权时，商户会看到你申请的权限列表。每个 scope 对应一类操作：

最佳实践：只申请你真正需要的 scopes——商户看到权限越少，越容易完成授权。

标准 OAuth vs Client Link

Mollie Connect 提供两种商户接入方式：

• 标准 OAuth：商户自己去 Mollie 官方网站注册/登录，然后授权。适合已经有 Mollie 账号的商户
• Client Link：你平台生成一个 Client Link URL，商户点击后可以先注册 Mollie 账号，流程完全嵌入你的平台。适合还没有 Mollie 账号的商户（大多数新入驻的情况）

应用服务费（Application Fee）

Platform 模式下收费

创建 Payment 时传 applicationFee 参数：

payment = payments_api.create_payment(
    connected_account_id="org_merchant_xxxx",
    body={
        "amount": {"currency": "EUR", "value": "100.00"},
        "description": "Order #123",
        "redirectUrl": "...",
        "applicationFee": {
            "amount": {"currency": "EUR", "value": "3.00"},
            "description": "Platform service fee"
        }
    }
)

支付成功后，Mollie 自动：

• 把 €100 客户付款 → 扣除 Mollie 费率 → 把剩余部分（扣掉 €3.00 应用费）打到商户余额
• 把 €3.00 应用服务费 → 打到你平台的 Mollie 余额

Marketplace 模式下佣金

用 Routes 机制：

order = orders_api.create_order(
    marketplace_api=True,
    body={
        "amount": {"currency": "EUR", "value": "100.00"},
        "routes": [
            {
                "amount": {"currency": "EUR", "value": "60.00"},
                "destination": {"organizationId": "org_seller_a"}
            },
            {
                "amount": {"currency": "EUR", "value": "40.00"},
                "destination": {"organizationId": "org_seller_b"}
            }
        ],
        # 不 route 的部分自动是你的佣金
    }
)

Connect 资格要求

Connect 不是对所有 Mollie 商户开放的，需要：

• 你的平台是注册公司（不能是个人经营者）
• 通过 Mollie 审核（提交平台业务说明、计划服务地区、预计商户规模等）
• 签署 Connect 协议

申请入口：Dashboard → Connect → Apply。

核心概念速查

阅读 Mollie Connect 文档时会遇到几个关键术语：

继续阅读：开发者核心概念：客户/商户/余额 →