Stripe Checkout API：为订阅模式设置自定义账单描述符

在Stripe Checkout的订阅（subscription）模式中，你可以通过两种方式在subscription_data里配置自定义账单描述符：

方式一：直接在subscription_data中设置 #

这种方式会将描述符设为该订阅所有后续发票的默认值：

Session::create([
    'payment_method_types' => ['card'],
    'success_url' => 'https://example.com/success',
    'cancel_url' => 'https://example.com/cancel',
    'line_items' => [...],
    'mode' => 'subscription',
    'subscription_data' => [
        'statement_descriptor' => '你的自定义描述',
        // 可添加其他订阅相关配置，如trial_period_days等
    ]
]);

方式二：通过invoice_settings嵌套配置 #

如果需要更细致地控制发票对应的支付意图参数，可通过invoice_settings.payment_intent_data设置：

Session::create([
    'payment_method_types' => ['card'],
    'success_url' => 'https://example.com/success',
    'cancel_url' => 'https://example.com/cancel',
    'line_items' => [...],
    'mode' => 'subscription',
    'subscription_data' => [
        'invoice_settings' => [
            'payment_intent_data' => [
                'statement_descriptor' => '你的自定义描述',
            ]
        ],
        // 可添加其他订阅相关配置
    ]
]);

注意事项 #

• 账单描述符最多允许22个字符，仅可包含字母、数字、空格以及-、.、*、'这些符号
• 描述内容不能包含敏感、误导性信息，需符合Stripe的合规要求

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