我们通过用专用功能令牌替换静态密钥，来增强订单状态 URL 的安全性。此变更有助于保护客户数据，同时让您对 URL 访问模式拥有更多控制权。
变更内容
订单状态 URL 现在使用动态生成的功能令牌，而非静态密钥参数。这些令牌通过限制使用次数和自动过期机制提供更好的安全性。与之前将令牌存储在数据库中的方法不同，这些令牌是在创建订单状态 URL 时按需生成的。这消除了令牌存储和管理的需求，从而提升了安全性。
如何使用新令牌
生成订单状态 URL 时，您现在可以指定两个可选参数：
- notification_usage_usage：交付渠道。
- WEB WEB（默认）：适用于大多数用例，包括电子邮件。
- SMS
- audienceaudience：预期接收者。
- CUSTOMERVIEW CUSTOMERVIEW（默认）：面向客户。将通过通知发送，供稍后打开查看。
- MERCHANTVIEWMERCHANTVIEW：面向商户。可立即用于预览订单状态页面。
这两个参数共同决定令牌的配置，包括过期时间。请确保选择正确的组合，以获取符合您预期用例安全要求的令牌。
配置概览如下：
| 用途 | 受众 | 配置 |
|---|---|---|
| WEB | CUSTOMERVIEW | 最多使用 5 次，15 天后过期 |
| WEB | MERCHANTVIEW | 使用1次，有效期为1分钟 |
| SMS | 任意 | 使用2次，有效期为15天 |
请注意，根据反馈和不断变化的安全需求，未来可能会调整令牌配置及其用例。请密切关注更新，以确保您的实现保持安全且最新。
URL长度考量
在使用WEB交付的功能令牌时，生成的URL将比之前的静态密钥实现方式长得多（约800个字符），这种增加的长度是由于令牌中编码了额外的安全信息。
时间线与向后兼容性
在接下来的三个月内，未使用这些参数的URL将继续使用现有的secret_token方法。2025年8月1日之后，所有URL将默认使用为Web客户视图配置的功能令牌。
后续步骤
审查您的实现，以确定是否需要根据您的用例更新代码以指定这些参数。在过渡期间，大多数实现无需更改即可正常运行。