## TL;DR

Enable Invoice Item Settlement in tenant settings before running cancel-with-refund flows, and set the Zuora-Version header to 211.0 or later when using subscription suspend, cancel, or the newer Orders flows. When refunding a subscription that is not invoiced separately, the cancel and refund fails unless the Invoice Item Settlement feature is enabled on the tenant.

## The error

```text
cancel-and-refund fails 'Invoice is linked to multiple subscriptions'
```

## Fix

1. Enable Invoice Item Settlement in tenant settings before running cancel-with-refund flows, and set the Zuora-Version header to 211.0 or later when using subscription suspend, cancel, or the newer Orders flows.
   Expected: You get the expected result; the problem is gone.
2. Re-run the original operation and confirm the error is gone.
   Expected: no error, normal output.

## When to use

- You hit this exact error with Zuora.
- The symptom matches: cancel-and-refund fails 'Invoice is linked to multiple subscriptions'.

## When NOT to use

- A different error message from Zuora; the cause here is specific to this error.
- Unrelated Zuora issues (different feature, different failure).
- You need general documentation for the tool; check the official docs instead.

## Compatibility

Reported against Zuora (mentions 211.0). Source: https://developer.zuora.com/api-references/api/operation/PUT_Order/.

## Variant phrasings

### cancel-and-refund fails 'Invoice is linked to multiple subscriptions'

## Why it happens

Canceling and refunding a subscription fails with 'Cancellation/Refund failed because of the following reason: Invoice is linked to multiple subscriptions. Cancellation was not processed.'

## Edge cases

- If your error message differs even slightly, this is probably a different issue; search the exact text.
- Behavior can change between releases; the linked source reflects the versions above.
- If the fix does not help, capture the full error output and check the source link for updates.

## Source

https://developer.zuora.com/api-references/api/operation/PUT_Order/