React Native+Node集成Stripe 3D Secure订阅无法激活问题

核心问题根源 #

非3D Secure支付场景下，支付完成后订阅会自动激活；但3D Secure需要额外的身份验证步骤，此时订阅会先处于incomplete状态，必须在支付Intent成功后主动触发订阅激活操作——这是你当前缺失的关键环节。

前端排查与修复 #

确保3D Secure验证完成后，将成功的支付Intent信息传回后端，触发订阅激活：

// React Native 中处理3D Secure验证的核心代码
import { confirmPayment } from '@stripe/stripe-react-native';

const handleCardPayment = async (clientSecret) => {
  try {
    const { paymentIntent, error } = await confirmPayment(clientSecret, {
      paymentMethodType: 'Card',
    });

    if (error) {
      console.error('3D验证失败:', error.message);
      // 提示用户验证失败
    } else if (paymentIntent.status === 'succeeded') {
      // 验证成功后，立即通知后端激活订阅
      const response = await fetch('https://your-backend.com/api/activate-subscription', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ 
          paymentIntentId: paymentIntent.id,
          subscriptionId: paymentIntent.metadata.subscriptionId // 提前关联的订阅ID
        }),
      });
      const result = await response.json();
      if (result.success) {
        // 订阅激活成功，更新前端状态
      }
    }
  } catch (err) {
    console.error('支付处理异常:', err);
  }
};

后端关键修复步骤 #

1. 创建订阅时设置正确的支付行为 #

创建订阅时必须指定payment_behavior: 'default_incomplete'，让订阅先处于待激活状态：

// Node.js 后端创建订阅的代码
const stripe = require('stripe')(process.env.STRIPE_SECRET_KEY);

const createSubscription = async (customerId, priceId) => {
  const subscription = await stripe.subscriptions.create({
    customer: customerId,
    items: [{ price: priceId }],
    payment_behavior: 'default_incomplete', // 关键配置
    payment_settings: { save_default_payment_method: 'on_subscription' },
    metadata: { 
      // 存入订阅ID，后续支付Intent成功后可关联
      subscriptionId: `sub_${Date.now()}` 
    },
  });

  // 返回订阅的clientSecret给前端，用于触发3D验证
  return {
    subscriptionId: subscription.id,
    clientSecret: subscription.latest_invoice.payment_intent.client_secret
  };
};

2. 处理支付成功后的订阅激活 #

有两种可靠方式激活订阅：

方式一：通过Stripe Webhook（推荐，避免前端网络问题）

监听payment_intent.succeeded事件，自动激活关联的订阅：

// Node.js 后端Stripe Webhook处理
app.post('/stripe-webhook', express.raw({ type: 'application/json' }), async (req, res) => {
  const sig = req.headers['stripe-signature'];
  let event;

  try {
    event = stripe.webhooks.constructEvent(
      req.body,
      sig,
      process.env.STRIPE_WEBHOOK_SECRET
    );
  } catch (err) {
    return res.status(400).send(`Webhook Error: ${err.message}`);
  }

  if (event.type === 'payment_intent.succeeded') {
    const paymentIntent = event.data.object;
    const subscriptionId = paymentIntent.metadata.subscriptionId;

    if (subscriptionId) {
      try {
        // 激活订阅
        await stripe.subscriptions.confirm(subscriptionId);
        console.log(`订阅 ${subscriptionId} 已激活`);
      } catch (err) {
        console.error('激活订阅失败:', err);
      }
    }
  }

  res.json({ received: true });
});

方式二：接收前端的验证成功通知

如果前端能稳定回调，也可以直接通过接口触发激活：

// Node.js 后端激活订阅接口
app.post('/api/activate-subscription', async (req, res) => {
  const { paymentIntentId, subscriptionId } = req.body;

  try {
    // 校验支付Intent状态确实为成功
    const paymentIntent = await stripe.paymentIntents.retrieve(paymentIntentId);
    if (paymentIntent.status !== 'succeeded') {
      return res.status(400).json({ success: false, message: '支付未完成' });
    }

    // 激活订阅
    const subscription = await stripe.subscriptions.confirm(subscriptionId);
    res.json({ success: true, subscription });
  } catch (err) {
    res.status(500).json({ success: false, message: err.message });
  }
});

验证与排查技巧 #

1. 登录Stripe仪表盘，查看订阅列表中目标订阅的状态：如果是incomplete，说明支付已完成但未触发激活；
2. 手动调用Stripe API subscriptions.confirm传入订阅ID，看是否能激活——如果能，说明你的自动激活逻辑存在问题；
3. 检查Webhook的事件日志，确认payment_intent.succeeded事件是否被正确接收和处理；

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