Not able to set Shipping amount in SuggestedRefund Query? Multi currency orders require using argument shippingAmountV2, but there is no docs on it

GraphQL Admin API Troubleshooting
1

Dear Shopify Support Team,

I am encountering an issue with the Shopify Admin GraphQL API when attempting to use ShippingAmountV2 in a suggestedRefund query for multi-currency orders. Despite ensuring the query follows the documented structure, I am receiving the following error:

{
  "errors": [
    {
      "message": "invalid money '{\"amountSet\" => {\"presentmentMoney\" => {\"amount\" => \"4.99\", \"currencyCode\" => \"USD\"}, \"shopMoney\" => {\"amount\" => \"3.45\", \"currencyCode\" => \"GBP\"}}}'",
      "extensions": {
        "code": "argumentLiteralsIncompatible",
        "typeName": "CoercionError"
      }
    }
  ]
}

Here’s the query I’m using:

query suggestedLineItemRefundQuery {
  order(id: "gid://shopify/Order/5665719058568") {
    suggestedRefund(
      shippingAmount: {
        amountSet: {
          presentmentMoney: {
            amount: "4.99"
            currencyCode: "USD"
          }
          shopMoney: {
            amount: "3.45"
            currencyCode: "GBP"
          }
        }
      }
      refundLineItems: [
        {
          lineItemId: "gid://shopify/LineItem/13497956008072"
          quantity: 1
        }
      ]
    ) {
      amountSet {
        presentmentMoney {
          amount
          currencyCode
        }
        shopMoney {
          amount
          currencyCode
        }
      }
      shipping {
        amountSet {
          presentmentMoney {
            amount
            currencyCode
          }
          shopMoney {
            amount
            currencyCode
          }
        }
      }
    }
  }
}

What I’ve Tried:

  1. Verified the currencies in the order:
  • Presentment currency: USD
  • Shop currency: GBP
  1. Attempted simplified queries without overriding ShippingAmountV2, which worked correctly.
  2. Tested the latest Shopify API version.

Order Details:

  • Order ID: gid://shopify/Order/5665719058568
  • Line Item ID: gid://shopify/LineItem/13497956008072

Request:

Could you please:

  1. Confirm if the ShippingAmountV2 structure in my query is correct?
  2. Clarify if there are any undocumented limitations or requirements for using ShippingAmountV2 in multi-currency refunds.
  3. Provide guidance or corrections to resolve the error.

Your assistance would be greatly appreciated!

Thank you,

2

I also tried to use below graphQL to ovveride shipping amount in suggestedRefund:

query suggestedLineItemRefundQuery($id: ID!, $refundLineItems: [RefundLineItemInput!]!, $money: Money!) {
  order(id: $id) {
    suggestedRefund(shippingAmount: $money, refundLineItems: $refundLineItems) {
      amountSet {
        presentmentMoney {
          amount
          currencyCode
        }
        shopMoney {
          amount
          currencyCode
        }
      }
      shipping {
        amountSet {
          presentmentMoney {
            amount
            currencyCode
          }
          shopMoney {
            amount
            currencyCode
          }
        }
        maximumRefundableSet {
          shopMoney {
            amount
            currencyCode
          }
          presentmentMoney {
            amount
            currencyCode
          }
        }
      }
      refundDuties {
        amountSet {
          shopMoney {
            amount
            currencyCode
          }
        }
      }
      suggestedTransactions {
        amountSet {
          shopMoney {
            amount
            currencyCode
          }
          presentmentMoney {
            amount
            currencyCode
          }
        }
        gateway
        parentTransaction {
          kind
          id
        }
      }
    }
  }
}

variables:

{
  "id":"gid://shopify/Order/5665719058568",
  "refundLineItems": [
        {
          "lineItemId": "gid://shopify/LineItem/13497956008072",
          "quantity": 1
        }
  ],
  "money":"4.99"
}

but getting below error:

{
  "errors": [
    {
      "message": "ShippingAmountV2 required for multi currency orders.",
      "locations": [
        {
          "line": 6,
          "column": 5
        }
      ],
      "path": [
        "order",
        "suggestedRefund"
      ]
    }
  ],
  "data": {
    "order": {
      "suggestedRefund": null
    }
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 6,
      "actualQueryCost": 2,
      "throttleStatus": {
        "maximumAvailable": 2000,
        "currentlyAvailable": 1998,
        "restoreRate": 100
      }
    }
  }
}