如何避免Stripe Checkout会话重复创建同邮箱客户？

要实现同一邮箱复用已有客户，核心是创建Checkout会话前先查询该邮箱对应的Stripe客户，存在则复用其ID，具体步骤和代码修改如下：

实现逻辑 #

• 先调用Stripe的客户列表接口，根据传入的邮箱过滤已有客户
• 查到匹配客户时，在创建Checkout会话时指定Customer参数为该客户ID
• 未查到匹配客户时，让Stripe自动创建新客户（或你主动创建后指定ID）

修改后的完整代码 #

var customerService = new CustomerService(this.client);
// 根据邮箱查询已有客户，只取第一个匹配项
var existingCustomers = await customerService.ListAsync(new CustomerListOptions
{
    Email = email,
    Limit = 1
});

var options = new SessionCreateOptions
{
    SuccessUrl = successUrl + "&email=" + email,
    CancelUrl = cancelUrl,
    Mode = "subscription",
    AllowPromotionCodes = true,
    // 复用已有客户ID，无匹配则留空让Stripe自动创建
    Customer = existingCustomers.Data.FirstOrDefault()?.Id,
    LineItems = new List<SessionLineItemOptions>
    {
        new SessionLineItemOptions
        {
            Price = priceId,
            Quantity = 1,
        },
    }
};

var service = new SessionService(this.client);
try
{
    var session = await service.CreateAsync(options);
    Response.Headers.Add("Location", session.Url);
    return new StatusCodeResult(303);
}
catch (StripeException ex)
{
    // 可根据业务需求添加异常处理，比如返回错误提示
    return BadRequest(ex.Message);
}

注意事项 #

• Stripe的邮箱匹配是精确大小写匹配，若需要忽略大小写，可在查询前将邮箱统一转换为小写
• 如果同一邮箱对应多个Stripe客户（比如历史手动创建的重复项），代码默认取第一个匹配结果，你可根据业务逻辑调整筛选规则
• 指定Customer参数后，后续所有通过该会话创建的订阅都会关联到该客户，客户登录Stripe门户即可查看所有关联订阅

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