# Sams Club
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.
***
### **Quick Start (Recommended Setup)**
1. Add your Sam’s Club account under **Identities → Sessions → Sam’s Club**.
2. Set **email codes as your Sam's Club account’s preferred verification method** (SMS does *not* work for IMAP).
3. Configure **IMAP** so Stellar can automatically fetch verification codes (IMAP is required).
4. Create profiles with billing, shipping and payment details.
5. Run:
* **1 Monitor mode task** per product
* **1 Normal mode checkout task** per product
6. For variants, append `?itemNumber=VARIANT` to the base URL.
7. Use ISPs + residentials depending on your task types.
8. Keep delays low (Normal \~1000 ms, Monitor \~5000 ms).
***
### **Preliminary Checklist**
Before setting up tasks on Sams Club, make sure you have everything below prepared:
* [ ] **Profiles**
> Create and save your checkout [profiles](https://guides.stellaraio.com/stellar/navigating-stellaraio/what-is-the-profiles-tab/how-do-i-add-a-profile) 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
* **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**
> - Add Sam’s Club accounts via the **Identities → Sam’s Club** tab.
> - Email verification must be set as the **preferred method** in your Sam’s Club account settings.
***
### 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 **required** for Sam’s Club.\
It allows Stellar to automatically read login + verification codes from your email.
Benefits:
* Faster verification
* Fewer login issues
* Seamless reset/login flows
Make sure to:
1. Set up IMAP following the [IMAP Guide](https://guides.stellaraio.com/stellar/navigating-stellaraio/what-is-the-identities-tab/imap-overview)
2. Add your IMAP session in **Sessions → IMAP**
3. Select it in your Sam’s Club task under **IMAP Session**
***
#### Task Strategy & Timing
**How Many Monitor Tasks Should I Create?**
* Run **1 Monitor task per SKU**.
* You can run multiple Monitor tasks if you want redundancy, but it’s **not required** and usually unnecessary.
* Monitor tasks are lightweight and can run 24/7.
**Recommended:** 1 Monitor task per SKU is sufficient for most users.
***
**How Many Checkout Tasks Per Account?**
* **Strictly 1 checkout task per Sams Club account.**
* Running more than one checkout task on the same account can cause:
* Account locks
* Checkout failures
* Login/session instability
**Rule:** 1 account = 1 checkout task (no exceptions).
### Task Overview
### Monitor mode
### Normal mode
### **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](https://guides.stellaraio.com/stellar/getting-started-with-stellaraio/cook-groups) 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
#### **General Tips**
* Avoid mixing burned/flagged proxies with fresh ones
* Use separate proxy groups for monitoring vs checkout
* Test both ISP and resi depending on the item and drop timing
If you need quality proxies, [Stella Proxies](https://guides.stellaraio.com/stellar/getting-started-with-stellaraio/proxies) offers both ISP and Residential options.
***
### **Product URL**
You can find the Product URLs from your [cookgroup](https://guides.stellaraio.com/stellar/getting-started-with-stellaraio/cook-groups) 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](https://guides.stellaraio.com/stellar/getting-started-with-stellaraio/cook-groups)
* 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](https://guides.stellaraio.com/stellar/getting-started-with-stellaraio/cook-groups) 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: 1000 ms or lower**
#### **Monitoring Delay**
* Interval at which Monitor Mode checks stock
* **Recommended: \~5000 ms**
#### **Reset Delay**
* Delay before re-running monitor after detecting stock
* **Recommended: \~5000 ms**
***
### **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](https://guides.stellaraio.com/stellar/navigating-stellaraio/what-is-the-settings-tab/how-do-i-set-up-rakuten-cashback) 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
