Early access to tax on return shipping fees for app testing (Oct 23 change)

Hi! We’re preparing for the change where Shopify starts calculating tax on return shipping fees for US orders using Shopify Tax on October 23, 2026.

We are planning to update our refund calculation to read CalculatedReturnShippingFee.taxAmountSet (API 2026-10). Along with the finalized Shipping Fee, ReturnShippingFee.finalizedTaxAmountSet(API 2026-10). Currently in our dev store returns $0 because the change isn’t live yet, so we can’t check our refund amounts against real behavior before launch.

Could you either enable the return-shipping-fee tax behavior on a dev store for us, or point us to a feature preview that includes it? If neither is possible, could you confirm:

  1. For tax-exclusive orders, is amountSet the pre-tax fee, with taxAmountSet added on top? For taxesIncluded orders, is taxAmountSet taken out of amountSet?
  2. Does returnCalculate compute the same taxAmountSet when the input contains only orderId and returnShippingFee (no returnLineItems) as when line items are included?
  3. When will this change be made? Is there an exact timestamp when the switch over will happen?

Store: lance-store-6530.myshopify.com

Thanks!

Hi @lance_frate,

Your interpretation of the fee amounts is correct:

  1. For tax-exclusive orders, amountSet is the fee before tax, so the total fee is amountSet + taxAmountSet. For tax-inclusive orders, amountSet already includes the tax; subtract taxAmountSet only if you need the pre-tax amount. If you’re using financialSummary.totalPriceSet or totalTaxSet, those already account for the fee tax, so don’t add it again.

  2. A fee-only returnCalculate request won’t give an equivalent tax estimate. The current calculation skips fee tax when no return line items are supplied, returning zero. Include the actual fulfillment line item IDs and quantities in returnLineItems to calculate the applicable tax.

  3. I don’t have an exact activation timestamp to share beyond the announced October 23 start date.

After processing the return, use finalizedTaxAmountSet to reconcile the actual tax against the estimate. It’s null before processing, and the finalized amount can differ from the estimate.

For early access on lance-store-6530.myshopify.com, please contact Shopify Support while signed in as the store or organization owner and link this thread. They can authenticate the request and review whether this feature can be enabled early for testing.