> For the complete documentation index, see [llms.txt](https://guides.stellaraio.com/stellar/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.stellaraio.com/stellar/retailers/bestbuy.md).
# BestBuy
Complete guide on our BestBuy module
StellarAIO’s Best Buy module supports account-based and guest checkout for both shipping and store pickup. It also includes dedicated modes for monitoring inventory, requesting product invitations, generating accounts, and resetting account passwords.
Best Buy frequently uses queues, verification codes, regional inventory, and product-specific fulfillment methods.
***
### Video Guide
Watch the complete Best Buy video guide here
{% embed url="" %}
***
### Preliminary Checklist
Before creating Best Buy tasks, confirm the following:
* [ ] StellarAIO is updated to the latest version.
* [ ] Checkout profiles contain valid billing, shipping, and payment information.
* [ ] Each account-based profile uses the exact same email as its Best Buy session.
* [ ] Best Buy accounts have been added under **Identities → Sessions → BestBuy**.
* [ ] Account sessions show **Ready** or **Ready To Login**.
* [ ] A working [IMAP session](https://guides.stellaraio.com/stellar/navigating-stellaraio/what-is-the-identities-tab/imap-overview) is available for verification codes and password resets.
* [ ] High-quality ISP and residential proxies have been added to Stellar.
* [ ] You have the correct Best Buy SKU for each product.
* [ ] You know whether the product supports shipping, pickup, or both.
* [ ] You have tested at least one task on an in-stock product.
* [ ] Your cook group’s announcements are enabled for drop-specific instructions.
***
## Accounts and Sessions
Best Buy accounts are required for account-based checkout, but Shipping and Pickup tasks also support **Guest Mode**.
Account-based checkout may be preferable when you want to use:
* Saved account information
* Reward certificates
* Account order history
* Existing Best Buy account benefits
Guest Mode uses the selected profile without logging into a Best Buy account.
***
### Adding a Best Buy Session
1. Open the **Identities** tab.
2. Select **BestBuy**.
3. Create or select a session group.
4. Click **Add Session**.
5. Complete the session fields.
6. Save the session.
7. Run a test task so Stellar can verify the login.
#### Session Fields
**Session Name**
An optional organizational name for the session. Using a recognizable name or the account email makes accounts easier to manage.
**Account Email**
Enter the Best Buy account’s email address.
For account-based checkout, this must match the email in the corresponding Stellar profile exactly, including capitalization.
**Account Password**
Enter the current password for the Best Buy account.
If the password is changed outside Stellar, update the session before running it again.
**Login Proxy**
The proxy used when logging into the account and establishing its session.
A stable ISP proxy is recommended for login and session consistency. Avoid frequently changing an account’s login proxy unless the existing proxy is blocked.
**Tax Exempt Number**
Optional. Enter this only if the Best Buy account is legitimately configured for tax-exempt purchasing.
**Open Browser**
Opens the browser associated with the session. This may be useful when manually checking the account or completing a login-related action.
***
### Session Statuses
**Not Ready**
The session is missing information or contains invalid account credentials.
**Ready To Login**
The account information has been saved, but Stellar has not completed a successful login yet. Starting an account-based task allows Stellar to attempt the login.
**Ready**
Stellar successfully logged into the Best Buy account and established the session.
Run a test task on an inexpensive in-stock product before an important drop. This confirms that the profile, session, proxy, and login flow are working.
***
### Mass Importing Sessions
If you have several Best Buy accounts:
1. Open **Identities → BestBuy**.
2. Select the desired session group.
3. Click **Mass Import Sessions**.
4. Enter each account using the format displayed inside Stellar.
5. Save the sessions.
6. Confirm that the imported information is correct before running tasks.
Do not share or expose your account list when asking for support.
***
### IMAP
IMAP allows Stellar to retrieve verification and password-reset codes from your email automatically.
IMAP is especially useful for:
* Initial account logins
* Email verification codes
* Password-reset tasks
* Managing many Best Buy accounts
* Reducing manual code entry
Follow the [IMAP Overview Guide](https://guides.stellaraio.com/stellar/navigating-stellaraio/what-is-the-identities-tab/imap-overview) to create and test an IMAP session.
If multiple Best Buy emails forward their messages to one master inbox, you may be able to use one IMAP session for those accounts.
***
## Supported Modes
### Checkout and Account Modes
#### Shipping
Attempts to purchase the selected SKU for delivery.
Use Shipping when the product supports delivery to the address in your profile.
#### Pickup
Attempts to reserve the selected SKU for pickup near the profile’s location.
Use Pickup only when the product supports store pickup.
#### Invite
Requests an invitation for an eligible invite-only Best Buy product.
#### Reset
Resets the password for the Best Buy account associated with the selected profile.
This mode requires working access to the account’s email through IMAP.
#### Account-Gen
Creates new Best Buy accounts using your selected profiles. Stellar automatically creates sessions for successfully generated accounts.
### Monitoring Modes
#### Monitor
Monitors general inventory for a SKU without limiting results to a ZIP code or list of stores.
This is the standard monitor for shipping availability.
#### Monitor-ZIP
Monitors a SKU using a postal code and selected monitoring method.
Use this when availability depends on the customer’s region.
#### Monitor-Stores
Monitors a SKU at specific Best Buy store IDs.
Use this when targeting particular physical locations.
***
## Common Task Fields
### Name
Optional. Assign a recognizable task name to keep products and setups organized.
If left blank, Stellar will identify the task using available product information.
### Profile
Select the checkout profile containing the customer’s billing, shipping, payment, and email information.
For account-based checkout, the profile email must match the Best Buy session email exactly.
### Checkout Proxy
The proxy used during login, carting, and checkout.
High-quality residential proxies are generally recommended for checkout. ISP proxies may also perform well depending on the drop and provider.
Use multiple reliable proxy providers and pools so one provider does not become a single point of failure.
### Monitor Proxy
The proxy group used by a Monitor task.
ISP proxies are generally recommended for monitoring because they are stable and do not consume residential data.
Use multiple reliable proxy providers and pools so one provider does not become a single point of failure.
### SKU
The unique Best Buy product identifier.
You can usually find the SKU on the Best Buy product page or obtain it from your [cook group](https://guides.stellaraio.com/stellar/getting-started-with-stellaraio/cook-groups).
Only enter one SKU per task.
### Delay or Monitoring Delay
Controls the time between task requests.
A general starting recommendation is approximately:
```
4500 ms
```
Adjust the delay based on:
* Proxy quality
* How long the tasks will run
* Current Best Buy traffic
* Error frequency
* Live instructions from Stellar or your cook group
Lower delays send requests more frequently but may increase proxy bans and rate limits. Higher delays are safer but may react more slowly.
### Reset Delay
Controls how long a monitor waits before resetting its internal monitoring state.
This field is optional. Leave it blank unless current instructions recommend a specific value.
### Start Time and End Time
Optional scheduling controls.
You must still manually start the task. A Start Time does not start a stopped task by itself.
### Task Quantity
The **Qty** field at the bottom of the creation window controls how many copies of the configured task Stellar creates.
This is different from the product quantity field inside Shipping and Pickup modes.
***
## Shipping Mode
Shipping Mode attempts to purchase a SKU for delivery.
### Shipping Fields
**Profile**
Select the profile that will be used for checkout. Its email must match a Best Buy session unless Guest Mode is enabled.
**Checkout Proxy**
Select the proxy group used for the checkout process.
**SKU**
Enter the Best Buy SKU.
**Qty**
Enter the number of units the task should attempt to purchase.
Check current product limits before entering a quantity. Stellar does not automatically correct quantities that exceed Best Buy’s limit.
**Fastest Delivery**
Selects the earliest available delivery option. The fastest option may cost more.
**Later Delivery**
Selects a later available delivery window.
Only enable a delivery preference when you specifically want Stellar to prioritize that option.
**Allow Pickup Fallback**
Allows the Shipping task to attempt pickup if shipping is unavailable.
**Store Radius**
Controls how far Stellar may search for a pickup location when Pickup Fallback is enabled.
The radius is measured from the ZIP code in the selected profile.
**Guest Mode**
Enable this to checkout without using a Best Buy account.
When Guest Mode is disabled, Stellar matches the profile email to a Best Buy session.
**IMAP Session**
Select the IMAP inbox Stellar should use for account verification codes.
**Remove Associated Items**
Attempts to remove additional associated items from the cart before checkout.
**Apply Reward Certificate**
Allows Stellar to apply an available Best Buy reward certificate from the account.
This is intended for account-based checkout.
**Skip 3DS**
Skips Stellar’s 3DS handling. Leave this disabled unless current instructions specifically recommend enabling it.
**Skip Prelogin**
When enabled, Stellar skips the initial account login and waits for the checkout flow or Monitor ping.
This can be useful during known queue releases. When disabled, Stellar attempts to log into the account when the task starts.
**Watch Task**
Makes the checkout task wait for a matching Monitor task to detect inventory.
When enabled, the task displays:
```
Waiting for Monitor Ping
```
Once a Monitor task with the same SKU finds stock, it alerts the checkout task and the checkout process begins.
**Use Rakuten / Use TopCashback**
Enables the selected cashback service after it has been configured in Stellar’s Settings.
***
## Pickup Mode
Pickup Mode attempts to reserve the selected SKU at a nearby Best Buy location.
### Pickup Fields
**Profile**
Select the profile whose location and payment information should be used.
**Checkout Proxy**
Select the proxy group used for checkout.
**SKU**
Enter the Best Buy SKU.
**Qty**
Enter the number of units the task should attempt to reserve.
**Store Radius**
Enter the maximum pickup distance from the ZIP code in the selected profile.
* Leave blank to use the default radius of **25 miles**
* Maximum supported radius: **250 miles**
* Enter whole numbers only, such as `25`, `50`, or `75`
**Allow Shipping Fallback**
Allows the Pickup task to attempt shipping if pickup becomes unavailable.
**Guest Mode**
Enables checkout without a Best Buy account.
**IMAP Session**
Select the IMAP inbox used for verification codes during account-based checkout.
**Remove Associated Items**
Attempts to remove additional associated items from the cart.
**Apply Reward Certificate**
Applies an available reward certificate from the Best Buy account.
**Skip 3DS**
Skips Stellar’s 3DS handling. Leave disabled unless instructed otherwise.
**Skip Prelogin**
Skips the initial account login before the checkout flow.
**Watch Task**
Makes the Pickup task wait for a compatible Monitor ping before attempting checkout.
**Use Rakuten / Use TopCashback**
Enables a previously configured cashback service.
***
## Monitor Mode
Monitor Mode detects general inventory for a SKU and can alert matching checkout tasks.
### Monitor Fields
**Profile**
Select the profile associated with the monitor’s account and location context.
**Monitor Proxy**
ISP proxies are generally recommended.
**SKU**
Enter the SKU you want to monitor.
**Monitoring Delay**
A starting value of approximately `4500` milliseconds is recommended. Adjust as needed based on proxy performance.
**Reset Delay**
Optional. Controls when the monitor resets its internal state.
**Max Price**
Optional. The monitor will ignore offers above the entered amount.
Use this field when you want to avoid triggering tasks for unexpectedly expensive listings.
### Recommended Monitor Quantity
For most users:
```
1 Monitor task per SKU
```
Additional monitors may provide redundancy, but they are normally unnecessary.
***
## Monitor-ZIP Mode
Monitor-ZIP checks a SKU using a specific postal code.
### Monitor-ZIP Fields
**Profile**
Select the profile associated with the monitored region.
**Monitor Proxy**
Select a high-quality ISP proxy group.
**Monitoring Method**
Choose the monitoring method required for the current setup. Follow current Stellar or cook group instructions if a specific method is recommended.
**SKU**
Enter the Best Buy SKU.
**Postal Code**
Enter the ZIP code for the area you want to monitor.
**Delay**
A starting value of approximately `4500` milliseconds is recommended.
**Reset Delay**
Optional. Controls when the monitor resets its state.
***
## Monitor-Stores Mode
Monitor-Stores checks inventory at specific Best Buy locations.
### Monitor-Stores Fields
**Profile**
Select the profile associated with the monitored locations.
**Monitor Proxy**
Select a high-quality ISP proxy group.
**SKU**
Enter the Best Buy SKU.
**Postal Code**
Enter the ZIP code associated with the desired area.
**Store IDs**
Enter the Best Buy store IDs you want to monitor.
Store IDs can be found through the [Best Buy Store Locator](https://stores.bestbuy.com/index.html):
1. Select a state.
2. Open the desired store.
3. Locate that store’s ID.
4. Enter the required IDs into Stellar.
**Delay**
A starting value of approximately `4500` milliseconds is recommended.
**Reset Delay**
Optional. Controls when the monitor resets its state.
***
## Invite Mode
Invite Mode requests an invitation for an eligible invite-only product.
### Invite Fields
**Profile**
Select the profile associated with the Best Buy account.
**Checkout Proxy**
Select a stable proxy for the request.
**SKU**
Enter the invite-only product’s SKU.
**IMAP Session**
Select the inbox used to retrieve Best Buy emails when needed.
**Start Time and End Time**
Optional scheduling controls. The task must still be started manually.
***
## Reset Mode
Reset Mode changes the password for the Best Buy account associated with the selected profile.
### Reset Fields
**Profile**
Select the profile whose email exactly matches the Best Buy session.
**Checkout Proxy**
Use a stable, high-quality proxy. Using a consistent or unique proxy per account may improve account stability.
**IMAP Session**
Required for retrieving the password-reset verification email or code.
After a successful reset, the updated password can be viewed in the account’s Best Buy session in Stellar.
### When to Use Reset Mode
Reset Mode may be useful when:
* An account cannot log in
* The existing password is rejected
* A session repeatedly loops during login
* Current pre-drop instructions recommend resetting accounts
Avoid repeatedly resetting healthy accounts without a reason.
***
## Account-Gen Mode
Account-Gen creates Best Buy accounts from selected Stellar profiles.
### Account-Gen Fields
**Profile**
Select the profiles that will be used to generate accounts.
**Checkout Proxy**
Select a high-quality proxy group for account creation.
**Task Quantity**
Controls how many Account-Gen tasks are created.
Successfully generated accounts should appear as Best Buy sessions in the Identities tab.
***
## Recommended Setup
### Account-Based Shipping
For each Best Buy account and SKU:
* One valid profile with an exactly matching email
* One Best Buy session
* One Shipping task
* Guest Mode disabled
* One IMAP session selected
* One matching Monitor task
* Watch Task enabled
* Residential checkout proxy
* ISP monitor proxy
### Guest Shipping
* One valid profile
* One Shipping task
* Guest Mode enabled
* One matching Monitor task
* Watch Task enabled
* Residential checkout proxy
* ISP monitor proxy
A Best Buy session is not used for Guest Mode.
### Account-Based Pickup
For each Best Buy account and SKU:
* One profile with an exactly matching email
* One Best Buy session
* One Pickup task
* Correct Store Radius
* One Monitor-ZIP or Monitor-Stores task
* Watch Task enabled
* Working IMAP
* High-quality proxies
***
## Task Limits and Scaling
Use no more than:
```
1 checkout task per SKU, account, and fulfillment method
```
For example, do not run several identical Shipping tasks for the same SKU on one Best Buy account.
Duplicate checkout tasks may contribute to:
* Account locks
* Checkout failures
* Duplicate requests
* Login instability
* Session problems
Monitor tasks do not use account checkout limits, but one monitor per SKU is sufficient for most setups.
***
## When to Start Tasks
### Before the Drop
1. Update Stellar.
2. Confirm the product’s SKU and fulfillment method.
3. Check that sessions and IMAP show Ready.
4. Run a test task on an in-stock item.
5. Start Monitor tasks early enough to confirm that they are operating normally.
6. Start checkout tasks before the expected restock.
7. Confirm Watch Tasks display **Waiting for Monitor Ping**.
### During the Drop
* Allow queue and Akamai-related statuses time to process.
* Do not immediately stop tasks because they appear to pause.
* Watch Stellar announcements for restart instructions.
* Avoid mass restarting tasks unless instructed or the setup is clearly incorrect.
* Change blocked proxies when necessary.
***
## Latest Best Buy Prep Call
`Prep Call Coming soon...`
A recent prep call or announcement may temporarily override the general recommendations in this guide. Always follow the newest drop-specific instructions.
***
## Common Errors and Fixes
### Site Does Not Have Session
**Cause**
The selected profile email does not exactly match a Best Buy session email.
**Fix**
* Compare both email addresses.
* Confirm capitalization matches.
* Confirm the session is in the BestBuy section.
* Save the corrected profile or session and restart the task.
***
### Login Detected Proxy Ban
**Cause**
The login or checkout proxy has been blocked.
**Fix**
* Stop the affected task.
* Replace the proxy with one from a reliable pool.
* Avoid repeatedly retrying the same blocked proxy.
* Test another proxy provider if the problem affects an entire pool.
***
### Fetch Akamai
**Meaning**
The task is retrieving information required by Best Buy’s protection system.
**What to Do**
Allow the task to continue. This process may take approximately two minutes.
Do not immediately restart the task unless it remains stuck or current instructions recommend a restart.
***
### `orderAlreadySubmitted`
**Cause**
An order may have already been placed by that account, or Best Buy may associate the address with an existing order.
**Fix**
* Stop the affected task.
* Check the account’s order history.
* Use another legitimate account or profile when appropriate.
* Confirm the product’s purchase limits before trying again.
***
### `LOSERROR` While Submitting Email
**Likely Cause**
The product is out of stock.
**Fix**
Leave the task running if you are waiting for a restock, or stop the task if you no longer want the product.
***
### `status 400` While Submitting Shipping
**Likely Cause**
The product is no longer available for the selected fulfillment method.
**Fix**
* Allow the task to continue if waiting for a restock.
* Confirm whether the product supports shipping.
* Consider Pickup only when the product offers pickup and your setup is configured for it.
***
### `Sending Recovery Option: Status 400`
**Likely Cause**
The task cannot retrieve or process the required email through IMAP.
**Fix**
* Confirm the selected IMAP session shows **Ready**.
* Test the IMAP session.
* Confirm verification emails are reaching the connected inbox.
* Recreate the email provider’s app password if necessary.
* Confirm forwarding rules are working if using a master inbox.
***
### Waiting for Code – Setting Up
**Likely Cause**
Stellar is waiting for a Best Buy verification code that has not been found through IMAP.
**Fix**
* Confirm the verification email arrived.
* Confirm the correct IMAP session is selected.
* Verify that the IMAP session shows **Ready**.
* Check forwarding rules and the inbox’s spam folder.
* Recreate the IMAP app password if the connection is no longer valid.
***
### Cart Reserve Selected Store Unavailable
**Cause**
The selected product is not available at a qualifying store in the configured area.
**Fix**
* Allow the task to retry briefly.
* Confirm the Store Radius, ZIP code, or Store IDs.
* Verify that the SKU supports pickup.
* Restart the task if the configured location has changed.
***
### Waiting for Monitor Ping
This is not an error when **Watch Task** is enabled.
The checkout task is waiting for a matching Monitor task to detect stock.
Confirm that:
* A Monitor task is running.
* The Monitor and checkout task use the same SKU.
* The correct monitor mode is being used for shipping or pickup.
* Monitor proxies are working.
* The Monitor task has not stopped or encountered an error.
***
### Session Stays on Ready To Login
The session has not completed a successful login yet.
**Fix**
* Confirm the account email and password.
* Confirm the profile email matches the session.
* Check the login proxy.
* Select a working IMAP session.
* Run a test task on an in-stock product.
***
### Repeated Queue or Login Loops
**Possible Causes**
* Best Buy site traffic
* A blocked proxy
* An unstable session
* Incorrect credentials
* Account verification requirements
**Fix**
* Give the queue time to process.
* Test a different proxy.
* Confirm IMAP is working.
* Verify the account manually.
* Use Reset Mode only if the account’s password or login state needs to be repaired.
* Follow current Stellar announcements before restarting a large setup.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://guides.stellaraio.com/stellar/retailers/bestbuy.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
