You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在Stripe中独立接收波兰Blik支付?遇TS错误及会话异常

解决Stripe Checkout集成Blik支付的TypeScript错误及会话异常问题

TypeScript错误:Type '"blik"' is not assignable to type 'PaymentMethodType'

原因

Stripe官方TypeScript类型定义中,PaymentMethodType枚举可能未包含'blik'值,或是你使用的Stripe SDK版本过旧,不支持Blik作为独立支付方式的类型声明。

解决方案

  1. 升级Stripe SDK至最新版本
    运行以下命令更新依赖,确保SDK版本包含Blik的类型支持:
    npm install stripe@latest
    # 或使用yarn
    yarn add stripe@latest
    
  2. 类型断言绕过检查(临时方案)
    若升级后仍存在类型问题,可通过类型断言强制TS识别'blik'为合法类型:
    const session = await stripe.checkout.sessions.create({
      payment_method_types: ['blik'] as const,
      // 其他必填参数:mode、line_items、success_url、cancel_url等
    });
    

会话创建后无跳转、状态显示Incomplete且无支付方式

原因

忽略TS错误直接创建会话时,可能存在以下问题:

  • Stripe账号未开通Blik支付权限
  • Checkout Session缺少必填参数
  • 支付地区配置错误
  • API请求存在隐性参数错误(未被TS捕获)

解决方案

  1. 确认账号已启用Blik支付
    登录Stripe仪表盘,进入「支付方式」设置页面,检查是否已启用Blik,且账号支持波兰(PL)地区的支付业务。
  2. 检查会话必填参数完整性
    确保创建会话时包含以下必填项:
    const session = await stripe.checkout.sessions.create({
      payment_method_types: ['blik'],
      mode: 'payment', // 或'subscription',根据业务需求选择
      line_items: [
        {
          price: '你的价格ID',
          quantity: 1,
        },
      ],
      success_url: 'https://你的域名.com/success',
      cancel_url: 'https://你的域名.com/cancel',
    });
    
  3. 查看Stripe API日志定位错误
    进入Stripe仪表盘「开发工具」→「日志」,找到创建Checkout Session的请求记录,查看返回的详细错误信息(如参数非法、权限不足等),这是定位问题最直接的方式。
  4. 配置正确的地区信息
    Blik仅支持波兰地区,可通过payment_intent_data指定支付地区:
    payment_intent_data: {
      shipping: {
        address: {
          country: 'PL',
        },
      },
    }
    

内容的提问来源于stack exchange,提问作者seven

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.25 23:06:32