什么是钱包批准？如何撤销Token权限？

钱包批准定义

1. 钱包批准是指用户明确同意第三方应用程序或服务访问其数字钱包内的特定资源或功能。

2. 此过程通常通过 OAuth 2.0 授权流程进行，其中用户被重定向到安全钱包界面，并提示确认权限，例如查看余额、启动转账或管理存储的凭据。

3. 批准生成authCode和authState ，两者都通过预定义的authRedirectUrl传回商家。

4. 严格执行批准的范围——只有在授权请求期间明确列出的范围才能由客户端应用程序执行。

5. 每个审批都绑定特定的customerBelongsTo标识符，确保三星钱包、苹果钱包、华为钱包云等不同钱包生态系统之间的隔离。

令牌撤销机制

1. 令牌撤销会终止与钱包授权期间颁发的access_token或refresh_token关联的活动会话权限。

2. 有效的client_id必须与原始授权请求中使用的client_id匹配；包含团队 ID 或其他标识符将使撤销尝试无效。

3. 该请求需要 JWT 格式的签名client_secret ，该密钥是使用在钱包提供商的开发者门户注册的私钥生成的。

4. token_type_hint参数有助于优化服务器端验证，但不是强制的 — 如果省略，系统将执行内部令牌类型检测。

5. 成功撤销返回 HTTP 200，JSON 正文为空；一旦收到此响应，客户端无需采取进一步操作。

访问令牌获取流程

1. 访问令牌作为短期凭证，支持对华为钱包云或三星钱包后端系统等钱包云服务进行经过身份验证的 API 调用。

2. 令牌获取端点使用具有application/x-www-form-urlencoded内容类型的 HTTPS POST 并强制grant_type=client_credentials 。

3. 根据规范， client_id和client_secret都必须作为用双引号引起来的字符串文字进行传输。

4. 响应包括access_token 、设置为“Bearer”的token_type以及可选的expires_in指示生命周期（以秒为单位）。

5. 除非在钱包提供商的管理控制台或合作伙伴入门仪表板中进行其他配置，否则令牌将在默认 3600 秒后过期。

通知模板生命周期

1. 合作伙伴必须通过合作伙伴门户注册消息模板，然后才能向钱包持卡人发送推送通知。

2. 模板经过自动危害验证检查是否存在禁止的表达，结果显示为“通过”或“失败”以及标记的内容。

3. 被拒绝的模板会触发包含管理员评论的电子邮件通知；合作伙伴可以在解决引用的问题后进行修改并重新提交。

4. 仅允许商户推送类型通知，消息类型仅限于营销或其他类别。

5. 多语言支持需要为常规信息设置下添加的每种语言添加单独的模板条目。

卡状态同步协议

1. 只要用户设备上的卡状态发生变化，三星钱包就会向预先配置的合作伙伴服务器发送实时状态更新（例如“已添加”、“已更新”或“已删除”）。

2. 这些事件是使用发送卡状态 API 端点通过服务器到服务器 HTTPS 回调传递的。

3. 合作伙伴服务器必须可公开访问，并且能够接收和解析包含 cardId、状态、时间戳和设备元数据的 JSON 有效负载。

4. 发卡状态验证要求钱包卡模板在测试前处于 VERIFYING 或 ACTIVE 状态。

5. 集成依赖于三星电子钱包的成功完成，包括证书配置和域白名单。

常见问题解答

问：被撤销的Token重新授权后可以重新使用吗？答：不会。一旦撤销，无论后续尝试如何授权，令牌都会永久无效。

问：authState 值是否需要加密随机？答：是的。它必须是每个授权请求生成的唯一的、不可预测的值，以防止 CSRF 攻击。

问：如果 authRedirectUrl 包含未编码的特殊字符，会发生什么情况？答：由于 URI 编码要求格式错误，钱包服务器拒绝请求并返回 HTTP 400 错误。

问：令牌撤销是否会影响共享相同 client_id 的其他用户？答：不会。撤销在单个用户令牌级别进行，不会影响授予其他用户的权限。