Stripe验证后更新身份文档问题及API操作咨询

问题概述 #

已完成验证的Stripe账户因新规要求提交SSN，上传后仍未通过验证，怀疑需更新身份文档。计划通过API重新上传，但不确定API正确性及需更新的具体内容，持有Stripe密钥、用户SSN及身份文档。

错误提示 #

当前参考代码（待确认） #

Stripe.api_key = 'sk_test_wsIteSi2J2OE0UivD0tzS5aw'

Stripe::Account.update_person(
  '{{CONNECTED_ACCOUNT_ID}}',
  '{{PERSON_ID}}',
  {verification: {document: {front: 'file_5dtoJkOhAxrMWb'}}},
)

解决方案 #

1. 先明确需更新的验证项 #

操作前先通过API获取当前个人身份信息的验证状态，精准定位问题：

# 获取关联账户的个人身份详情
person = Stripe::Account.retrieve_person(
  '{{CONNECTED_ACCOUNT_ID}}',
  '{{PERSON_ID}}'
)
# 打印验证要求，查看未通过的具体原因
puts person.verification.requirements

输出会明确告知是缺少身份文档、SSN信息不全，还是文档不符合规范等。

2. 正确上传身份文档 #

你的代码方向是对的，但需注意两个关键点：

• file_xxx必须是通过Stripe文件上传接口预先上传文档后得到的有效文件ID，不能直接使用示例值。
• 若Stripe要求上传文档反面，需补充back字段：

Stripe::Account.update_person(
  '{{CONNECTED_ACCOUNT_ID}}',
  '{{PERSON_ID}}',
  {
    verification: {
      document: {
        front: 'file_实际上传后的有效ID',
        back: 'file_实际上传后的有效ID' # 仅当要求上传反面时添加
      }
    }
  }
)

3. 补全SSN信息（若未提交完整） #

如果SSN仅提交了部分内容，根据Stripe要求补充：

Stripe::Account.update_person(
  '{{CONNECTED_ACCOUNT_ID}}',
  '{{PERSON_ID}}',
  {
    ssn_last_4: '1234', # 多数地区仅需后4位
    # 部分地区可能需要完整SSN：ssn: '123-45-6789'
  }
)

4. 验证更新结果 #

操作完成后，重新获取个人身份信息，检查验证状态：

person = Stripe::Account.retrieve_person(
  '{{CONNECTED_ACCOUNT_ID}}',
  '{{PERSON_ID}}'
)
puts person.verification.status # 若显示verified则验证通过

关键注意事项 #

• 确保使用对应环境的API密钥：测试环境用sk_test_xxx，生产环境用sk_live_xxx。
• 上传的文档需符合规范：清晰无遮挡，格式为JPG/PNG/PDF，大小不超过10MB。
• 若API操作后仍未解决，直接查看Stripe后台的账户验证页面，会有更直观的错误提示和操作指引。

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