Android端Stripe M2读卡器location为空及蓝牙扫描超时问题求助

核心问题分析 #

你遇到的读卡器字段为空+扫描超时问题，大概率是手动蓝牙配对干扰SDK流程、设备未正确进入可发现模式或读卡器未绑定Stripe账户location导致的，以下是针对性排查步骤：

1. 纠正设备开启操作 #

Stripe M2的正确开启流程：

• 长按电源键2-3秒，直到指示灯持续闪烁蓝色，这才代表设备进入可发现模式
• 你之前“亮一下就熄灭”的状态，是设备仅短暂开机但未进入配对模式，SDK只能扫描到硬件序列号，无法获取账户关联的location信息

2. 移除系统蓝牙配对记录（关键！） #

Stripe Terminal SDK需要独立管理蓝牙连接，提前手动配对会完全干扰SDK的扫描和绑定流程：

• 进入安卓系统蓝牙设置，删除已配对的M2读卡器
• 重启读卡器：长按电源键5秒直到指示灯熄灭，再按正确流程开启到蓝灯闪烁
• 后续禁止手动配对，完全通过SDK的discoverReaders流程处理

3. 调整DiscoveryConfiguration配置 #

• 延长扫描超时时间到30秒，20秒可能不足以完成完整的设备信息同步：

  val config = DiscoveryConfiguration(
      timeout = 30,
      method = DiscoveryMethod.BLUETOOTH_SCAN,
      isSimulated = false
  )
  Terminal.getInstance().discoverReaders(config, 
      object : DiscoveryListener {
          override fun onUpdateDiscoveredReaders(readers: List<Reader>) {
              // 正常情况下，这里返回的Reader应该包含完整的locationId、id等字段
          }
          override fun onBluetoothDisconnectCanceled() {}
          override fun onBluetoothDiscoveryStarted() {}
      },
      object : Callback {
          override fun onSuccess() {}
          override fun onFailure(e: TerminalException) {
              // 若仍超时，优先排查信号和权限问题
          }
      }
  )
  

4. 验证读卡器的Stripe账户绑定状态 #

• 登录Stripe后台，通过你的读卡器序列号（STRM2开头）查询是否已绑定到你的账户，且分配了有效的location
• 如果未绑定，需要先在Stripe后台完成读卡器的激活和location分配，否则SDK无法获取location相关字段

5. 检查SDK版本与权限 #

• 升级到最新版Stripe Terminal SDK（建议2.20以上版本），旧版本可能存在蓝牙兼容性问题
• 确认Manifest添加必要权限：

  <uses-permission android:name="android.permission.BLUETOOTH" />
  <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  <!-- 安卓12及以上需添加 -->
  <uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
  <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
  

• 确保运行时已动态申请ACCESS_FINE_LOCATION、BLUETOOTH_SCAN、BLUETOOTH_CONNECT权限，缺失权限会导致扫描不全或超时

6. 排查蓝牙信号干扰 #

• 确保读卡器与安卓设备距离在1米以内，避免遮挡
• 关闭附近其他蓝牙设备（如耳机、其他读卡器），减少信号干扰
• 安卓12+设备需检查应用是否被允许后台蓝牙扫描，可在系统设置的应用权限中确认

内容的提问来源于stack exchange，提问作者M. Usman Khan