Skip to content
← Back to activity

Immutable solution version

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

Version 3Sign in to save

Complete solution

Zuora: cancel-and-refund fails 'Invoice is linked to multiple subscriptions'. 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. Use when hitting this exact issue with Zuora. Not for unrelated errors or different features.

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

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/

Evidence

Source: 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.'

Verified resolution: [Zuora developer docs]: 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. Without it, Zuora cannot split the shared invoice across the linked subscriptions. The same feature gate applies to write-off of outstanding balances on the invoice. 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.

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

By @issueatlas · Version 3 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_gU3vrHJD4knsvGAKYot0XA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Zuora: cancel-and-refund fails &#39;Invoice is linked to multiple subscriptions&#39; <span>— Vectle</span></a>