# AmazonV3

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FZZSBuvZF5p8hMMfPWF6P%2Fimage.png?alt=media&#x26;token=5adc8c10-3785-4c34-9df8-bc3e629dddcd" alt=""><figcaption></figcaption></figure>

Our Amazon module supports account based checkout and offers several modes to handle monitoring, special restocks, timed drops and invite only releases. While Amazon uses strict bot protection, Stellar simplifies the process with automated logins, 2FA integration, OfferID support, and high speed task modes. This module is best suited for retail restocks, high demand products, household goods, collectibles and electronics that can appear or disappear from stock without warning.

***

### **Amazon Video Guide** <a href="#h_3e01888755" id="h_3e01888755"></a>

`New video guide coming soon...`

***

### **Quick Start (Recommended Setup)**

*(For members who want a fast setup without reading everything)*

1. Add your Amazon session under **Identities → Sessions** using **Request Login**
2. Add your **2FA Authenticator Key** into your Amazon session
3. Create 1-3 **Monitor tasks** for every SKU you want
4. Run **Special Mode** checkout tasks for the same SKUs. You can run multiple checkout tasks per Amazon account allowing you to run for multiple products at the same time
5. Use **ISP proxies**
6. Before major drops, run a **test task** on an in stock item
7. Use **OfferIDs only when required** (e.g., exact timed drops)
8. Leave **Shipping Speed** field empty if your Amazon account has Prime membership
9. Keep your **Amazon account updated** with default payment + address

***

### **Preliminary Checklist**

Before setting up tasks on Amazon, make sure you have everything below prepared:

* [ ] **Proxies**

> - ISPs recommended
> - Use login proxy for better session stability
> - DCs can be used
> - Avoid burning residentials for monitoring
>   * 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 proxies

* [ ] **Amazon Accounts**

> - Account required
> - Make sure billing, shipping, and payment methods are correct
> - Keep default address + default payment active

* [ ] **Authenticator App (Required)**

> - Install Google Authenticator on your phone or computer (recommended)
> - Needed for Request Login setup

* [ ] **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.

* [ ] **Test Task**

> Before big drops, run a **test task** on a random in stock product to confirm your account, proxies and delays are functioning correctly.

***

### **OfferID Overview** <a href="#h_3e01888755" id="h_3e01888755"></a>

An **OfferID (OID)** identifies the exact seller, price, and listing configuration.

* OfferIDs are **unique to a specific item + seller**
* Incorrect OID = buying incorrect or overpriced items
* [Cookgroups](https://guides.stellaraio.com/stellar/getting-started-with-stellaraio/cook-groups) usually supply accurate OfferIDs

> **Note:**\
> When using OfferIDs, Stellar ignores the “Max Price” field because the OID already locks the exact offer.

***

### **Sessions & Login** <a href="#h_8da3b91861" id="h_8da3b91861"></a>

1. Go to the **Identities** tab

<div align="center"><figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FGd6LcvDZ7a6RfzcYcBd9%2Famzsession.PNG?alt=media&#x26;token=a0a94a76-8162-4d70-a260-91675e05bc31" alt=""><figcaption></figcaption></figure></div>

2. Click on **Add Session** and name your Session

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FSxi7jWExkJvbs3evhkjZ%2FScreenshot%202023-09-24%20162343.png?alt=media&#x26;token=f444014f-ae56-4ff0-953e-9811a4f828c6" alt=""><figcaption></figcaption></figure>

3. Enter:

* Region
* Account Email
* Account Password
* Account Type - Personal or Business (If you only have a single account tied to your login, you can ignore this setting and keep your current setup.)
* Authenticator Key (Request Login only)
* CVV - Enter CVV of your payment method saved on your Amazon account that's set as Default/Preferred&#x20;
* Login Method - Request Login or Browser Login
* Login Proxy - This is highly recommended for Amazon. This will heavily reduce the number of times you have to re-login for multiple tasks. ISP proxies are recommended

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FXdylHJahftogrJpzXenP%2Fimage.png?alt=media&#x26;token=e6420018-4436-4723-a66a-d4a65789f3e2" alt="" width="375"><figcaption></figcaption></figure>

Make sure you have Google Chrome on your computer, this is required for the login step

Here’s a **cleaned-up, shorter version** you can drop straight into the Amazon guide:

**Important:** If your Amazon accounts are **re-logging in frequently**, it’s usually proxy-related.

Use **clean ISP proxies assigned directly to your sessions**. Residential proxies rotate IPs, which forces Amazon to re-login on every change. A single clean session IP can stay stable for **1–2 weeks** without issues.

Avoid running **multiple tasks on the same account at the same time**. Logging in or checking out from different IPs simultaneously will almost always trigger a re-login.

For best results:

* Assign **one dedicated, clean ISP** per Amazon account
* Do not rotate session IPs
* Avoid sharing accounts across tasks

Amazon aggressively protects accounts and re-login is one of their most common safeguards.

***

### **Account Type setting (Personal vs Business)**

Amazon sessions include an Account Type option that lets you choose whether the bot logs into a Personal or Business account.

* **Only required for linked accounts**\
  This is only needed if **one Amazon login has both Personal and Business accounts linked**. The selector tells Stellar which one to use during login
* **Checkout remains fully automated**\
  The module still handles checkout automatically. This setting only affects which account type is selected at login
* **Troubleshooting**\
  If login hangs or behaves unexpectedly, make sure you’re on the latest version and open a support ticket. Some Amazon logins return multiple variants that require additional handling

***

### **Login Methods**

**Request Login (Recommended)**

Uses your [Authenticator Key](#authenticator-app-required) to log in via request (no browser pop-up).\
Most stable and fastest.

**Browser Login**

A browser window will appear and Stellar will auto-fill your credentials.\
Use if Request Login is failing.

***

### **Authenticator Key Setup** <a href="#h_50c8b20444" id="h_50c8b20444"></a>

Required for Request Login

To setup and find your Amazon 2FA authenticator key follow these steps

1. Login to your Amazon account and locate the **Account** section on the Amazon site

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2F0NHbXBVcrIrTVURCP2ky%2Famzaccount.PNG?alt=media&#x26;token=162cdc19-fedc-482d-a2d2-4c31fcd0b4fa" alt=""><figcaption></figcaption></figure>

2. Next go to the **Login and Security** tab

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FmoIuokUTZciVD6vxCToy%2Famzloginsecurity.PNG?alt=media&#x26;token=13c37790-fb14-452c-8d75-0af85fb8a110" alt=""><figcaption></figcaption></figure>

3. Now click the **Edit** button next to (in the same row as) "Two-Step Verification (2SV) Settings:"

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FfuTQGZqDvhBdyOpa0wX4%2Famz2sv.PNG?alt=media&#x26;token=b1f20cb2-33ff-4f13-a86e-9c3f32735b14" alt=""><figcaption></figcaption></figure>

4. Click **"Get Started"**
5. Click the **Authenticator App** option (Not the phone number one)

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2F5gvZVXaugAzYv6LjC53Q%2F2svbackup.PNG?alt=media&#x26;token=b98ac2b2-ac51-4f75-b999-dc2c1e615fcc" alt=""><figcaption></figcaption></figure>

6. Click the **"Cant scan the barcode?"** dropdown

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FECHZS2SMPIUxiVha2Pn6%2Fqrcode.PNG?alt=media&#x26;token=f80c8a1f-d861-4dfe-94c5-2f52ac966ae1" alt=""><figcaption></figcaption></figure>

7. Now copy the **authenticator key**, it should be in bold and around 30 characters, save this key somewhere (Will be needed later)

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FYEHvBhuoghjTduuP1uEQ%2F2fakey.PNG?alt=media&#x26;token=575ce372-a08a-4ac6-b5a6-2d1bf8b23db8" alt=""><figcaption></figcaption></figure>

8. Next scan the QR code with an authenticator app you have on your phone (Recommended to use Google Authenticator). **Scan the QR code** in the authenticator app and **enter the code** (usually 6 digits) that is generated into the OTP section above in Amazon.com. Click **Verify OTP and Continue**
9. Enter your Authenticator Key (around 30 characters) into your Amazon session&#x20;

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2F8Zui06QHzeo3Pp6OmEp4%2Fimage.png?alt=media&#x26;token=72d99f5e-e20f-4914-9a88-74e25cc942fb" alt="" width="375"><figcaption></figcaption></figure>

***

### **Amazon Mass Import Sessions** <a href="#h_50666e31cc" id="h_50666e31cc"></a>

To Mass Import Amazon accounts go to **Sessions** tab > Click **Mass Import Sessions**

<div align="left"><figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FVcVGRWnbsVIwhI9fjCfd%2FMass.png?alt=media&#x26;token=91cfecff-3136-4d26-a10e-f912fdfe8bc5" alt=""><figcaption></figcaption></figure></div>

**Format:** `Email;Password;LoginProxy;Region;AuthenticatorKey`

or

**Format:** `Email;Password;;`

**Example:** `Test@Stellar.com;Stellar9;;USA;XXXX`

This is an example of a mass import account without a login proxy with the United States region REGION: You must put `USA` or `CA` as your region code, and an authenticator key. If no region is input then it will default to `USA`

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FtdnN1z5Bf90TgmaRR2oL%2FMass%20Import.png?alt=media&#x26;token=c1476276-151b-4474-9821-530c0c3db3da" alt=""><figcaption></figcaption></figure>

Click **Save** once you're done

***

#### Task Strategy & Timing <a href="#task-strategy-and-timing" id="task-strategy-and-timing"></a>

**How Many Monitor Tasks Should I Create?**

* Run **1 Monitor task per Tag Group**.
* A single monitor can safely handle up to **30 SKUs** within one Tag Group.
* 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 Tag Group is sufficient for most users.

***

**How Many Checkout Tasks Per Account?**

* **Strictly 1 checkout task per Amazon account using fast mode, you can run mulitple SKUs that does NOT match the fast mode SKU.**
* Running more than one checkout task using fast mode on the same account will cause:
  * Account locks
  * Checkout failures
  * Login/session instability

**Rule:** 1 account = 1 checkout task (no exceptions).

### **Task Overview** <a href="#h_e7a25c9cd4" id="h_e7a25c9cd4"></a>

### **Monitor Mode**

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FDRDYOxDUJw0lsAYPr5cZ%2Fimage.png?alt=media&#x26;token=f4409520-fad3-44af-aaa6-f58870c9a024" alt=""><figcaption></figcaption></figure>

### **Special Mode**

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FF9MiO6ZFXtUHxgdq6Dh2%2Fimage.png?alt=media&#x26;token=81eb32c0-a948-44ae-9f61-bd5c0aa33e3e" alt=""><figcaption></figcaption></figure>

### Fast Mode

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FSHwHKasFRv4EyX5cOiA8%2Fimage.png?alt=media&#x26;token=15cce1eb-cff7-49cc-aa15-865485b68138" alt=""><figcaption></figcaption></figure>

### **Invite Mode**

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FrUINkJEQw3eje0UIW5No%2Fimage.png?alt=media&#x26;token=bdaf827e-81d4-421d-8591-18fa9d3e69d3" alt=""><figcaption></figcaption></figure>

***

### When to Use Modes

{% hint style="warning" %}
You need to have a default payment method, default shipping and billing information saved in your Amazon account. Make sure this is updated and Stellar will be using this information for your orders
{% endhint %}

### **Special Mode**

* Watch Task is ON by default
* Works for Prime or non-Prime accounts
* Best for most Amazon drops/restocks

### **Fast Mode**

* **Strict 1 task per account, 1 ASIN per task**\
  No multi-SKU support. Do not run more than one Fast task on the same account or you will get rate limited for several hours
* **Simple setup, no monitors or captchas**\
  Fast Mode does not require monitor tasks or captcha solving. Just enter ASIN, Offer ID (OID), quantity, delay and max price
* **Delays and rate limits**\
  You can run delays as low as 1000ms. If you hit rate limits, stop tasks and wait at least 2 hours before retrying
* **Proxy and usage limits**\
  1–2 Fast tasks can run without proxies; more than that should use proxies. There is currently a limit of 20 Fast Mode tasks per instance. Fast Mode only supports US and UK Amazon regions

### **Invite Mode**

Used to request **Amazon Invite-Only** product access (e.g., PS5/GPUs historically).

This mode is only for EU / UK regions

You can enter multiple SKUs for Invite Mode

### **Monitor Mode**

* Required for all normal checkouts
* Only monitors stock, does NOT checkout
* Should match the SKU(s) of your checkout task

***

### Proxies

The best type of **proxies** to use are ISPs and DCs. This is because you can run your tasks for a longer period of time without eating away your residential data

* If you're looking for proxies, check out [Stella Proxies](https://guides.stellaraio.com/stellar/getting-started-with-stellaraio/proxies) for high quality ISP and Residential proxies

***

### Bulk CSV List

This option allows you to create monitor mode tasks in  bulk so you don’t have to click and create them one by one. This will save you a lot of time.

***

### **SKUs & Input List**

**What is a SKU?**

Example link:

```
https://amazon.com/.../dp/B07RQ1HNFQ
```

SKU = **B07RQ1HNFQ**

**Input List**

You may enter:

* A single SKU (recommended)
* SKU:OfferID format (only for spam ATC or timed drops)

You can enter multiple SKUs for Invite Mode

#### Important

Using **SKU:OfferID** format in checkout tasks such as Special mode disables monitoring, it spams ATC directly. You cannot use SKU:ID format for monitor mode tasks.

This is only recommended for **precise timed drops**. It's not recommended to use this SKU:OID format for random restocks

***

### OfferID Section

Enter an OfferID supplied by your [cookgroup.](https://guides.stellaraio.com/stellar/getting-started-with-stellaraio/cook-groups)

OfferIDs look like long encoded strings:

```
oMrO1WgKMAyYYOA9b3ha7fDl2HKjh3sY8PrRchCj%2BcPvx9...
```

***

### **Delays**

*(Recommended — always test your own setup)*

**Monitor Mode**

* \~5000ms

**Special Mode**

* \~1000ms

**Cloud Mode**

* \~1000ms

**Invite Mode**

* \~1000ms

***

### Regions

Use the region where the product is dropping.

***

### **Quantity (QTY)**

Check with your [cookgroup](https://guides.stellaraio.com/stellar/getting-started-with-stellaraio/cook-groups), limits vary by item.

Amazon may auto adjust quantities even if you set 99.

***

### **Sessions**

This lets you pick which stored Amazon session/account to use.

***

### Monitoring Methods

**Fast Method**

* Requires OfferID
* Independent of account cookies
* Less likely to soft ban proxies
* Fastest monitoring

**Scrape Method**

* Does NOT require OfferID
* Reads frontend webpage
* More prone to soft bans
* Set proper price checks

**Business Method**

* Designed for Amazon Business accounts
* Uses Business specific stock and pricing
* Recommended for Business only listings

***

### **Captcha Provider**

* Choose **Capmonster** if you want auto-solving
* If left blank, the bot rotates proxies instead
* Amazon eventually detects proxies; Capmonster helps prevent stalls

***

### **Should Solve Captcha**

* ON → solve captchas
* OFF → rotate proxies instead

***

### **Amazon Warehouse Deals**

* Check if you want to monitor Warehouse deals

***

### **Amazon Third Party**

* Check if okay with third-party sellers

***

### **Check Quantity Limit**

* Stops task if site limit is reached

***

### **Clip Discount**

* Automatically clips coupons on product page

***

### **Skip 3DS**

* ON → attempts to skip 3DS challenge (faster, but riskier)
* OFF → normal checkout flow; may require manual approval

***

### **Use TopCashBack**

Earn cashback when enabled.

***

### **Endless Mode**

Task restarts after successful checkout.

***

### **Endless Limit**

Sets max number of checkouts (works only with Endless Mode enabled).

***

### **Common Status Codes** <a href="#h_b51f24136c" id="h_b51f24136c"></a>

* **Amazon Antibot | Rotating Proxy**
  * *Cause:* Account or proxy is being flagged by Amazon antibot during the flow
  * *Solution:*
    * Let the task run and allow proxies to rotate
    * Try different proxies
    * Increase task delays
* **Captcha Detected | Rotating Proxy**
  * *Cause:* A captcha appeared during the flow
  * *Solution:*
    * Try different proxies
    * Check if the account has a soft ban (dogs)
    * If soft banned, let the account rest for a couple of days
    * Temporarily switch login method to browser
    * Restart task to log in, then switch back to request login
* **Waiting For Monitor**
  * *Cause:* Waiting to be pinged from another source
  * *Solution:*
    * Let the task run
    * Status will update once pinged from a monitor task or server-side
* **Looping on “Placing Special Order” / “Waiting for Monitor” (no checkout)**
  * *Cause:* Usually an issue on the site’s end
  * *Solution:*
    * Manually re-enter CVV in your Amazon account
    * Amazon periodically requires CVV re-entry
* **Getting Rendered Addresses**
  * *Cause:* Proxy issue or ZIP code issue
  * *Solution:*
    * If stuck for several seconds, change proxy list
    * Do not use ZIP code if not needed
    * ZIP code is mainly required for UK (not US)
* **Adding to Cart 302**
  * *Cause:* Product went out of stock during checkout
  * *Solution:*
    * Restart tasks
* **Failed to Find OID**
  * *Cause:* Bot issue
  * *Solution:*
    * Switch modes
    * Try Special mode


---

# Agent Instructions: 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:

```
GET https://guides.stellaraio.com/stellar/retailers/amazonv3.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
