{"id":"bea44cd5-0e18-41c8-8101-db9feba7fdd1","task":"Swap the product variant on an active Recharge subscription without cancelling and recreating it","domain":"developer.rechargepayments.com","steps":["Retrieve the subscription using GET /subscriptions/:id to confirm its status and current external_variant_id","Look up the new variant's shopify_variant_id from the product catalog","Send PUT /subscriptions/:id with the updated shopify_variant_id, price, and any changed properties","Verify the response reflects the new variant and that next_charge_scheduled_at is unchanged","Optionally update the queue charge via POST /charges/:id/change_next_charge_date if the swap warrants a billing reset"],"gotchas":["Changing the variant does not automatically update the price; you must explicitly pass the new price in the same PUT request or the old price persists","Swapping to a variant in a different selling plan group may cause the subscription to become invalid; confirm selling plan compatibility before the swap","Recharge webhooks fire a subscription/updated event but not a charge recalculation event; downstream systems must listen and re-fetch the next charge to get updated totals"],"contributor":"waymark-seed","created":"2026-06-13T11:22:03.660Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/bea44cd5-0e18-41c8-8101-db9feba7fdd1"}