Stripe Connect卖家账户创建问题及代码排查求助

1. 当前实现方式是否正确？ #

整体思路没问题，但存在几个关键问题需要修正：

• 密钥硬编码风险：代码里直接写死stripe.api_key = "test key here"，生产环境必须改用环境变量（比如os.getenv("STRIPE_SECRET_KEY")），避免密钥泄露。
• Stripe账户创建逻辑局限：仅在首次添加银行信息时创建账户，卖家更新银行信息时不会同步更新Stripe账户的收款账户，后续需要补充更新逻辑。
• 地址空值未处理：user_address = Address.objects.filter(user=login_user).first()如果用户未填写地址，会返回None，后续访问user_address.line1会直接报错，必须先判断地址是否存在。
• TOS接受时间格式错误：tos_acceptance.date要求传入Unix时间戳，当前传datetime.now()是Python datetime对象，会导致Stripe解析失败，需改为int(datetime.now().timestamp())。
• 加密实现不明确：cipher_suite未定义，需确保使用AES-GCM等安全加密算法，且密钥存储在环境变量中，不能硬编码。
• 外部账户传参方式不规范：直接传入银行账号和路由号容易触发格式校验错误，Stripe推荐先创建银行账户令牌，再传入令牌ID。

2. 如何确保卖家提交信息后自动创建Stripe账户流程正常？ #

可以从以下几个维度优化：

• 双重字段校验：前端先校验必填字段（姓名、银行账号、路由号、地址等）的格式，后端再重复校验，避免无效请求发送到Stripe。
• 细化错误提示：捕获Stripe错误时，提取具体错误信息（比如e.error.message、e.param），返回给用户精准提示（比如“路由号格式错误”），而不是笼统的报错。
• 增加幂等性保障：创建Stripe账户时传入idempotency_key参数（比如用用户ID+UUID生成），避免重复提交导致创建多个账户。
• 追踪账户状态：在用户模型中新增stripe_account_status字段，记录账户“创建中”“已创建”“需补充信息”“受限”等状态，方便后续排查问题。
• 异步处理API调用：把Stripe账户创建逻辑放到异步任务（如Celery）中执行，避免因API响应慢导致请求超时。
• 完善日志记录：记录所有Stripe API调用的请求参数、响应内容和错误信息，方便调试和问题回溯。

3. 解决「Invalid Request Error: Invalid object」及账户信息不全受限问题 #

关于「Invalid object」错误 #

这个错误通常是请求字段格式不符合Stripe要求，重点检查以下几点：

• 修正外部账户传参：不要直接传入银行账号和路由号，先创建银行账户令牌再传入令牌ID：

  # 创建银行账户令牌
  bank_token = stripe.Token.create(
      bank_account={
          "country": "US",
          "currency": "usd",
          "routing_number": routing_number,
          "account_number": account_number,
      }
  )
  # 创建账户时使用令牌ID
  stripe_account = stripe.Account.create(
      # ... 其他参数
      external_account=bank_token.id,
      # ... 其他参数
  )
  

• 修正TOS时间格式：把tos_acceptance.date改为Unix时间戳：

  tos_acceptance={
      "date": int(datetime.now().timestamp()),
      "ip": request.META.get('REMOTE_ADDR'),
      "user_agent": request.META.get('HTTP_USER_AGENT'),
  }
  

• 处理空值字段：如果user_address.line2为空，传入None而不是空字符串；确保login_user.birth_date是有效的日期对象，避免strftime报错。

关于账户因信息不全被限制 #

Stripe Express账户需要完整的身份验证信息（比如SSN后四位、身份凭证等），仅靠当前传入的字段无法通过验证。建议：

1. 不要一次性强制用户提交所有信息，先创建基础账户。
2. 创建账户后，生成Stripe账户链接（Account Link）引导用户完成身份验证：

   account_link = stripe.AccountLink.create(
       account=stripe_account.id,
       refresh_url="https://your-domain.com/bank-details/",
       return_url="https://your-domain.com/seller-dashboard/",
       type="account_onboarding",
   )
   # 跳转到账户链接让用户补充信息
   return redirect(account_link.url)
   

3. 通过Webhook监听Stripe账户状态变更（比如account.updated），及时同步账户状态到你的系统。

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