Stripe元数据字符超限问题：购物车数据适配Webhook解决方案咨询

报错信息 #

file:///Users/mac/Desktop/Sotofit/back-end/node_modules/stripe/esm/Error.js:7
return new StripeInvalidRequestError(rawStripeError);
^

StripeInvalidRequestError: Invalid val: [{"_id":"64e707601462c7a9b2c9a926","desc":"EWAGAHIN","image":"http://res.cloudinary.com/dmihhsps6/im...om/dmihhsps6/image/upload/v1692868880/Sotofit/ksfwjtyldzbbwa0ganle.png","price":"400","quantity":2}] must be a string under 500 characters
at Function.generate (file:///Users/mac/Desktop/Sotofit/back-end/node_modules/stripe/esm/Error.js:7:20)
at res.toJSON.then.StripeAPIError.message (file:///Users/mac/Desktop/Sotofit/back-end/node_modules/stripe/esm/RequestSender.js:102:43)
at processTicksAndRejections (node:internal/process/task_queues:96:5) {
type: 'StripeInvalidRequestError',
raw: {
message: 'Invalid val: [{"_id":"64e707601462c7a9b2c9a926","desc":"EWAGAHIN","image":"http://res.cloudinary.com/dmihhsps6/im...om/dmihhsps6/image/upload/v1692868880/Sotofit/ksfwjtyldzbbwa0ganle.png","price":"400","quantity":2}] must be a string under 500 characters',
param: 'metadata',
request_log_url: 'https://dashboard.stripe.com/test/logs/req_FEDLmQMpIH89Fk?t=1694450970',
type: 'invalid_request_error',
headers: {
server: 'nginx',
date: 'Mon, 11 Sep 2023 16:49:30 GMT',
'content-type': 'application/json',
'content-length': '470',
connection: 'keep-alive',
'access-control-allow-credentials': 'true',
'access-control-allow-methods': 'GET,HEAD,PUT,PATCH,POST,DELETE',
'access-control-allow-origin': '*',
'access-control-expose-headers': 'Request-Id, Stripe-Manage-Version, X-Stripe-External-Auth-Required, X-Stripe-Privileged-Session-Required',
'access-control-max-age': '300',
'cache-control': 'no-cache, no-store',
'idempotency-key': 'stripe-node-retry-e4f75476-47c4-4410-aed4-3a258fd29505',
'original-request': 'req_FEDLmQMpIH89Fk',
'request-id': 'req_FEDLmQMpIH89Fk',
'stripe-version': '2023-08-16',
vary: 'Origin',
'x-stripe-routing-context-priority-tier': 'api-testmode',
'strict-transport-security': 'max-age=63072000; includeSubDomains; preload'
},
statusCode: 400,
requestId: 'req_FEDLmQMpIH89Fk'
},
rawType: 'invalid_request_error',
code: undefined,
doc_url: undefined,
param: 'metadata',
detail: undefined,
headers: {
server: 'nginx',
date: 'Mon, 11 Sep 2023 16:49:30 GMT',
'content-type': 'application/json',
'content-length': '470',
connection: 'keep-alive',
'access-control-allow-credentials': 'true',
'access-control-allow-methods': 'GET,HEAD,PUT,PATCH,POST,DELETE',
'access-control-allow-origin': '*',
'access-control-expose-headers': 'Request-Id, Stripe-Manage-Version, X-Stripe-External-Auth-Required, X-Stripe-Privileged-Session-Required',
'access-control-max-age': '300',
'cache-control': 'no-cache, no-store',
'idempotency-key': 'stripe-node-retry-e4f75476-47c4-4410-aed4-3a258fd29505',
'original-request': 'req_FEDLmQMpIH89Fk',
'request-id': 'req_FEDLmQMpIH89Fk',
'stripe-version': '2023-08-16',
vary: 'Origin',
'x-stripe-routing-context-priority-tier': 'api-testmode',
'strict-transport-security': 'max-age=63072000; includeSubDomains; preload'
},
requestId: 'req_FEDLmQMpIH89Fk',
statusCode: 400,
charge: undefined,
decline_code: undefined,
payment_intent: undefined,
payment_method: undefined,
payment_method_type: undefined,
setup_intent: undefined,
source: undefined
}
[nodemon] app crashed - waiting for file changes before starting...

你遇到的是Stripe Metadata单值字符长度限制问题（单条metadata值最多允许500字符），当购物车包含多件商品或字段冗余时，序列化后的JSON字符串很容易超出限制。以下是几种可行的解决思路：

1. 改用Stripe Line Items存储商品信息（推荐） #

创建PaymentIntent或Checkout Session时，直接将购物车中的每个商品作为line item传入，而非塞进metadata。Webhook触发时（如checkout.session.completed或payment_intent.succeeded事件），可直接从事件对象的line_items字段获取完整商品详情，完全避开metadata的字符限制。

示例代码（Node.js）：

const session = await stripe.checkout.sessions.create({
  payment_method_types: ['card'],
  line_items: cartItems.map(item => ({
    price_data: {
      currency: 'usd',
      product_data: {
        name: item.desc,
      },
      unit_amount: parseInt(item.price) * 100, // 单位转换为分
    },
    quantity: item.quantity,
  })),
  mode: 'payment',
  success_url: 'https://yourdomain.com/success',
  cancel_url: 'https://yourdomain.com/cancel',
});

2. 精简Metadata中的字段 #

若必须使用metadata，只保留绝对必要的核心信息（如商品ID、数量、单价），移除图片URL、过长描述等冗余字段。这些额外信息可在Webhook触发后，通过商品ID从自身数据库查询获取。

示例：

const metadata = {
  cartItems: JSON.stringify(cartItems.map(item => ({
    productId: item._id,
    quantity: item.quantity,
    price: item.price
  })))
};

3. 用数据库ID替代完整购物车数据 #

在创建支付会话前，将购物车数据存入自身数据库并生成唯一的购物车ID/订单ID，仅将该ID存入Stripe的metadata。Webhook收到事件后，通过此ID从数据库中取出完整的购物车详情。

流程示例：

• 将cartItems存入数据库，得到cartId
• 创建Stripe会话时，设置metadata: { cartId: cartId }
• Webhook触发后，用cartId查询数据库获取完整购物车数据

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