Stripe创建客户门户配置报错：缺失business_profile参数原因排查

问题背景 #

根据Stripe文档，business_profile是创建客户门户配置的必填参数，其子参数为可选项。但调用stripe.billing_portal.Configuration.create时，传入所有子参数设为None的business_profile，却触发错误：

stripe.error.InvalidRequestError: Request req_Z2KfeZdvlmvT: Missing required param: business_profile

调用代码如下：

response = stripe.billing_portal.Configuration.create(
    business_profile={
        'headline': None,
        'privacy_policy_url': None,
        'terms_of_service_url': None
    },
    features={
        'customer_update': {
            'allowed_updates': ['name', 'email', 'address', 'phone'],
            'enabled': True
        },
        'invoice_history': {
            'enabled': True
        },
        'payment_method_update': {
            'enabled': True
        },
        'subscription_cancel': {
            'cancellation_reason': {
                'enabled': True,
                'options': ['too_expensive', 'switched_service', 'unused', 'other']
            },
            'enabled': True,
            'mode': 'immediately',
            'proration_behavior': 'create_prorations'
        },
        'subscription_pause': {
            'enabled': False
        },
        'subscription_update': {
            'default_allowed_updates': [],
            'enabled': False,
            'proration_behavior': 'always_invoice'
        }
    },
    login_page={
        'enabled': True,
    }
)

可能原因及解决办法 #

• 核心原因：Stripe Python SDK的参数过滤机制
  Stripe的Python SDK会自动过滤掉值为None的字段。当你给business_profile下的所有子参数都设置为None时，SDK会移除这些空值字段，最终发送给API的请求中business_profile参数被完全剔除，导致API检测到必填参数缺失。

• 解决办法

  1. 传入空的business_profile字典：

     business_profile={}
     

     文档说明其子参数为可选项，空对象符合API要求。
  2. 至少保留一个子参数并设置有效值（非None）：
     比如设置空字符串或实际可用的URL：

     business_profile={
         'headline': ''
     }
     

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