Flutter集成Stripe时Payment Sheet初始化返回null致支付失败

问题核心 #

能正常获取Payment Intent的client_secret，但initPaymentSheet()返回null，支付Sheet弹出后点击支付失败。

排查与修复步骤 #

1. 修正Stripe初始化逻辑 #

确保App启动时正确初始化Stripe SDK，包含公钥及必要的商户标识：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Stripe.instance.initialize(
    publishableKey: '你的测试公钥（pk_test_xxx）',
    merchantIdentifier: 'merchant.com.你的应用包名', // Apple Pay等场景必填
  );
  runApp(const MyApp());
}

2. 修复Payment Intent请求格式 #

Stripe API要求请求体为x-www-form-urlencoded格式，原代码直接传Map会导致编码错误；同时注意金额需传入最小货币单位（比如10美元要传'1000'，代表1000美分）：

Future<Map<String, dynamic>> createPaymentIntent(
    String amount, String currency) async {
  final Map<String, String> body = {
    'amount': amount, // 必须是最小单位，例如USD用分、EUR用欧分
    'currency': currency,
  };

  const String secretKey = '你的测试密钥（sk_test_xxx）';

  final response = await http.post(
    Uri.parse('https://api.stripe.com/v1/payment_intents'),
    headers: {
      'Authorization': 'Bearer $secretKey',
      'Content-Type': 'application/x-www-form-urlencoded',
    },
    body: Uri.encodeQueryParameters(body), // 转换为正确的表单编码
  );

  if (response.statusCode == 200) {
    return json.decode(response.body);
  } else {
    // 打印详细错误信息用于排查
    debugPrint('Stripe API错误详情: ${response.body}');
    throw Exception('创建Payment Intent失败: ${response.body}');
  }
}

3. 完善支付Sheet的错误捕获 #

原displayPaymentSheet()未处理异常，添加错误捕获可获取具体失败原因：

Future<void> displayPaymentSheet() async {
  try {
    final paymentResult = await Stripe.instance.presentPaymentSheet();
    logger.d('支付结果: $paymentResult');
    if (paymentResult.paymentIntentStatus == PaymentIntentsStatus.succeeded) {
      // 处理支付成功逻辑
    }
  } on StripeException catch (e) {
    debugPrint('Stripe支付错误: ${e.error.localizedMessage}');
    debugPrint('错误码: ${e.error.code}');
  } catch (e) {
    debugPrint('未知错误: $e');
  }
}

4. 关键检查项 #

• 密钥环境匹配：测试环境必须使用测试密钥（pk_test_/sk_test_），禁止混用生产密钥
• 测试卡号验证：使用Stripe官方测试卡号4242 4242 4242 4242，过期日期选未来任意月份/年份，CVC填任意3位数字
• Payment Intent状态：创建成功后打印完整paymentIntent，确认status为requires_payment_method
• SDK版本兼容性：确保flutter_stripe SDK版本为最新稳定版，避免版本bug

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