如何在Stripe的confirmCardPayment()中添加Payment Details description或Timeline note

stripe.confirmCardPayment() 是 Stripe 客户端侧的支付确认方法，本身不支持直接传入支付详情描述、时间线备注类的参数，这两类配置都需要在服务端操作 PaymentIntent 时完成：

• Payment Details 描述：对应 PaymentIntent 的 description 字段，会直接展示在支付详情页的基础信息区域
• Timeline 备注：可以通过 PaymentIntent 的 metadata 自定义字段实现，添加的自定义键值对会自动展示在支付记录的时间线板块中

具体操作步骤 #

1. 服务端创建 PaymentIntent 时直接传入对应参数，以下是 Node.js 环境的示例代码：

const paymentIntent = await stripe.paymentIntents.create({
  amount: 2000,
  currency: 'usd',
  // 配置Payment Details描述
  description: '2024年XX季度会员订阅费用',
  // 配置Timeline备注，可自定义任意键值对
  metadata: {
    order_id: 'ORD_123456',
    customer_note: '用户要求提前开通服务权限',
    operator: '张三'
  },
  // 如果需要配置用户信用卡账单上显示的描述，可添加以下参数
  statement_descriptor: 'XX平台会员订阅'
});
// 把返回的client_secret传给前端即可

2. 客户端 confirmCardPayment 方法不需要做任何参数调整，沿用你当前的写法即可：

stripe
  .confirmCardPayment(secret, {
    payment_method: { card }
  })

补充说明 #

如果 PaymentIntent 已经创建完成，你也可以在服务端调用 PaymentIntent 的更新接口修改上述字段：

const updatedPaymentIntent = await stripe.paymentIntents.update(
  'pi_xxx', // 对应PaymentIntent的ID
  {
    description: '修改后的支付描述',
    metadata: {
      add_note: '补充用户特殊需求'
    }
  }
);

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