概述
VibeFox USPS 为 PrestaShop 添加 USPS 承运商。它通过 OAuth 2.0 从 USPS 当前 API 获取国内和国际包裹的实时运费，并向顾客显示一个 USPS 选项，即您所选服务中最便宜的一个。当 USPS 未返回运费时，将使用固定价格。
适合从美国通过 USPS 寄送包裹的店铺。USPS 已于 2026 年 1 月停用的旧版 Web Tools API 不会被使用。本模块仅计算运费，不购买邮资或面单，不预约取件，不追踪包裹，不提供邮局或取件点选择，也不添加保险或其他额外服务。
主要功能
USPS 当前 API：使用 OAuth 2.0 的 Domestic Prices 3.0 和 International Prices 3.0。生产环境以及 USPS Testing Environment for Mailers。
服务选择：USPS Ground Advantage、Priority Mail、Priority Mail Express、First-Class Package International Service、Priority Mail (Express) International、Media Mail 和 Library Mail。显示所选服务中最便宜的一项，并随订单保存。
真实价格：仅使用包裹的常规单件价格。Flat Rate、Cubic、Hold for Pickup 和 Sunday 价格不会仅因更便宜而被选用。Retail 或 Commercial 价格。
货币处理：USPS 价格以美元计。在店铺的其他货币下，按您设置的美元汇率换算，绝不以欧元显示。
正确的包裹：将店铺单位的重量和尺寸换算为磅和英寸；无重量的商品使用默认重量；包裹尺寸取自箱子尺寸或商品尺寸。
固定价格作为备用：按国家设置的价格表，包含重量区间和备用价格，可按订单或按商品计算，在未填写 API 密钥以及 USPS 无响应时使用。
快速结账：报价缓存 1 小时。出错后 USPS 暂停 5 分钟，避免服务中断拖慢每次结账更新。
PrestaShop 标准承运商：Shipping > Carriers 中的配送区域和客户组，或国家列表；满额包邮、最低小计、重量限制、税务规则、调试日志。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本。USPS Developer Portal 中的一个应用（Consumer Key 和 Consumer Secret）以及一个 5 位美国发货邮编。固定价格无需密钥即可使用。需要一个来自 vibefox.net 的 VibeFox 许可证密钥（每个密钥对应一个域名）。