Mollie 在线支付接入流程 - 从配置到首笔收款的完整步骤
三种接入路径
Mollie 提供了三种接入在线支付的方式，按技术门槛从低到高排列：
| 方式 | 适合谁 | 技术门槛 | 灵活度 |
|---|---|---|---|
| 预置插件 | 用 Shopify/WooCommerce/Magento 的商家 | 极低（填 API Key 就行） | 低（但够用） |
| Mollie Checkout | 有自己网站但不想写太多代码的 | 低（用 Mollie 托管的结算页） | 中 |
| 自定义 API | 有开发团队的 SaaS 和大商家 | 中高（需要写集成代码） | 高（完全定制） |
三种方式的底层都是同一个 Mollie 收单引擎，差异只在结算页面的控制权上。
路径一：预置插件（最快上线）
Mollie 为主流电商平台提供官方或社区插件：
已有的官方插件：
- WooCommerce（WordPress）
- Magento 1.x / 2.x
- Shopify
- Shopware 5 / 6
- PrestaShop
社区支持的还有：
- BigCommerce
- OpenCart
- Virtuemart
- Drupal Commerce
接入步骤
以 WooCommerce 为例：
- 在 WordPress 后台 → 插件 → 安装新插件 → 搜索 "Mollie"
- 安装并启用官方 Mollie 插件
- 设置 → Mollie → 填入你的 API Key
- 勾选你想启用的支付方式
- 保存设置，在前台测试一笔完整的付款
整个过程通常不超过 15 分钟。
路径二：Mollie Checkout（推荐）
Mollie Checkout 是 Mollie 托管的结算页面——当客户在你的网站点"付款"时，跳转到 Mollie 服务器上的结算页，由 Mollie 负责展示支付方式列表、处理 3DS 验证、完成扣款。付款完成后重定向回你指定的页面。
为什么推荐 Checkout
相比自己写结算页，Checkout 有几个明显优势：
- 支付方式展示自动处理：你只需要在 Mollie Dashboard 里启用哪些方式，Checkout 就自动渲染它们的 Logo 和表单
- 3DS 验证自动处理：Mollie 负责跳转和结果回调，你不用管
- 合规性：PCI DSS 合规成本最低，因为银行卡数据直接流向 Mollie 服务器，不经过你的
- 移动端适配：Checkout 页面自动适配手机屏幕
典型集成流程
客户在你的网站点"付款"
↓
你调用 Mollie API 创建一个 Payment（指定金额、币种、Redirect URL）
↓
Mollie 返回一个 checkout_url
↓
你把客户重定向到这个 URL
↓
客户在 Mollie Checkout 页面选择支付方式并付款
↓
Mollie 把客户重定向回你的 Redirect URL
↓
你通过 Webhook 收到 payment.paid 事件 → 订单标记为已支付创建 Payment 的 API 示例
curl -X POST https://api.mollie.com/v2/payments \
-H "Authorization: Bearer test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"amount": {
"currency": "EUR",
"value": "29.99"
},
"description": "Order #12345",
"redirectUrl": "https://yourstore.com/order/12345/success",
"webhookUrl": "https://yourstore.com/mollie/webhook"
}'返回结果里包含 _links.checkout.href，这就是你要重定向客户的 URL。
路径三：自定义集成（开发者向）
如果你有前端团队想要完全控制结算页的外观和流程，可以直接用 Mollie API + 自己的前端组件来处理支付。
两种 API 方案
- Payments API（简单场景）：创建 Payment → 获取 checkout_url → 跳转。其实和 Checkout 路径差不多，只是你可以在 API 里传更多自定义参数
- Orders API（复杂场景）：如果你有完整的订单管理系统（包括订单项、客户信息、收货地址等），用 Orders API 可以：
- 把每个订单项关联到 Payment
- 部分退款（按订单项而非整单）
- 同步订单状态和支付状态
- 更好的对账能力
SDK 支持
Mollie 提供的官方 SDK：
| 语言 | 包名 | 包管理 |
|---|---|---|
| PHP | mollie/mollie-api-php | Composer |
| Python | mollie-api-python | pip |
| Node.js | @mollie/api-client | npm |
| Ruby | mollie-api-ruby | gem |
| Java | mollie-api-java | Maven |
| .NET | Mollie.Api.Client | NuGet |
| Go | mollie-api-go | go get |
测试模式
无论走哪条路径，Mollie 都提供了完备的测试能力：
- 测试 API Key：以
test_开头，所有支付都是模拟的 - 测试支付方式：iDEAL、Bancontact、SEPA 都可以在测试模式下正常触发"付款成功"
- 测试 3DS：Mollie 提供一个模拟的 3DS 跳转页面
- 测试 Webhook：可以手动触发事件来测试回调处理逻辑
切换到正式模式前，务必在测试环境里走通完整的付款-回调-订单更新流程。
继续阅读：38+ 种支付方式总览 →