Stripe关联账户上线后显示受限的问题求助

问题背景 #

使用Stripe测试密钥可创建具备card_payments（收款）和transfers（付款）权限的关联账户，但切换到生产环境后，创建的关联账户在Stripe控制台显示权限受限。后端采用AWS Lambda编写Python代码，包含两个Lambda函数：一个用于生成Stripe账户ID，另一个用于生成账户创建链接。测试环境下代码运行正常，现询问问题原因、是否有类似案例，以及是否需要添加更多参数。

代码实现 #

创建Stripe账户的Lambda函数 #

import json
import http.client
import urllib.parse

def create_stripe_account(user_name, email):
    user_name = user_name
    email = email
    
    url = "https://api.stripe.com/v1/accounts"
    api_key = "sk_live_123"
    
    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/x-www-form-urlencoded"
    }
    print("log-1")
    
    parameters = {
        "type": "express",
        "country": "US",
        "email": email,
        "capabilities[card_payments][requested]": True,
        "capabilities[transfers][requested]": True,
        "business_type": "individual",
        "business_profile[mcc]": 5971,
        "business_profile[name]": user_name,
        "business_profile[product_description]": "Artwork"
    }
    print("log-2")
    
    encoded_parameters = urllib.parse.urlencode(parameters)
    request_body = encoded_parameters.encode("utf-8")
    print("log-3")
    
    conn = http.client.HTTPSConnection("api.stripe.com")
    conn.request("POST", url, body=request_body, headers=headers)
    response = conn.getresponse()
    print("log-4")
    
    if response.status == 200:
        response_data = response.read().decode("utf-8")
        return response_data, response.status
    else:
        print(f"Error: Invalid HTTP response ({response.status})")
        response_data = response.read().decode("utf-8")
        print(f"Response data: {response_data}")
        return response_data, response.status

生成账户创建链接的Lambda函数 #

import json
import http.client
import urllib.parse
import json

def create_account_link(stripe_account_id):
    stripe_account_id = stripe_account_id
    test_flight_url = "https://testflight.apple.com/join/57vVCOVf"
    
    # Define the URL and API key
    url = "https://api.stripe.com/v1/account_links"
    api_key = "sk_live_123"

    # Define the parameters
    parameters = {
        "account": stripe_account_id,
        "refresh_url": test_flight_url,
        "return_url": test_flight_url,
        "type": "account_onboarding"
    }

    # Encode the parameters
    encoded_parameters = urllib.parse.urlencode(parameters)
    body = encoded_parameters.encode("utf-8")

    # Define the headers
    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/x-www-form-urlencoded"
    }

    # Establish connection
    conn = http.client.HTTPSConnection("api.stripe.com")

    # Send POST request
    conn.request("POST", url, body, headers)

    # Get response
    response = conn.getresponse()

    # Read and decode response data
    response_data = response.read().decode("utf-8")

    # Print response status code and data
    print("Status Code:", response.status)
    print("Response:", response_data)

    if response.status == 200:
        return response_data, response.status
    else:
        print(f"Error: Invalid HTTP response ({response.status})")
        print(f"Response data: {response_data}")
        return response_data, response.status

问题解答 #

常见原因分析 #

• 生产环境合规审核未完成：测试环境下Stripe会跳过真实合规校验，但生产环境中，关联账户必须完成身份验证、业务信息提交等审核流程才能激活权限。如果用户未通过账户链接完成所有必填项填写，账户会处于受限状态。
• 权限激活的前置条件未满足：虽然代码中设置了权限请求参数，但生产环境中Stripe需要额外的验证信息（如美国个人账户的SSN后四位、地址凭证等）才能激活权限，信息缺失会导致权限被限制。
• 账户引导流程未执行：生成的账户链接需要用户实际访问并完成所有Stripe要求的onboarding步骤，未完成的话权限不会被激活，控制台会显示受限。
• 主账户生产配置未完成：如果你的主Stripe账户未完成生产环境激活（如提交企业信息、验证银行账户等），关联账户的权限也会受到影响。

是否有类似案例？ #

大量开发者在测试环境切换到生产环境时遇到过同类问题，核心原因基本都是忽略了生产环境的合规审核要求，在Stripe社区及技术论坛中这类讨论非常普遍，解决思路大多围绕完善关联账户的onboarding流程和主账户的生产配置展开。

是否需要添加更多参数？ #

是的，建议补充以下参数以加速权限激活：

1. 个人基础信息：针对美国个人账户，添加individual[first_name]、individual[last_name]、individual[address][line1]、individual[address][city]、individual[address][state]、individual[address][postal_code]等字段，减少后续用户需要填写的信息。
2. 服务条款确认：添加tos_acceptance[date]（Unix时间戳）和tos_acceptance[ip]（用户实际访问IP），明确用户已同意Stripe服务条款，这是生产环境激活权限的必要条件。
3. 账户链接参数优化：在生成账户链接时添加collect: "currently_due"参数，确保链接引导用户完成所有当前必填的验证项。

修改后的创建账户参数示例：

parameters = {
    "type": "express",
    "country": "US",
    "email": email,
    "capabilities[card_payments][requested]": True,
    "capabilities[transfers][requested]": True,
    "business_type": "individual",
    "business_profile[mcc]": 5971,
    "business_profile[name]": user_name,
    "business_profile[product_description]": "Artwork",
    "individual[first_name]": "John",
    "individual[last_name]": "Doe",
    "individual[address][line1]": "123 Main St",
    "individual[address][city]": "San Francisco",
    "individual[address][state]": "CA",
    "individual[address][postal_code]": "94105",
    "tos_acceptance[date]": int(time.time()),
    "tos_acceptance[ip]": "用户实际访问IP"
}

修改后的账户链接参数示例：

parameters = {
    "account": stripe_account_id,
    "refresh_url": test_flight_url,
    "return_url": test_flight_url,
    "type": "account_onboarding",
    "collect": "currently_due"
}

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