BoxLunch

Complete guide on our BoxLunch module

Use the BoxLunch module in Stellar 4.0 for guest or account checkout. The normal mode places orders, while monitor checks stock for Normal tasks that have Watch Task enabled. BoxLunch releases are typically first come, first served, so prepare your setup before the release.

Quick Start — Recommended Setup

1. Create a BoxLunch task group under Tasks and choose Create Task.
2. Select normal, choose your profile and checkout proxy group, and enter the product SKU. Start with product Qty set to 1.
3. Leave Account blank for guest checkout, or select a saved BoxLunch account for account checkout.
4. For restocks, create one monitor task per SKU and enable Watch Task on the matching Normal tasks. Start both the Monitor and Normal tasks. For an independent Normal task, leave Watch Task off.
5. Review the delay, quantity and profile, then click Create. Start only when you are ready for the task to attempt a purchase.

Preliminary Checklist

Create and save your checkout profiles under the Profiles tab in Stellar. These contain your billing, shipping and payment info.

Save your proxy groups under Proxies. The existing recommendation is to use a mix of ISP and residential proxies, with residential proxies making up more of the setup. Begin with a small number of tasks and compare results across providers.

For proxy options, see Stella Proxies.

The Stella Proxies guide explains the available proxy types.

Confirm the product SKU and purchase limit before creating tasks. A test checkout can place a real order, so only test with a product and quantity you intend to buy.

Accounts and Sessions

The Account field is optional. Leave it empty for guest checkout. For account checkout, add your existing BoxLunch login in Accounts; older guides called these saved accounts “Sessions.”

1. Open Accounts and select BoxLunch.
2. Create an account group with New Group if needed, then open that group.
3. Click Add Account. Enter an Account Name for your own reference, plus the required Account Email and Account Password for your existing BoxLunch account. Click Save.
4. Return to your Normal task and select that account in the Account field. Saving credentials does not itself log in; the task uses them to sign in and save the session.

Keep the existing conservative recommendation of one active checkout task per account. Avoid running several tasks against the same account at once, which can cause conflicting login or checkout activity. This account guidance does not mean guest checkout requires an account.

Supported Modes

• normal: Attempts checkout. With Watch Task off it checks for stock itself; with Watch Task on it waits for a Monitor task for the same SKU.
• monitor: Checks product availability and signals matching Normal tasks. It does not place an order or require a checkout profile.

Normal Mode — Checkout

Choose normal in the Mode dropdown. Required fields are marked with an asterisk in the app.

• Name: Use a recognizable task label.
• Mode: Select normal.
• Profile: Select the saved shipping, billing and payment profile to use for checkout.
• Checkout Proxy: Select the proxy group used by the checkout task.
• SKU: Enter the product ID from the product-page URL. The old guide calls this a PID; the 4.0 field is labeled SKU.
• Qty beside SKU: Number of units to buy in an order. Use 1 unless you have confirmed the product allows more. Stellar does not automatically reduce an excessive quantity to the retailer’s limit.
• Delay: Time between repeated requests, in milliseconds. The current default is 3000 ms (3 seconds). The previous checkout recommendation was around 1000 ms; begin with the default and adjust only after checking your results, since shorter delays make more requests.
• Account: Optional. Leave blank for guest checkout, or choose your saved BoxLunch account.
• Discount: Optional discount code. Leave empty if you do not have a valid code for the purchase.
• Start Time / End Time: Optional schedule. Leave blank if you will start and stop tasks yourself.
• Watch Task?: Enable when a running Monitor task should trigger this checkout task. The SKU must match. Leave off for independent stock checking and checkout.
• Use Rakuten? / Use TopCashback?: Optional cashback integrations. Configure the service you plan to use first and check purchase eligibility.
• Qty at the bottom: Number of tasks to create. This is separate from the product quantity above.

Find the Product SKU

For example: https://www.boxlunch.com/product/stranger-things-hellfire-club-raglan-t-shirt/19995072.html.

The SKU in that example is 19995072: the number at the end of the URL before .html. Enter that number in the SKU field.

Check quantity recommendations with your cookgroup, and stay within the retailer’s purchase limit.

Optional Cashback

For Rakuten setup, follow the Cashback guide — Rakuten setup.

For TopCashback setup, follow the Cashback guide — TopCashback setup. Cashback is subject to the provider’s eligibility and claim rules.

Monitor Mode — Stock Checking

Choose monitor in the Mode dropdown. One Monitor task per SKU is a practical starting point; additional duplicate monitors are usually unnecessary.

• Name: Use a label that identifies the product.
• Mode: Select monitor.
• Monitor Proxy: Choose the proxy group for stock checks.
• SKU: Use the same product ID as the matching Normal tasks.
• Monitor Delay: Time between stock checks, in milliseconds. The form defaults to 3000 ms. The existing recommendation is around 5000 ms (5 seconds); adjust based on task responses and proxy quality.
• Start Time / End Time: Optional scheduling controls.
• Qty at the bottom: Number of Monitor tasks to create. Start with 1 per SKU.

Example: Monitor + Normal for a Restock

1. Create a monitor task for SKU 19995072 with a monitor proxy group.
2. Create a normal task for SKU 19995072, select a profile and checkout proxy group, and enable Watch Task.
3. Start both tasks. A Normal task showing “Waiting for Monitor Ping” is ready and waiting for the Monitor task to detect stock.
4. When the Monitor detects availability, it signals the matching Normal task to add to cart and attempt checkout. Keep both running while you want this setup active.

FAQ

Do I need an account?

No. Guest checkout is available by leaving Account blank. If you prefer account checkout, save the login under Accounts → BoxLunch and select it in the task.

Do I need a Monitor task?

Only when you use Watch Task. An independent Normal task can monitor and check out by itself with Watch Task off. Monitor + Normal is the existing recommended setup for restocks.

Does a checkout guarantee shipment?

No. Check the retailer’s order confirmation and order status. A checkout can still be cancelled or require follow-up with the retailer.

Common Errors and Troubleshooting

• Waiting for Monitor Ping: This is expected with Watch Task enabled. Confirm the Monitor task is running and has the same SKU. Turn Watch Task off only if you want Normal to work independently.
• Product not found or no stock signal: Check the SKU against the product URL and confirm both modes use the same number.
• Quantity rejected: Reduce product Qty to the retailer’s allowed amount. Stellar will not automatically correct it.
• Login or session trouble: Verify the saved account credentials and avoid multiple simultaneous checkout tasks on one account. Guest users should leave Account empty.
• Repeated proxy or rate-limit errors: Reduce the number of tasks, use a longer delay and compare a small setup with another proxy group. Send the exact error to support if it continues.
• Order email says pickup or ShipToStore: Developers explained that Stellar checks for ShipToStore (STS) and treats it as out of stock rather than proceeding with that fulfillment method. They have also seen emails that say pickup while the order page still shows shipping. Check the actual status of non-cancelled orders and contact BoxLunch support to confirm fulfillment; Stellar support cannot change the retailer’s order.

---