如 此前宣布，我们正引入重要变更，以简化和增强 Shopify Admin API 中的退货管理功能。
有哪些变更？
- returnRefund 变异操作已弃用，并由新的 returnProcess 变异操作取代。returnProcess 变异操作通过将处置决策和财务处理合并为单次调用来简化退货生命周期管理。
- 字段 Return.suggestedReturnRefund 已弃用，转而使用新的 Return.suggestedFinancialOutcome 字段。
- 换货履行订单现在仅在处理换货品项时创建，以确保准确性。
- 退款和退货处理现在为管理已退货品项提供了更高的精确度。
- 仅当买家需支付净应付余额时，换货才会被置于 AWAITING_PAYMENT 挂起原因下。
Action required:
如果您的应用目前使用 returnCreate 创建退货或使用 returnApproveRequest 批准退货请求，请迁移至新的 returnProcess 变异操作来处理退款和换货。旧的变异操作（refundCreate、returnRefund）以及查询字段（Return.suggestedRefund）已弃用。现在，您应改用 returnProcess 和 Return.suggestedFinancialOutcome。
Availability:
这些新 API 已在 API 版本 2025-07 中正式发布。
更多详情，请参阅我们更新的 migration guide。