在 Stripe 中创建新订阅时，可通过 stripe.SubParams 的 AddMeta() 方法直接附加键值对形式的元数据（如 "Product": "special-services"），无需额外请求，全程在单次 API 调用中完成。
在 stripe 中创建新订阅时，可通过 stripe.subparams 的 addmeta() 方法直接附加键值对形式的元数据（如 "product": "special-services"），无需额外请求，全程在单次 api 调用中完成。
Stripe Go 客户端库为大多数资源参数结构（包括 stripe.SubParams）嵌入了通用的 stripe.Params 类型，该类型提供了 AddMeta(key, value string) 方法，用于安全、便捷地注入元数据。元数据将作为 metadata 字段提交至 Stripe API，并持久化存储在该订阅对象上，后续可通过 Dashboard 或 API 查阅、筛选或用于自动化规则（如 Webhook 分流、计费审计等）。
以下是完整、可运行的示例代码：
stripe.Key = "sk_test_..." // 请替换为你的 Secret Key
subParams := &stripe.SubParams{
Customer: "cus_123456789", // 已存在的客户 ID
Plan: "price_monthly_basic",
}
// ✅ 正确添加元数据（支持多个键值对）
subParams.AddMeta("Product", "special-services")
subParams.AddMeta("Source", "referral-partner-abc")
subParams.AddMeta("Environment", "production")
subscription, err := sub.New(subParams)
if err != nil {
log.Fatalf("Failed to create subscription: %v", err)
}
fmt.Printf("Created subscription: %s\n", subscription.ID)
⚠️ 注意事项：
- 元数据键（key）必须是 UTF-8 编码的字符串，且长度不超过 40 个字符；值（value）长度不可超过 500 字符；
- 键名不区分大小写，但建议统一使用小写加连字符（如
payment_source）以提升可读性与兼容性； -
AddMeta()可被多次调用，重复 key 会覆盖前值； - 元数据仅支持字符串类型，如需存数字或布尔值，请先序列化为字符串（例如
strconv.Itoa(123)或"true"）； - 元数据不会触发任何 Stripe 内置行为（如自动折扣或权限控制），其用途完全由开发者业务逻辑定义。
总结：Stripe Go SDK 提供了简洁统一的 AddMeta() 接口，让元数据注入成为创建订阅的标准组成部分。合理使用元数据，不仅能增强订单上下文信息，还能为后续的分析、运营和自动化流程提供关键支撑。
