如何在ColdFusion CFPayment库中正确为Stripe支付传递元数据？

我之前也碰到过类似的库内参数层级问题，咱们一步步来拆解解决：

首先明确核心问题：Stripe要求元数据必须嵌套在metadata子对象中，而不是直接作为顶级参数放在请求的主JSON结构里。你看到firstname2跑到主数组里，就是因为没有正确设置嵌套层级。

正确修改stripe.cfc的操作步骤 #

1. 找到库中构建Stripe支付请求的代码段（通常是createCharge或同类核心方法的位置）
2. 确保把元数据字段放在metadata键的子结构内，而不是直接添加到主请求参数中。举个具体的代码示例：

// 错误写法（导致参数跑到主层级）
requestParams = {
  amount = paymentAmount,
  currency = "usd",
  firstname2 = "John"
};

// 正确写法（嵌套在metadata子对象下）
requestParams = {
  amount = paymentAmount,
  currency = "usd",
  metadata = {
    firstname2 = "John",
    // 可按需添加更多元数据字段
    orderNumber = "ORD-78901"
  }
};

3. 如果CFPayment库本身提供了元数据的专用传入入口（比如setMetadata()方法），优先使用官方封装的方法传递键值对，这比直接修改核心cfc文件更稳妥，也能避免库的逻辑干扰参数结构。

验证修改是否生效 #

• 在发送请求前，用<cfdump var="#serializeJSON(requestParams)#">输出最终生成的JSON结构，确认firstname2是在metadata对象内部，而非顶级键。
• 查看Stripe Dashboard的请求日志，对比JSON结构是否符合Stripe的要求（官方规范里元数据必须是metadata对象下的键值对）。

如果调整后问题仍存在，检查库是否有对请求参数做额外的过滤或重组逻辑——有些旧版本的CFPayment可能会默认保留非预设的顶级参数，却没有正确识别metadata子对象，这时候需要找到库中处理参数映射的模块，确保metadata被完整传递到请求中。

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