Flutter集成Stripe Bancontact支付报错：需提供return_url

错误提示明确指出，确认Bancontact类型的PaymentIntent时必须提供return_url，问题出在你当前的代码流程上：单独创建PaymentMethod后再调用confirmPayment的方式不适合Bancontact这类需要重定向的支付方式，且你没有在确认流程中传入return_url参数。

解决方案 #

直接在confirmPayment中通过ConfirmPaymentParams同时传入支付方法参数和return_url，无需单独调用createPaymentMethod。具体修改如下：

Future stripeBanContact({
  required String clientSecret,
}) async {
  Stripe.publishableKey = '你的Publishable Key';
  
  // 替换为你的App已配置的深链接/通用链接，用于支付完成后跳转回App
  const returnUrl = 'yourapp://stripe-payment-redirect';

  await Stripe.instance.confirmPayment(
    paymentIntentClientSecret: clientSecret,
    params: ConfirmPaymentParams(
      paymentMethodParams: PaymentMethodParams.bancontact(
        paymentMethodData: PaymentMethodData(
          billingDetails: BillingDetails(
            name: "用户姓名",
            email: "用户邮箱",
            phone: "用户电话",
          ),
        ),
      ),
      returnUrl: returnUrl,
    ),
  );
}

关键注意事项 #

• returnUrl配置：必须使用你的App已注册的深链接或通用链接（比如yourapp://xxx），确保App能处理该链接的跳转，否则支付完成后无法回到你的应用。
• 避免单独创建PaymentMethod：Bancontact支付需要Stripe在确认流程中统一处理支付方法创建和重定向逻辑，分开调用会导致参数缺失。
• 后端配合：后端创建PaymentIntent时，需确保payment_method_types包含bancontact字段，否则前端会出现支付方法不支持的错误。

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