Restoring referral discounts and affiliate attribution after a Shopify checkout upgrade

What was happening

The store upgraded its Thank You and Order Status pages to Shopify's supported App Blocks and Pixels model. After the migration, the Snowball affiliate setup needed a separate review because a working referral journey spans more than the final order page. Discount folders and rules must be active, referral discounts must combine with the store's bundle promotion as intended, the app block must be present in the supported post-purchase surface, and the completed order must still be associated with the referral.

Why the obvious solution was not enough

A referral link can appear to work even when only the landing step succeeds. The customer may reach the site but lose the discount in the cart, encounter a non-combinable promotion at checkout, or complete an order that the affiliate system does not attribute. Testing only the link or only the Thank You page would miss the actual failure boundary.

How the solution works

1. Map the complete referral journey from the affiliate link through storefront arrival, discount activation, cart calculation, checkout, order completion, and affiliate reporting.
2. Confirm the Snowball App Block is installed on the supported Thank You and Order Status experience after the checkout-extensibility upgrade.
3. Review the affiliate platform's discount folders and rule status instead of assuming the migration itself automatically preserved every promotion setting.
4. Re-enable the required referral discount configuration and verify the generated discount is valid for the products and customer state used in the test.
5. Check Shopify discount-combination settings so the referral benefit can stack with the existing quantity-bundle discount only where the business explicitly allows it.
6. Use a fresh browser session and a real referral link to avoid a previous cookie, cart, or discount state hiding the problem.
7. Complete a test order and verify both customer-facing pricing and the affiliate-side order record before declaring the integration restored.
8. Document the customer flow clearly so support can explain that the referral link must be opened before shopping and that the qualifying discount is applied through the intended checkout path.

What should be verified before shipping

• Open the referral link in a clean browser session and confirm the expected referral state is created.
• Add qualifying products and verify the referral discount appears without removing the approved bundle discount.
• Test a cart that should not qualify and confirm the referral configuration does not create an unintended discount.
• Complete checkout and inspect the Shopify order total, discounts, and order timeline.
• Confirm the completed order appears under the correct affiliate or referral record.
• Revisit the Order Status page and verify the supported app block loads without duplicate tracking or legacy-script dependencies.
• Test after clearing cookies and with an existing cart so the documented customer instructions match real behavior.

What changed

The required affiliate discount configuration was restored, referral discounts could stack with the approved bundle promotion, and the supported Snowball app block remained part of the upgraded post-purchase experience. The fix treated the referral as an end-to-end commerce journey rather than a single link or script.

Reusable lesson

Affiliate reliability sits across several systems. After a checkout migration, verify the referral state, discount eligibility, promotion combinations, completed Shopify order, and affiliate record as one connected path.