use admin api returnCalculate with multiple currencies

Shopify Apps

Topic summary

Issue: Handling multi-currency return shipping with Admin GraphQL (returnCalculate/returnRequest). The returnShipping input must be provided in the presentment currency (the currency shown to the customer for the order), but current “return shipping rules” support only a single value.

Key details:

  • Self-serve return page appears to auto-convert the rule value when calculating return shipping.
  • No mutation found to convert or set per-currency override values via API.
  • If returnShipping is sent in the wrong currency to returnCalculate or returnRequest, the API returns null.
  • If no returnShipping value is provided, the store’s default rule is applied.

Open questions/request:

  • Suggested approach to convert an override value: should apps handle currency conversion themselves or require merchants to provide per-currency values?

Status: Unresolved; seeking guidance or best practice for implementing multi-currency overrides with the Admin API.

Summarized with AI on December 13. AI used: gpt-5.
1

The returnCalculate query specifies that the returnShipping input should be provided in the presentment currency. The current “return shipping rules” only allow for one value and the self-serve return page seems to automatically convert the value when it calculates return shipping. Is there a suggested way to convert an override value ourselves? I can’t find a mutation, so assume we should handle it or allow a merchant to provide values.

Also, if you provide the wrong currency to the returnShipping input in this query or in returnRequest, they just return null. If you dont provide a value, the default store value is applied.