中国?wish商户本地货币问题之商户需要注意哪些API更改？

中国wish商户本地货币问题之商户需要注意哪些 API 更改？

自 UTC 时间2019年6月20日凌晨0时起，本地货币代码为 CNY 的商户必须填写 localized_price、localized_shipping、localized_currency_code、localized_cc 以及任何其他包含“localized_”的价格相关字段（对本地货币代码为 USD 的商户不作要求）。

/product/add

/product/update-shipping

/product/update-multi-shipping

/product/add-variation

/product/update-variation

/variant/add

/variant/update

ERP 可以使用 API 端口 /api/v2/get-currency-code 来检索商户的 localized_currency_code。该 API 端口还会返回以下参数：payment_currency_code，它代表当前支付商户所使用的货币。

此外，如果商户的 payment_currency_code = CNY，但使用美元数值，则 get 资源路径中所有与价格相关的字段都将返回 999999。请改用 localized_ 参数。

根据本地货币代码的最新定义（如上文“‘本地货币'对商户意味着什么？”常见问题解答中所述），部分商户的本地货币代码已于 UTC 时间2020年1月14日凌晨0时起从 CNY 更新为 USD，以反映这些商户当时接收付款所用的币种（是美元而非人民币）。因此，当这些商户接获有关 Wish 在2020年1月14日更新其本地货币代码的通知后，对于“localized_currency_code”在 UTC 时间2020年1月14日凌晨0时更新为“USD”的商户，所有“localized_”字段中的值将变为选填项，无论其当前的“localized_currency_code”是何币种。

自 UTC 时间2020年1月14日凌晨0时起，对于 payment_currency_code 和 localized_currency_code 均为 USD 的商户，所有包含“localized_”的字段中的值必须以美元为单位。如果商户在“localized_”字段和对应的非本币字段中提供不同的值（例如 localized_price 与 price，localized_shipping 与 shipping 字段），则会发生错误。

自 UTC 时间2020年7月14日凌晨0时起，本地货币代码为 USD 的商户使用“price = 5.0，localized_price = 5.0，localized_currency_code = CNY”字段提交 /api/v2/variant/update 命令时会产生报错消息，且价格更改不会被保存。

自2019年1月25日起，与本地货币 API 新功能相关的产品和订单 API 端口已更改：

currency_code 现为对以下所有订单路径的响应。currency_code 是指相关订单所有价格相关字段所使用的货币。ERP/私服 API 需要适当地使用 currency_code 返回的数据，以准确记录和/或显示订单的价格相关字段。

/order

/order/multi-get

/order/get-fulfill

/ticket

/ticket/get-action-required

商户和 EPR 可以浏览此 API 文档，以了解有关本地货币 API 更改的更多详情。

wish商户官网原文详情：

6. What are some API changes I need to be aware of?

Effective June 20, 2019 12:00AM UTC, the localized_price, localized_shipping, localized_currency_code, localized_cc, and any other price-related fields with “localized_” will be mandatory for merchants that have their Local Currency Code set as CNY (not required for merchants whose Local Currency Code is set as USD).

/product/add

/product/update-shipping

/product/update-multi-shipping

/product/add-variation

/product/update-variation

/variant/add

/variant/update

ERPs are able to use the API endpoint  /api/v2/get-currency-code to retrieve the merchant's localized_currency_code. This API endpoints also returns the parameter: payment_currency_code, which represents the currency at which the merchant will be paid in at this time.

In addition, if merchants' payment_currency_code = CNY, all price-related fields in the get pathways will return 999999 for the USD values. Please consume localized_ parameters instead.

Some merchants' Local Currency Code were updated from CNY to USD on January 14, 2020 12:00AM UTC to reflect the payments these merchants are receiving at the time (USD, instead of CNY), based on the updated definition of Local Currency Code (noted in the “What does the ‘Local Currency' mean to merchants?” Q&A above). As such, immediately after these merchants are notified by Wish of the January 14, 2020 updates made to their Local Currency Code, values in all “localized_” fields become optional for these merchants whose “localized_currency_code” is updated to “USD” on January 14, 2020 12:00AM UTC, regardless of their current “localized_currency_code”.

Starting January 14, 2020 12:00AM UTC, for merchants whose “payment_currency_code” and “localized_currency_code” are both USD, values in all “localized_” fields must be in USD. If merchants provide inconsistent values in “localized_” fields and corresponding non-localized fields (for example, “localized_price” vs. “price”, localized_shipping” vs. “shipping” fields), an error will occur.

Starting July 14, 2020 12:00AM UTC, for merchants whose Local Currency Code is USD, submitting the “/api/v2/variant/update” call utilizing the fields “price = 5.0, localized_price = 5.0, localized_currency_code = CNY” will result in an error message, and the pricing changes will not be saved.

Effective January 25, 2019, the product and order API endpoints related to the new local currency API feature have been changed:

currency_code is now a response to all the following order pathways. Currency_code indicates the currency for all price-related fields for the related order. Currency_code returns need to be appropriately consumed by ERPs/private APIs for accurate records and/or displays of price-related fields for an order.

/order

/order/multi-get

/order/get-fulfill

/ticket

/ticket/get-action-required

For more details about the local currency API changes, merchants and EPRs may visit this API documentation.

 文章内容来源：wish商户官方网站  

（本文内容根据网络资料整理和来自用户投稿，出于传递更多信息之目的，不代表本站其观点和立场。本站不具备任何原创保护和所有权，也不对其真实性、可靠性承担任何法律责任，特此声明！）

常见问答(FQAS)

Wish从2022年7月开始支持部分商户使用本地货币结算收入,目前支持结算的货币包括人民币、日元和韩元等。这对很多国内商户来说是一个重要的改变。

使用本地货币结算可以避免汇率损失,也更方便了结算记账。同时,部分地区如中国大陆由于不支持外币账户,本地结算就变得尤为重要。

是的,Wish在2022年8月推出了新的订单和结算API,更新后These APIs将返回订单和收入的结算货币信息。商户需要更新到新的API版本进行本地结算。

商户可以登录Wish开发者中心,在“API 文档”中可以找到Wish支持的所有API以及对应每个版本的变更记录,从中选择最新的版本进行集成。