Stripe Express Checkout集成报错：缺少支付方式问题排查

问题背景 #

我们的支付流程中，通过PHP创建PaymentIntent，同时提供Stripe Elements（银行卡支付）和Express Checkout（GPay/Apple Pay）表单。Elements功能正常，但Express Checkout执行支付时返回错误。

错误信息 #

You cannot confirm this PaymentIntent because it's missing a payment method. To confirm the PaymentIntent with CUSTOMER_ID, specify a payment method attached to this customer along with the customer ID.

现有代码 #

1. PHP 创建 PaymentIntent #

$options = [
    'customer'                  => $stripeCustomerId,
    'amount'                    => $amount,
    'currency'                  => 'gbp',
    'automatic_payment_methods' => [
        'enabled' => 'true',
    ],
];

2. JS 实例化 Express Checkout #

const expressCheckoutOptions = {
    buttonType: {
        applePay: 'order',
        googlePay: 'order',
    },
    layout: {
        maxColumns: 1,
    }
}

expressElements = stripe.elements({
    mode: 'payment',
    amount: Number(window.payment.payment_amount),
    currency:'gbp',
});

const expressCheckoutElement = expressElements.create('expressCheckout', expressCheckoutOptions)
expressCheckoutElement.mount('#express-checkout');

3. 支付确认逻辑 #

expressCheckoutElement.on('confirm', async (event) => {
    const {error: submitError} = await expressElements.submit();
    if (submitError) {
        showMessage(submitError.message);
        return;
    }

    let clientSecret = 'Our Client Secret'
    const {error} = await stripe.confirmPayment({
        expressElements,
        clientSecret,
        confirmParams: {
            return_url: window.location.href,
        },
        redirect: 'if_required',
    });

    if (error) {
        showMessage(error.message);
    } else {
        console.log('Payment confirmation successful!');
    }
});

解决方案 #

问题核心是：创建PaymentIntent时预先关联了Customer，但Express Checkout流程未将新支付方法附加到该Customer，且确认时缺少明确的支付方法关联逻辑。以下是具体修正步骤：

1. 修复PaymentIntent创建的关键参数 #

原代码中automatic_payment_methods.enabled使用了字符串'true'，Stripe API要求必须是布尔值true，这会导致自动支付方法处理异常。同时根据业务需求选择以下两种方案之一：

方案A：预先关联Customer并自动附加支付方法

适合需要后续自动扣款的场景，添加setup_future_usage参数：

$options = [
    'customer'                  => $stripeCustomerId,
    'amount'                    => $amount,
    'currency'                  => 'gbp',
    'automatic_payment_methods' => [
        'enabled' => true, // 修正为布尔值
    ],
    'setup_future_usage'        => 'off_session', // 让新支付方法自动附加到Customer
];

方案B：确认支付时再关联Customer

适合仅单次支付的场景，创建时不关联Customer：

$options = [
    'amount'                    => $amount,
    'currency'                  => 'gbp',
    'automatic_payment_methods' => [
        'enabled' => true, // 修正为布尔值
    ],
];

2. 修正前端支付确认逻辑 #

• 移除冗余的expressElements.submit()调用：Express Checkout的confirm事件触发后，stripe.confirmPayment会自动处理提交流程，手动调用会干扰支付方法收集。
• 若使用方案B，需在confirmParams中指定Customer ID，让Stripe自动关联新支付方法：

修正后的确认逻辑：

expressCheckoutElement.on('confirm', async (event) => {
    let clientSecret = 'Our Client Secret'
    const {error} = await stripe.confirmPayment({
        expressElements,
        clientSecret,
        confirmParams: {
            return_url: window.location.href,
            // 方案B需添加该行，替换为实际Customer ID变量
            // customer: window.payment.stripeCustomerId,
        },
        redirect: 'if_required',
    });

    if (error) {
        showMessage(error.message);
    } else {
        console.log('Payment confirmation successful!');
    }
});

关键说明 #

当PaymentIntent预先关联Customer时，确认支付必须使用该Customer已绑定的支付方法，或通过setup_future_usage让新支付方法自动绑定；若创建时不关联Customer，确认时指定Customer即可完成绑定与支付。

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