旅行时已缓存汇率如何工作

App 会下载和保存什么

正式环境使用 Frankfurter 的公开 v2 API，无需 API 密钥。刷新时会请求所选基础货币以及 App 支持的报价货币，响应中包含汇率记录和数据提供方日期。Price Tag FX 会把这些记录转换为快照，在本次使用期间保留在内存中，并将 JSON 缓存写入 App 私有的 Application Support 目录。快照按基础货币保存，同时保留旧的单文件缓存以兼容迁移。

汇率请求不需要扫描图片、OCR 文字、商品名称、手动输入金额或换算结果。数据提供商仍会看到一般网络元数据以及请求中的货币代码。Frankfurter 提供的是参考数据，并不是实际执行交易的发卡机构、商户或现金兑换点。

1. 在网络稳定时选择目的地市场。
2. 打开 App，让本次使用的预加载流程获取或验证可用汇率快照。
3. 在汇率信息页面查看数据新鲜度和上次刷新时间。
4. 如果旅程会经过使用其他货币的地区，请为另一个基础市场重复这些步骤。

• 快照按基础货币持久保存。
• 当一个快照中同时存在两种货币的汇率时，可以通过该快照的基础货币进行交叉换算。
• 可选择的货币有时可能暂时不在数据提供商的当前覆盖范围内。
• 汇率请求包含货币元数据，不包含购物内容。

来源： Frankfurter v2 文档

“最新”“已缓存”和“已过期”是状态标签

在设备当前本地日期下载的快照会标为“最新”。之后到第 14 天之前，状态会显示为“已缓存”，并附带缓存时间；达到 14 天或更久后则标为“已过期”。只要过期快照覆盖所选货币对，换算功能不会自动拒绝它，因此 App 仍可离线提供估值，同时把数据时间清楚显示出来。是否适合用于本次购买，需要由用户自行判断。

本次使用的预加载流程采用更细的 12 小时窗口。如果缓存覆盖所请求的报价货币，且未超过 12 小时，本次使用期间就不会再向数据提供商请求同一基础货币；超过该窗口时，App 会尝试获取新快照。如果获取失败，会先回退到所请求基础货币的缓存，再尝试最新的受支持快照，但前提是该快照确实能够换算所选货币。

1. 查看数据状态，不要把“已缓存”理解为“当前实时”。
2. 购买高价商品前，如有网络连接，请先刷新汇率。
3. 离线时确认结果显示了有意义的最后更新时间。
4. 如果市场波动过大或缓存太旧，应自行决定不采用该估值。

• 12 小时决定自动预加载何时尝试刷新。
• 14 天决定何时显示“已过期”状态。
• “已过期”并不表示数据已删除，而是提醒你需要格外谨慎。
• 没有覆盖所选货币对的快照，就无法离线换算。

手动刷新受不同使用方案的冷却时间限制

“手动换算”的汇率信息面板提供用户主动刷新功能。免费用户从上次尝试起每 86,400 秒可以尝试一次。付费权限——无论是永久解锁，还是仍在有效期内的 7 天或 30 天非续订通行证——都会把冷却时间缩短到 30 秒。App 会在数据提供商请求完成前记录本次尝试，因此即使请求超时或服务失败，也可能开始计算冷却时间。

这一行为支持“Pro 可更频繁地手动刷新”这样的表述，但不能宣传为真正无限的实时汇率流。换算始终使用已经获得的快照；按下刷新会请求新快照，然后重新计算当前手动换算结果。即使暂时无法再次刷新，只要缓存仍有效，价格显示也应继续使用该缓存。

1. 打开“手动换算”和汇率信息面板。
2. 请求刷新前先查看当前状态。
3. 只在网络连接较为可靠时刷新。
4. 操作受限时，等待当前使用方案的冷却时间结束。

• 免费：从上次尝试起每 24 小时可尝试一次。
• 付费：每 30 秒可尝试一次。
• 失败的尝试也可能占用刷新间隔。
• 旅行通行证从购买时开始计时，不会自动续订。

为真实旅行环境做好准备

乘坐飞机、火车、跨境移动或前往乡村地区购物前，请在 Wi-Fi 环境下打开 Price Tag FX，并设置第一个源市场。检查一次示例手动换算以及汇率日期。如果会前往多个货币区，请在联网时依次更改源市场，为每种基础货币预加载快照。不要依赖从未用目标货币对测试过的缓存。

旅行途中可用缓存换算来把握预算，但应先核对当地价格类型和结账总额。高价商品值得使用最新汇率比较，并查看银行卡手续费。商户提供的动态货币转换与 App 缓存相互独立。如果 App 与支付终端显示不同，请比较汇率日期、加价幅度和源金额，而不要先假定其中一个显示错误。

1. 出发前为每个目的地的基础货币预加载快照。
2. 通过手动换算测试确认目标货币受到覆盖。
3. 为离线使用记录最后更新时间。
4. 只在充分考虑风险后使用过期结果。
5. 分别核对结账金额和支付服务商的实际价格。

来源： Visa：动态货币转换概览

故障排查

常见问题