Node.js应用使用Mollie动态金额支付时提示支付方式未启用

问题描述 #

我正在开发一个集成Mollie支付网关的Node.js应用。当尝试使用Mollie API创建动态金额支付时，收到错误提示“该支付方式未在您的网站配置文件中启用”，但使用静态金额时一切正常。
在应用中，用户可输入金额值，我将该值传递给Mollie API创建支付，代码示例如下：

// Relevant code snippet
// ...

app.post('/create-payment', async (req, res) => {
  try {
    const price = req.body.price; // Dynamic price value from user input
    const mollieClient = await createMollieClient({ apiKey: 'My_API' });

    const payment = await mollieClient.payments.create({
      amount: {
        currency: 'EUR',
        value: price,
      },
      // Other payment details
      // ...
    });

    res.json({ url: payment.getCheckoutUrl() });
  } catch (error) {
    console.error('Error creating Mollie payment:', error);
    res.status(500).send('Error creating payment');
  }
});

// ...

我已验证Mollie网站配置文件已启用所有必要支付方式，API密钥具备所需权限，且动态金额值已正确接收并传递给Mollie API。
我不确定为何仅动态金额会触发该错误，使用Mollie动态支付金额时需注意哪些事项？

排查与解决要点 #

• 强制校验金额格式
  Mollie要求amount.value必须是带两位小数的字符串（符合ISO 4217标准），比如"9.99"，不能传整数、不带小数的字符串或超过两位小数的数值。用户输入的动态金额可能没做格式处理，导致Mollie无法识别，进而误判支付方式不可用。
  可以添加格式处理逻辑：

  // 处理用户输入的金额，确保是带两位小数的字符串
  const formattedPrice = typeof price === 'string' 
    ? parseFloat(price).toFixed(2) 
    : price.toFixed(2);
  

• 检查金额是否超出支付方式限额
  不同支付方式有严格的金额上下限（比如iDEAL最低1欧元，部分本地支付方式有最高限额）。静态金额刚好在限额内，但用户输入的动态金额可能超出了所有启用支付方式的限额，Mollie会自动过滤掉不符合条件的方式，最终无可用方式时就会抛出该错误。
  测试时可以指定具体支付方式（比如method: 'ideal'），看是否还报错，以此快速定位是否是金额超限问题。

• 排查隐藏的支付方式参数
  代码中// Other payment details部分可能包含method或与支付方式绑定的参数，静态金额测试时这些参数匹配已启用的方式，但动态金额场景下可能触发了逻辑（比如根据金额自动选择未启用的支付方式），导致传递了未启用的方式ID。建议临时注释掉非必填参数，只保留金额、货币、回调URL等核心字段测试。

• 确认测试/生产环境配置一致性
  如果使用测试API密钥，要单独确认测试环境的网站配置是否真的启用了所需支付方式——很多时候生产环境配置没问题，但测试环境漏开了某些方式。另外，测试环境的部分支付方式可能只支持特定金额范围的测试交易，动态金额刚好踩中了限制。

内容的提问来源于stack exchange，提问作者Max_Pozniak