Stripe仅首次下单促销码对访客客户限制失效问题

问题描述 #

我创建了带有「仅首次下单」限制的促销码NEWCUSTOMER10，对应优惠券为「新客享10%折扣」，目的是限制仅首次下单的客户使用，防止重复兑换。但测试发现，当使用同一信用卡结账时，Stripe会以此信用卡号创建访客客户，即便设置了first_time_transaction: true限制，该访客客户仍能多次应用此促销码，导致折扣被重复使用。

促销码配置JSON #

{
  "id": "promo_1ExampleABC123",
  "object": "promotion_code",
  "active": true,
  "code": "NEWCUSTOMER10",
  "coupon": {
    "id": "coupon_1ExampleXYZ456",
    "object": "coupon",
    "amount_off": null,
    "created": 1723034203,
    "currency": null,
    "duration": "forever",
    "duration_in_months": null,
    "livemode": false,
    "max_redemptions": null,
    "metadata": {},
    "name": "10% Off for New Customers",
    "percent_off": 10,
    "redeem_by": null,
    "times_redeemed": 0,
    "valid": true
  },
  "created": 1723034204,
  "customer": null,
  "expires_at": null,
  "livemode": false,
  "max_redemptions": null,
  "metadata": {},
  "restrictions": {
    "first_time_transaction": true,
    "minimum_amount": 10000,
    "minimum_amount_currency": "usd"
  },
  "times_redeemed": 0
}

核心配置摘要 #

Code: NEWCUSTOMER10
Restriction: First-time order only
Coupon: 10% off for new customers

问题根源 #

Stripe的first_time_transaction限制基于Stripe客户对象的交易历史校验：仅当客户从未有过成功付款、订阅或发票支付记录时，才能使用该促销码。但访客客户（由信用卡自动创建的临时客户）存在两个关键问题：

1. 若结账流程未主动关联后续订单到同一访客客户对象，Stripe可能为同一张信用卡重复创建新的临时客户；
2. 即便关联到同一访客客户，临时客户的生命周期特性可能导致其历史交易未被纳入first_time_transaction的校验范围。

解决方法 #

1. 强制关联访客客户到同一对象 #

通过信用卡指纹识别重复访客，将后续订单绑定到同一个Stripe客户对象：

• 首次结账后，保存返回的客户ID和对应信用卡的fingerprint字段；
• 后续同一信用卡结账时，通过指纹匹配找到已存在的客户ID，在创建结账会话时指定该customer参数。

伪代码示例：

# 首次结账后保存客户信息
customer = stripe.Customer.retrieve(checkout_session.customer)
card_fingerprint = customer.sources.data[0].card.fingerprint
save_to_database(card_fingerprint, customer.id)

# 后续结账时匹配指纹并关联客户
existing_customer_id = get_from_database(card_fingerprint)
if existing_customer_id:
    checkout_session = stripe.checkout.Session.create(
        customer=existing_customer_id,
        # 其他结账参数...
    )

2. 添加「单客户限兑一次」限制 #

通过API为促销码添加max_redemptions_per_customer: 1限制，替代或补充first_time_transaction规则，直接锁定每个客户只能兑换一次：

stripe.PromotionCode.modify(
    "promo_1ExampleABC123",
    restrictions={
        "first_time_transaction": True,
        "max_redemptions_per_customer": 1,
        "minimum_amount": 10000,
        "minimum_amount_currency": "usd"
    }
)

3. 禁用访客客户自动创建 #

在创建结账会话时设置customer_creation: "always"，强制客户创建或关联已有账号，避免临时访客客户的不确定性：

checkout_session = stripe.checkout.Session.create(
    customer_creation="always",
    # 其他结账参数...
)

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