Flutter获取Stripe Token报错：缺少required参数paymentMethodData

一、错误原因及修复方法 #

你遇到的错误是因为Stripe Flutter SDK版本更新，PaymentMethodParams.card()的参数结构发生了变化。旧版本直接传入卡片字段的写法已经失效，新版本要求将卡片信息封装到paymentMethodData参数中。

修改getStripeToken函数的代码即可解决：

Future<String?> getStripeToken({
  required String cardNumber,
  required int expMonth,
  required int expYear,
  required String cvc,
}) async {
  try {
    final PaymentMethod paymentMethod = await Stripe.instance.createPaymentMethod(
      PaymentMethodParams.card(
        paymentMethodData: PaymentMethodData(
          card: CardDetails(
            number: cardNumber,
            expMonth: expMonth,
            expYear: expYear,
            cvc: cvc,
          ),
        ),
      ),
    );

    return paymentMethod.id;
  } catch (e) {
    print('获取Stripe Token失败: $e');
    return null;
  }
}

核心变化是把原来直接传入的卡片字段，放到PaymentMethodParams.card()的paymentMethodData -> card层级下。

二、替代解决方案 #

1. 使用Stripe官方推荐的Payment Element（更合规安全） #

Stripe现在推荐使用预构建的Payment Element来收集卡片信息，无需手动处理卡号、有效期等字段，既简化开发又符合PCI合规要求：

Future<String?> getStripeTokenWithPaymentElement() async {
  try {
    // 初始化Payment Element
    final elements = await Stripe.instance.createPaymentElement(
      PaymentElementOptions(),
    );

    // 确认元素加载完成后，创建PaymentMethod
    final paymentMethod = await Stripe.instance.createPaymentMethodFromElement(
      elements,
    );

    return paymentMethod.id;
  } catch (e) {
    print('通过Payment Element获取Token失败: $e');
    return null;
  }
}

这种方式不需要手动处理卡片输入，用户体验更好，也减少了安全风险。

2. 直接创建Stripe Token（旧版方式，仅兼容旧SDK） #

如果你的项目依赖旧版Stripe SDK（比如stripe_flutter < 9.0），可以直接使用createToken方法获取Token：

Future<String?> getStripeTokenLegacy({
  required String cardNumber,
  required int expMonth,
  required int expYear,
  required String cvc,
}) async {
  try {
    final Token token = await Stripe.instance.createToken(
      TokenParams.card(
        number: cardNumber,
        expMonth: expMonth,
        expYear: expYear,
        cvc: cvc,
      ),
    );

    return token.id;
  } catch (e) {
    print('旧版方式获取Token失败: $e');
    return null;
  }
}

注意：Stripe官方已经逐步淘汰Token方式，推荐使用PaymentMethod，所以不建议长期使用这个方案。

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