Post-Purchase Offers
Configure and manage post-purchase warranty upsell offers
Post-Purchase Offers
Post-purchase offers let customers add warranty coverage to products they have already bought — through email links, order status pages, or embedded widgets on your storefront.
Post-purchase URL
The post-purchase form is hosted at:
https://app.myumbrella.ai/post-purchaseQuery parameters
| Parameter | Required | Description |
|---|---|---|
shopDomain | Yes | Your myshopify.com domain |
customerId | No | Shopify customer ID to pre-identify the customer |
customerEmail | No | Customer email for order lookup |
orderId | No | Shopify order ID to pre-select |
productId | No | Product ID to pre-select |
merchantName | No | Store display name (overrides DB value) |
customDomain | No | Custom domain (overrides DB value) |
Example:
https://app.myumbrella.ai/post-purchase?shopDomain=acme-widgets.myshopify.com&customerEmail=jane@example.com&orderId=5551234567Customer flow
Step 1: Source selection
The customer selects where they purchased the product: from your store or from a third-party retailer.
Step 2: Order lookup
- Your store — Customer enters email and order number. Umbrella verifies the order against Shopify and displays matching items. Fields are pre-populated if
customerEmailororderIdwere passed as query parameters. - Third-party — Customer searches your product catalog and provides purchase details.
Step 3: Product selection
The customer selects which product to protect with a warranty.
Step 4: Warranty options
Available warranty plans for the selected product are displayed with coverage details and pricing.
Step 5: Registration check (if required)
If your warranty configuration requires product registration, the customer is asked whether they have already registered. If your organization allows post-purchase without registration, this step is skipped.
Step 6: Add to cart
A Shopify cart URL is generated with the warranty pre-added. The customer is redirected to checkout.
Standalone vs. embedded mode
| Mode | Description |
|---|---|
| Standalone | Full-page layout at the Umbrella URL |
| Embedded | Rendered inside an iframe. Sends a WARRANTY_SELECTED postMessage to the parent window when the customer makes a selection. |
Embedded mode is useful for integrating offers directly into your storefront, order confirmation page, or customer account area.
Organization settings
Two organization-level settings control this flow:
- Allow third-party purchases — When enabled, customers who bought from another retailer can purchase a warranty through the post-purchase form.
- Allow post-purchase without registration — When enabled, customers can buy a warranty without completing product registration first.
These settings are configured at the organization level from your warranty configurations.
Related
- Product Registration — the registration flow that may be required before post-purchase
- Serial Numbers — serial number validation during registration
- Policies — policies created from post-purchase warranty purchases
- Orders — orders associated with post-purchase transactions