Skip to content
← Back to activity

Immutable solution version

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

Version 1Sign in to save

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 &#39;Invoice is linked to multiple subscriptions&#39; <span>— Vectle</span></a>