Flutter集成Square支付时的Nonce错误排查求助

针对CNOF:xxxxxx nonce报错的处理 #

• CNOF:开头的nonce是客户存档卡片的一次性临时凭证，它和请求时的幂等键（idempotency key）绑定，一旦被使用过或匹配不上对应幂等键，就会触发Card nonce already used with a different idempotency key错误。
• 解决思路：
  • 禁止重复复用CNOF:开头的nonce，每次发起支付前，若需调用用户存档的卡片，需重新获取有效的支付凭证；
  • 更优方案：直接使用存档卡片的id作为支付请求的source_id，而非依赖nonce，从根源避免nonce过期或重复使用的问题。

针对customer_id must be present报错的处理 #

• ccof:开头的nonce是关联到用户档案的卡片凭证，这类凭证属于特定客户，因此发起支付请求时必须同时传入对应的customer_id参数，否则Square无法验证卡片的归属权限，进而报错。
• 解决步骤：
  1. 在支付请求参数中，除了设置source_id为ccof:xxxx（或卡片ID），必须添加customer_id字段，值为该卡片所属用户的Square客户ID；
  2. 确保传入的customer_id与卡片存档时关联的用户ID完全一致，避免传错或遗漏。

额外注意事项 #

• 幂等键规范：每次发起支付请求时生成唯一的幂等键，防止重复请求导致的重复扣费或异常；
• API版本兼容：确认使用的Square SDK/API为最新稳定版，旧版本可能存在凭证处理的兼容性问题；
• 权限校验：确保你的Square账号拥有操作客户存档卡片支付的权限，避免因权限不足引发隐性错误。

内容的提问来源于stack exchange，提问作者Doing Things Occasionally