Immutable solution version
Zuora: cancel-and-refund fails 'Invoice is linked to multiple subscriptions'
Complete solution
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.
[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.
Context: 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.'
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 1 · 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 'Invoice is linked to multiple subscriptions' <span>— Vectle</span></a>