如何为Stripe产品添加多语言描述以适配法语结账会话

一、给Stripe产品添加多语言描述 #

• 进入Stripe后台「产品」页面，找到目标产品并进入编辑界面
• 在产品详情区，点击描述区域右上角的语言切换图标（地球形状）
• 选择法语（Français），输入对应的法语产品名称和描述后保存
• 若通过API更新产品，可直接传入本地化的名称和描述字段，示例代码：

stripe.Product.modify(
  "prod_XXXXXX",
  name={"en": "English Product Name", "fr": "Nom du produit en français"},
  description={"en": "English description", "fr": "Description en français"}
)

二、确保结账会话加载对应语言的产品信息 #

• 创建结账会话时，除了将locale参数设为fr，需确认产品已完成法语信息配置
• Stripe会根据会话的locale自动匹配产品对应的语言字段，无需额外在line_items中重复设置
• 创建法语结账会话的示例代码：

stripe.checkout.Session.create(
  payment_method_types=['card'],
  line_items=[{
    'price': 'price_XXXXXX',
    'quantity': 1,
  }],
  mode='payment',
  success_url='https://yourdomain.com/success',
  cancel_url='https://yourdomain.com/cancel',
  locale='fr'
)

三、常见问题排查 #

• 若仍显示英文：检查产品的法语字段是否正确保存，可在后台切换语言验证
• 确认结账会话的locale参数是否准确设置为fr
• 旧版API可能不支持产品本地化字段，需升级至最新API版本

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