如何在Stripe Terminal实现客户输邮箱+刷卡支付？模拟器检测异常求助

一、解决模拟器无法被检测到的问题 #

按以下步骤排查：

• 确认Stripe CLI已登录测试环境：执行stripe login --test-mode，确保使用测试密钥，不要混淆生产环境密钥
• 检查模拟器状态：在Stripe测试控制台的Terminal > Readers页面，确认simulated-reader的状态为online；若为offline，重启Stripe CLI终端服务：stripe terminal serve
• 验证代码查询逻辑：使用测试环境API密钥，调用stripe.terminal.readers.list({status: 'online'})时避免额外过滤条件，也可直接通过读卡器ID调用stripe.terminal.readers.retrieve('你的模拟器ID')测试
• 排查网络端口：Stripe CLI的terminal serve默认使用127.0.0.1:1111，确保NodeJS服务能访问该地址，无防火墙或代理拦截

二、实现终端输入邮箱+刷卡支付的Beta流程 #

collect_inputs属于Beta功能，需先开通权限，再按以下步骤实现：

1. 开通Beta权限：在Stripe Dashboard的Beta页面申请Terminal Collect Inputs权限，或直接联系Stripe支持开通
2. 创建Payment Intent：生成与订阅关联的Payment Intent（若为订阅初始扣费，也可使用Setup Intent），代码示例：

const paymentIntent = await stripe.paymentIntents.create({
  amount: 1000, // 单位为分，根据订阅金额调整
  currency: 'usd',
  payment_method_types: ['card_present'],
  setup_future_usage: 'off_session', // 用于后续订阅自动扣费
  metadata: {
    customer_email: '' // 预留字段存储终端收集的邮箱
  }
});

3. 调用Collect Inputs收集邮箱：通过模拟器ID触发终端收集邮箱操作：

const collectResult = await stripe.terminal.readers.collectInputs(
  '你的模拟器ID',
  {
    inputs: [{type: 'email', label: '请输入您的邮箱'}],
    customer_consent_collected: true // 需确认已获得用户收集信息的同意
  }
);

4. 获取并存储邮箱：从返回结果中提取邮箱，更新Payment Intent的metadata或关联到Customer对象：

const customerEmail = collectResult.inputs[0].value;
await stripe.paymentIntents.update(paymentIntent.id, {
  metadata: {customer_email: customerEmail}
});
// 也可直接关联到客户：
// await stripe.customers.update('客户ID', {email: customerEmail});

5. 触发终端刷卡支付：调用接口完成支付流程：

const paymentResult = await stripe.terminal.readers.processPaymentIntent(
  '你的模拟器ID',
  {payment_intent: paymentIntent.id}
);

6. 关联到订阅：支付成功后，将生成的Payment Method关联到客户的订阅，或直接创建订阅时使用该Payment Method

注意事项 #

• Beta功能可能存在更新，需关注官方文档变动
• 真实终端设备的流程与模拟器完全一致，确保设备配对成功并在线
• 收集用户邮箱需符合当地隐私法规（如GDPR），必须获得用户明确同意

内容的提问来源于stack exchange，提问作者Leonardo Sasso