如何向特定Square设备推送APNS通知？

我遇到过类似的场景，分享几个不需要重构自定义POS的实用方案，应该能帮你精准推送通知：

核心方案：利用Square Devices API + Webhook中的设备ID关联 #

这是最直接的解决方案，完全基于Square现有API，不需要额外开发复杂功能：

1. 在商家注册流程中补充设备关联步骤

   • 当商家完成Square认证后，你的应用调用Square的ListDevices API（传入商家的location_id），获取该门店下所有已注册的Square POS设备列表。
   • 在应用本地获取设备的硬件标识（比如iOS的identifierForVendor），和Square Devices返回结果中的hardware_id做匹配；如果商家给设备设置了自定义名称（比如“前台收款平板”），也可以让商家手动选择对应设备，确保匹配到当前设备的Square device_id。
   • 将Square的device_id、你的应用的APNS device token、以及location_id三者关联存储到你的SQL数据库中。

2. 在Webhook中精准匹配推送目标

   • 当收到Square的PAYMENT_UPDATED通知时，解析payload里的payment.device_details.device_id（现金支付场景下，Square POS设备发起的收款都会返回这个字段，可参考Square官方文档确认）。
   • 用这个device_id去你的数据库中查询对应的APNS token，只给该token推送通知，就能避免所有设备都收到消息的问题。

注意：调用Square Devices API需要申请DEVICE_READ权限，记得在商家授权流程中添加这个权限申请。

备选方案：基于门店+设备上下文的关联（适合特殊场景） #

如果某些情况下device_details字段缺失（比如极个别旧款Square设备），可以用这个方案兜底：

• 在商家的应用设置中，添加“绑定默认收款设备”的选项，让商家手动选择当前应用设备对应的Square POS设备（通过设备名称区分）。
• 将location_id、Square设备名称、APNS token关联存储，收到Webhook时先通过location_id筛选该门店的所有设备，再结合商家设置的默认设备匹配token推送。

为什么不需要自定义POS？ #

你提到的自定义POS确实是杀鸡用牛刀，上面的方案只需要在现有注册流程中增加几步API调用和数据存储，完全基于Square的原生POS功能就能实现精准推送。

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