Mollie SDK 与预置插件 - 多语言官方库和主流电商集成

官方 SDK

Mollie 为 8 种主流语言提供了官方维护的 SDK，让你不用自己写 HTTP 请求、认证、序列化这些样板代码。

SDK 列表

Python SDK 使用示例

from mollie.api.client import Client

# 初始化
client = Client()
client.set_api_key("test_xxxxxxxxxxxxxxxx")

# 创建 Payment
payment = client.payments.create({
    "amount": {"currency": "EUR", "value": "29.99"},
    "description": "Order #42",
    "redirectUrl": "https://myshop.com/order/42/success",
    "webhookUrl": "https://myshop.com/api/mollie/webhook"
})

print(payment.id)           # tr_xxxxxxxxxx
print(payment.checkout_url) # 客户跳转地址

# 查询 Payment
payment = client.payments.get("tr_xxxxxxxxxx")
print(payment.status)       # paid / open / failed ...

# 创建 Subscription
customer = client.customers.create({"name": "John", "email": "john@example.com"})
subscription = client.subscriptions.create_for_customer(
    customer.id,
    {
        "amount": {"currency": "EUR", "value": "9.99"},
        "interval": "1 month",
        "description": "Basic Plan Monthly"
    }
)

SDK 自动帮你做的事：

• HTTP 请求和 JSON 序列化
• Bearer Token 认证头
• URL 构建（/v2/payments → 完整 URL）
• 错误处理（抛出 SDK 异常）
• API 版本升级兼容（SDK 版本和 API 版本对应）

SDK vs 手写 HTTP

建议：大多数场景直接用官方 SDK——省下的时间比引入一个包的代价更有价值。

预置插件（电商平台）

如果你用的是主流电商平台，根本不需要碰代码——安装官方插件、填 API Key 就行。

支持的平台

插件安装通用流程

1. 在电商平台后台/插件商店搜索 "Mollie"
2. 找到官方认证的那个（作者显示 Mollie B.V.）
3. 安装并启用
4. 在插件设置页填入 API Key（test_ 或 live_）
5. 勾选你想启用的支付方式
6. 保存设置
7. 前台测试一笔完整的付款

WooCommerce 示例详解

WordPress 后台 → 插件 → 添加新插件
  │
  ├── 搜索 "Mollie"
  │     └── 找到 "Mollie Payments for WooCommerce"（作者：Mollie B.V.）
  │
  ├── 安装并启用
  │
  ├── 设置 → Mollie
  │     ├── API Key：test_xxxxxxxxxxxxxxx（先测试）
  │     ├── 启用的支付方式：勾选 iDEAL、信用卡、PayPal、Klarna
  │     ├── 结算页标题："Secure payments by Mollie"
  │     └── 保存
  │
  └── WooCommerce 设置 → Payments
        └── 每个支付方式独立设置图标、排序、启用状态

安装完成后，WooCommerce 的 Checkout 页面会自动显示所有启用的支付方式，客户可以选择自己习惯的方式付款。

插件做了什么

• 自动生成 Payments API 调用
• 自动处理 Webhook（插件自带 Webhook endpoint）
• 自动更新 WooCommerce 订单状态
• 自动在 Checkout 渲染支付方式列表和 Mollie Checkout 跳转
• 自动创建 Customer（如果用 Recurring）
• 自动处理订阅续费

这就是"零代码接 Mollie"的完整路径——从安装插件到上线通常 15-30 分钟。

插件限制

• 自定义能力受限（比如想要完全定制化的结算页）
• 版本升级可能滞后 Mollie API 升级
• 一些高级功能（Connect、Orders API 的部分高级选项）可能不在插件里暴露

如果你需要更多控制力，可以：

• 先用插件跑起来，后续逐步替换成自定义集成
• 联系 Mollie 看看有没有企业级定制选项

Postman 集合

Mollie 官方维护了一个完整的 Postman Collection——涵盖 v2 API 的所有端点，可以直接在 Postman 里导入测试：

1. Postman 里 → Import
2. 粘贴 Mollie 文档里提供的 Collection Link
3. 设置 Collection Variables（baseUrl、apiKey）
4. 可以直接在 Postman 界面里测试每个端点

对于快速探索 API 能力、团队内部新人培训特别有用。

继续阅读：Mollie Connect：平台级集成 →