Stripe零售终端支付：请求支持插卡时识别卡类型并动态定价的API

业务需求与当前问题 #

我们需要在零售支付终端通过Stripe完成金额授权前识别卡类型，执行以下逻辑：

• 调用API识别卡类型
• 判断卡类型为Debit（借记卡）或Credit（信用卡）
• 若为Debit卡，收取固定金额$X
• 其他卡类型收取$X加上额外百分比金额

当前困境：找不到能在插卡状态下识别CardType并在终端实时显示对应金额的API；使用Payment Intent API时，获取卡类型后需发起「Auth + Capture」操作，导致用户必须重新插卡，无法满足流程需求。

可行实现方案 #

利用Stripe Terminal SDK的readReusableCard方法，在不发起支付授权的前提下读取卡类型信息，全程无需用户重复插卡，流程如下：

1. 预读取卡信息：用户插卡后，调用终端SDK的readReusableCard方法，获取卡的元数据（包含funding字段，取值为debit/credit/prepaid），以此判断卡类型。
2. 动态计算金额：根据卡类型计算最终金额——Debit卡用固定金额$X，其他类型用$X加额外百分比费用。
3. 完成支付授权：基于计算后的金额创建Payment Intent，接着调用collectPaymentMethod（卡保持插卡状态）和confirmPaymentIntent完成授权。

关键代码示例（JavaScript SDK） #

// 1. 读取插卡状态下的卡信息
const { card } = await terminal.readReusableCard();
const cardType = card.funding; // 获取卡类型：'debit'/'credit'/'prepaid'

// 2. 请求服务端计算金额并生成Payment Intent（金额逻辑需在服务端实现，避免篡改）
const paymentIntentRes = await fetch('/api/create-stripe-payment-intent', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    baseAmount: X * 100, // Stripe金额单位为分
    cardType: cardType,
    extraPercentage: 0.02 // 示例：额外收取2%费用
  })
}).then(res => res.json());

// 3. 完成支付授权，无需用户重新插卡
await terminal.collectPaymentMethod(paymentIntentRes.clientSecret);
const { paymentIntent } = await terminal.confirmPaymentIntent();

注意事项 #

• readReusableCard仅读取卡信息，不发起授权，不会产生交易记录；
• 金额计算必须在服务端完成，杜绝前端篡改金额的风险；
• 需确认所使用的Stripe终端硬件支持预读取卡信息功能，部分地区终端可能受卡组织规则限制。

内容的提问来源于stack exchange，提问作者Professional Man