Stripe Payment Intent传递订单内容的更佳方案问询

针对你遇到的Stripe Payment Intent Metadata 500字符限制问题，这里有几个更合理的解决思路：

1. 优先用自有数据库存储订单详情，Metadata仅存订单ID #

这是最稳妥的方案，完全避开Stripe的字段限制：

• 创建Payment Intent前，先把完整订单详情存入你的数据库，生成唯一orderId
• 仅将orderId存入Metadata字段
• Webhook收到支付事件时，通过orderId从数据库查询完整订单信息

代码示例：

// 第一步：将订单存入自有数据库
const orderId = await saveOrderToDatabase({ userId, items: orderItems, total: getTotal(orderItems) });

// 第二步：创建Payment Intent时仅存orderId
await stripe.paymentIntents.create({
  currency: "brl",
  amount: getTotal(orderItems),
  payment_method_types: ["card", "boleto"],
  receipt_email: userEmail,
  description: getSummary(orderItems),
  metadata: {
    userId,
    orderId: orderId
  },
});

// Webhook处理逻辑
app.post('/stripe-webhook', async (req, res) => {
  const event = req.body;
  if (event.type === 'payment_intent.succeeded') {
    const paymentIntent = event.data.object;
    const orderId = paymentIntent.metadata.orderId;
    const order = await getOrderFromDatabase(orderId);
    // 执行后续业务逻辑：发货、通知用户等
  }
  res.json({ received: true });
});

2. 使用Stripe的Line Items存储订单项（适用于标准化商品） #

如果你的订单由标准化商品/服务组成，可直接用Stripe的line_items字段定义订单项，Stripe会保留这些信息，Webhook事件中能直接获取完整订单项数据，无需依赖Metadata：

await stripe.paymentIntents.create({
  currency: "brl",
  amount: getTotal(orderItems),
  payment_method_types: ["card", "boleto"],
  receipt_email: userEmail,
  description: getSummary(orderItems),
  metadata: { userId },
  // 关联Stripe后台创建的Price ID
  line_items: orderItems.map(item => ({
    price: item.stripePriceId,
    quantity: item.quantity
  }))
});

注：若商品是非标准化的（如自定义报告），可考虑动态创建Stripe Price后再配置，或结合方案一使用。

3. 压缩Metadata内容（备选应急方案） #

如果暂时无法修改数据库逻辑，可对订单详情的JSON字符串进行压缩（gzip后转Base64），减少字符占用：

const zlib = require('zlib');

// 压缩函数
function compressString(str) {
  const buffer = Buffer.from(str, 'utf8');
  return zlib.gzipSync(buffer).toString('base64');
}

// 创建Payment Intent时使用压缩内容
const reportsJson = JSON.stringify(getReportMetadata(orderItems));
await stripe.paymentIntents.create({
  // ...其他字段
  metadata: {
    userId,
    reports: compressString(reportsJson)
  },
});

// Webhook中解码
function decompressString(str) {
  const buffer = Buffer.from(str, 'base64');
  return zlib.gunzipSync(buffer).toString('utf8');
}

// Webhook处理时解码
const reports = JSON.parse(decompressString(paymentIntent.metadata.reports));

注意：这种方法仅能临时缓解，压缩后仍可能接近字符上限，且增加了编码解码复杂度，不推荐作为长期方案。

内容的提问来源于stack exchange，提问作者Vitor Figueredo Marques