> 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/sams-club.md). # Sams Club Complete guide on our Sams Club module
Our Sam’s Club module supports account based checkout and provides fast monitoring, variant support and smooth task linking between monitor and checkout flows. Because Sam’s Club frequently restocks at random and occasionally requires login verification, Stellar uses IMAP, session based login and watch task pairing to ensure stability and fast ATC. This module is ideal for high demand retail products, Pokémon cards, toys, collectibles and items that restock quietly without warning. *** ### Video Guide {% embed url="" %} *** ### Quick Start: Recommended Setup This is the standard recommended setup for most Sam’s Club drops and restocks. Always follow newer drop-specific instructions when they are posted. #### 1. Prepare Your Sam’s Club Accounts Before creating tasks: 1. Add your Sam’s Club accounts under **Identities → Sessions → Sam’s Club**. 2. Log into your accounts as early as possible. 3. Confirm each account has an active paid Sam’s Club membership. 4. Confirm the account’s address and payment information are correct. 5. Create a matching Stellar profile with valid billing, shipping, and payment information. 6. Test your accounts and tasks before an important release. Sam’s Club sessions can remain active for weeks, so do not wait until the final few minutes before a drop to prepare your accounts. #### 2. Decide Whether to Use IMAP IMAP is optional for Sam’s Club. IMAP can automatically retrieve supported email login or verification codes. If you use IMAP, configure the Sam’s Club account to receive verification codes by email and select the correct IMAP session in the task. If you are not using IMAP, leave the **IMAP Session** field blank and complete any required verification manually. SMS codes cannot be retrieved through IMAP. #### 3. Prepare Your Proxies Use high-quality proxies that can pass Sam’s Club’s PX protection. Recommended approach: * Use a mix of ISP and residential proxies. * ISP proxies can work well for monitoring and account login. * Residential proxies are recommended for many checkout tasks. * Use multiple proxy providers or proxy pools when possible. * Test your proxies before the release. * Keep separate proxy groups for monitoring and checkout when possible. Localhost is not supported for Sam’s Club tasks. Proxy performance can change between releases. Check with your cook group or proxy provider for the latest recommendations. #### 4. Create the Monitor Task Create approximately one Monitor task per product. Recommended Monitor setup: * **Mode:** Monitor * **Monitor Proxy:** Tested ISP or residential proxy group * **Product URL:** Exact Sam’s Club product URL * **Monitoring Delay:** Start around `3000–5000` * **Reset Delay:** Follow the latest drop recommendation * **Start Time and End Time:** Optional Monitor tasks detect stock and notify Normal tasks that have **Watch Task** enabled. #### 5. Create the Normal Checkout Task Create one Normal checkout task for each Sam’s Club account. Recommended Normal setup: * **Mode:** Normal * **Profile:** Profile matching the Sam’s Club account * **Checkout Proxy:** Tested residential or ISP proxy * **Product URL:** Exact product URL * **Offer ID:** Leave blank when initially starting the task unless newer instructions say otherwise * **Product Quantity:** Follow the product limit provided by your cook group * **Session:** Select the Sam’s Club account * **IMAP Session:** Optional * **Login Method:** Use the current recommended login method * **Delay:** Start around `3000–5000` * **Watch Task:** Enabled * **Skip Cart Clear:** Disabled unless specifically recommended * **Endless Mode:** Disabled unless you intentionally want repeat checkouts * **Use Rakuten:** Optional when properly configured Use strictly one active checkout task per Sam’s Club account. Reusing the same account across multiple checkout tasks can cause login problems, account locks, `456` responses, and checkout failures. #### 6. Use Product URLs and Offer IDs Correctly If you are going for one product, begin with its exact Product URL. For many scheduled releases: 1. Start the Normal task without an Offer ID. 2. Enable **Watch Task**. 3. Allow the task to log in and reach its waiting status. 4. Approximately 5–10 seconds before the release, live edit the task and enter the Offer ID when instructed. When an Offer ID is entered, the task focuses on that offer instead of the Product URL and repeatedly attempts to add it to cart. The task updates live after editing. You do not need to restart it after adding the Offer ID. Offer IDs are normally provided through your cook group or the latest drop instructions. #### 7. Multicart Setup To attempt multiple offers in one task, enter the Offer IDs separated by commas: ``` OID1,OID2 ``` When multiple Offer IDs are entered, the task focuses on those offers instead of the Product URL. If one offer is out of stock or never becomes available, the task may display an add-to-cart error. Sam’s Club may not identify which individual offer caused the error. #### 8. Start Your Tasks For scheduled releases: 1. Start Normal checkout tasks approximately 30–60 minutes before the expected release. 2. Confirm that every account logs in successfully. 3. Confirm tasks reach their waiting-for-monitor status. 4. Start approximately one Monitor task per product around 10–15 seconds before the release. 5. Add the Offer ID approximately 5–10 seconds before the release when instructed. 6. Keep tasks running through additional stock waves. Starting Normal tasks early gives you time to address account, session, proxy, or verification problems before the site becomes heavily loaded. #### 9. Confirm Your Setup Before the Drop Before leaving your setup running, confirm that: * Stellar is updated. * Every Sam’s Club account has an active membership. * Sessions are successfully signed in. * Profiles contain accurate information. * Proxies have been tested. * IMAP is configured if you intend to use it. * There is only one checkout task per account. * Watch Task is enabled. * Normal tasks are waiting for the Monitor task. * The Monitor task contains the correct product URL. * Delays begin around `3000–5000`. * You have the correct Offer ID ready when one will be used. Run a test task on an in-stock product before an important release whenever possible. #### 10. During the Release Sam’s Club may experience site, PX, or proxy-provider issues during major releases. A `456` response before a release on an out-of-stock product can be normal. A `456` during a high-traffic release can also be caused by the website, account, or proxy. If tasks are still progressing, allow them to continue. Do not stop every task at the first error. Only restart tasks when Stellar staff specifically announces that a restart is required or when you have identified a task-specific problem. *** ### **Preliminary Checklist** Before setting up tasks on Sams Club, make sure you have everything below prepared: * [ ] **Profiles** > Create and save your checkout [profiles](/stellar/navigating-stellaraio/what-is-the-profiles-tab/how-do-i-add-a-profile.md) under the **Profiles tab** in Stellar. These contain your billing, shipping and payment info. * [ ] **Proxies** > - **ISP proxies** – Recommended for some of your tasks > - **Residential proxies** – Recommended for majority of your tasks > * Save both proxy groups under the **Proxies tab** in Stellar. > * If you're looking for proxies, check out [Stella Proxies](https://guides.stellaraio.com/stellar/getting-started-with-stellaraio/stella-proxies) for high quality ISP and Residential proxies. As always, it's recommended to have multiple proxy providers, don't just rely on one. * **Cook Group Access** > Optional but recommended. Your [cook group](https://guides.stellaraio.com/stellar/getting-started-with-stellaraio/cook-groups) can help you find product URLs, SKUs and early restock alerts. * **Sam's Club Accounts** > - Prepare one Sam’s Club account for each checkout task. > - Accounts must have an active paid Sam’s Club membership. > - Confirm the saved address and payment information are correct. > - Add each account under **Identities → Sessions → Sam’s Club**. > - Log into accounts as early as possible. > - Test the accounts before an important release. > - Use strictly one active checkout task per account. > > IMAP is optional. If you use IMAP, configure email as the account’s preferred verification method because IMAP cannot retrieve SMS codes. *** ### Adding Accounts (Sessions) 1. Go to **Identities → Sessions → Sam’s Club** 2. Click **Add Session** 3. Enter: * Session Name * Email * Password 4. Click **Save** > **Important:**\ > Your Sam’s Club verification method must be set to **email**, not SMS.\ > (SMS cannot be pulled by IMAP.) When you start a Normal mode task, Stellar will automatically log into the account.
{% hint style="warning" %} You need to set your account code for **email** as preferred method in your Sams Club account settings, SMS isn't supported as it's not possible to IMAP {% endhint %} *** ### IMAP IMAP is optional for Sam’s Club. When configured, IMAP allows Stellar to retrieve supported login and verification codes sent to the account’s email address. IMAP can provide: * Faster email-code retrieval * Less manual code entry * Easier account verification * Assistance with supported login and reset flows To use IMAP: 1. Configure the account to receive verification codes by email. 2. Add an IMAP session under **Identities → Sessions → IMAP**. 3. Select the IMAP session inside the Sam’s Club task. If you are not using IMAP, leave the **IMAP Session** field blank and complete any required verification manually. IMAP cannot retrieve SMS codes. *** ## Task Overview ### Monitor mode
### Normal mode
### Test Task * In order to make sure your account and session is configured correctly you must run a task that gets to waiting for monitor ping successfully * Please test your setup before the drop. If you're getting error 456, just clear your cookies in the session * If you experienced issues on the Checking Cart step before the update or got a token refresh error, please clear your cookies in the session and restart task ### **Which Mode Do I Use?** #### **Normal Mode** * Logs in, adds to cart, checks out * Must be linked with monitor mode (via Watch Task) for best performance * Automatically handles verification via IMAP #### **Monitor Mode** * Monitors stock for specific URLs/SKUs * When the product restocks → Monitor task pings Normal mode checkout tasks * Can use API or Cart monitoring Recommended setup:\ **1 Monitor → 1 Checkout (Normal)** per product. *** ## **Variant Support** Sam’s Club variants use the same base URL + unique itemNumber. #### **Base URL Example:** ``` https://www.samsclub.com/ip/pokemon-elite-trainer-box-poke-ball/P990425183 ``` #### **Variant Item Numbers:** * Poké Ball → 990396777 * Moon Ball → 990418051 {% hint style="info" %} Ask your [cookgroup](/stellar/getting-started-with-stellaraio/cook-groups.md) if you need URLs, variant numbers, etc. {% endhint %} #### **Variant URLs:** ``` Poké Ball: https://www.samsclub.com/ip/pokemon-elite-trainer-box-poke-ball/P990425183?itemNumber=990396777 Moon Ball: https://www.samsclub.com/ip/pokemon-elite-trainer-box-poke-ball/P990425183?itemNumber=990418051 ``` #### **Tip:** If you don’t care which variant you get → **use only the base URL.** *** ## **Task Settings** ### **Proxies** You can use **ISP proxies** and **Residential proxies** for Sam’s Club. #### **Recommended Usage** * **ISPs** * Best for monitoring * Good stability for logging in and low-traffic flows * **Residentials** * Recommended for majority of checkout tasks * Handle rotation well * Less likely to trigger bans on aggressive endpoints *** ### **Product URL** You can find the Product URLs from your [cookgroup](/stellar/getting-started-with-stellaraio/cook-groups.md) or you can copy from Sam’s Club product page directly. Example: ``` https://www.samsclub.com/p/pokemon-crown-zenith-sea-sky-premium-collection/P990345457 ``` *** ### **OID (OfferID)** An **OfferID (OID)** further identifies a specific Sam’s Club offer for an item. * Supplied by your [cookgroup](/stellar/getting-started-with-stellaraio/cook-groups.md) * Used for more accurate cart + checkout logic * Helps avoid incorrect listings or mismatched products If your task supports an OID input field, you will enter it here. *** ### **QTY (Quantity)** * Check with your [cookgroup](/stellar/getting-started-with-stellaraio/cook-groups.md) for limits * Sam’s Club varies by product * Stellar does *not* auto-adjust if your QTY exceeds site limits *** ### **Session** Select which Sam’s Club [account](#adding-accounts-sessions) to use. *** ### **IMAP Session** Select the [IMAP](#imap) configuration you want the task to use. *** ### **Login Method** * **Regular** → Normal login * **Reset** → Task resets your password then logs in * Useful if login issues occur * Uses IMAP verification *** ### **Delays** #### **Normal Mode Delay** * Retry speed for checkout * **Recommended: 2000 or lower** #### **Monitoring Delay** * Interval at which Monitor Mode checks stock * **Recommended: Around 5000** #### **Reset Delay** * Delay before re-running monitor after detecting stock * **Recommended: Around 5000** *** ### **Endless Mode** * Off → Task stops after successful checkout * On → Task keeps attempting checkouts repeatedly * Endless Limit → cap on total successful orders * Example: Entering `3` means the task will stop after 3 successful orders *** ### **Use Rakuten** * Enable cashback if configured * Follow [Rakuten guide](/stellar/navigating-stellaraio/what-is-the-settings-tab/how-do-i-set-up-rakuten-cashback.md) before enabling *** ### **Watch Task (Recommended)** When enabled: * Checkout task waits for Monitor task * Monitor task detects restock → pings checkout task * Checkout task immediately starts ATC + checkout This reduces: * Proxy bans * Request spam * Site load * Checkout failures When disabled: * Checkout task monitors + ATCs itself * More resource-intensive *** ### Skip Cart Clear This option controls whether Stellar clears the cart before checkout. #### **When Enabled** * **Skips clearing the cart for the item in the Product URL field** * Useful if you *intentionally keep an item in your cart* to speed up checkout * Helpful in certain repeat restock scenarios #### **Limitations** * **Not supported with MultiCart** * If MultiCart is enabled or required → Skip Cart Clear will NOT work #### **When to Use** Enable Skip Cart Clear if your cook group recommends “cart-stacking” or pre-loading technique for that product. Disable it if: * Running MultiCart * Running unpredictable restocks * Running tasks across multiple variants *** ### Common Errors And Fixes * **Getting Product: `status 404`** * *Cause:* Error retrieving the product page * *Fix:* * Double-check the product link * Include the correct variant format if required * **Stuck at “Solving PX (HC)”** * *Cause:* Issue solving Sam’s Club PX security * *Fix:* * Try different proxies * Reset the account password if needed * **Stuck at “Initializing PX”** * *Cause:* Proxy-related issue * *Fix:* * Try different proxies --- # 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/sams-club.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.