> For the complete documentation index, see [llms.txt](https://help.refractbot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.refractbot.com/modules/amazon/amazon-setup-guide.md).

# Amazon Setup Guide

This is the complete guide to setting up and running Amazon releases and restocks in Refract. Follow each section in order if you are a new user. For Freebies & Deals, use its own guide instead:

{% content-ref url="/pages/mHZpyCgwxnstfxyscQka" %}
[Amazon Freebies & Deals 101](/modules/amazon/amazon-freebies-and-deals-101.md)
{% endcontent-ref %}

## Prerequisites

* Amazon accounts with a **default shipping address and default payment method already set on the account**. Amazon is the only site where this is required; there are no profiles on Amazon, so Refract checks out with what is on the account.
* Amazon Teen and Amazon Business accounts are supported.
* ISP proxies, at least 1 per task.
* The product's **ASIN and Offer ID**. Run both; ASIN by itself is often too slow.
* Optional: 2FA secrets for accounts with 2FA enabled (see [Amazon 2FA Secret Creation](/modules/amazon/amazon-2fa-secret-creation.md)).
* Optional but recommended: the card **CVV** on each Amazon account, so Refract can auto-complete Amazon 3DS after checkout (see [CVV and 3DS](#cvv-and-3ds)).

{% hint style="warning" %}
**The best Amazon strategy: keep running through Access Denied and soft bans.** Blocks are expected on Amazon. Do not stop tasks when you see them; let tasks retry. Run each account up to 5 times, assuming you have the proxies for it (at least 1 ISP per task).
{% endhint %}

## Accounts Setup

{% stepper %}
{% step %}

#### Add your accounts

In the Accounts tab, create your accounts with **Amazon US** as the site (see the [Accounts guide](/general-setup/accounts.md) for the add flow). Amazon accounts show extra fields: **2FA Secret**, **Business Account**, and **CVV**.

If an account has 2FA, paste its key into the **2FA Secret** field:

{% content-ref url="/pages/A2BFM0IcdfNZAThDiz12" %}
[Amazon 2FA Secret Creation](/modules/amazon/amazon-2fa-secret-creation.md)
{% endcontent-ref %}
{% endstep %}

{% step %}

#### Add the account's CVV

Amazon may ask for a CVV after checkout. You have about 5 minutes to complete it, or the order is cancelled. Put the card's CVV in the **CVV** field when you create the account.

<figure><img src="https://2861066425-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjdmk3RduT9OdU2B3zFmG%2Fuploads%2Fgit-blob-44a4a9014775577905bce8abce478f17a3346e43%2Famazon-create-account.png?alt=media" alt="The Create Account window for Amazon US, with the optional CVV field at the bottom" width="420"><figcaption><p>The CVV field on an Amazon account. Refract uses this to auto-complete Amazon 3DS.</p></figcaption></figure>

For accounts that already exist, select the account, click the **pencil**, and fill in **CVV**.

<figure><img src="https://2861066425-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjdmk3RduT9OdU2B3zFmG%2Fuploads%2Fgit-blob-49b6792d4a6b25a3e6baae2b43d62483737d3fe5%2Famazon-account-cvv.png?alt=media" alt="The CVV field on the Update Account window" width="420"><figcaption><p>Edit an existing account to add or change the CVV.</p></figcaption></figure>

Without a CVV on the account, Refract does not auto-handle Amazon 3DS. See [CVV and 3DS](#cvv-and-3ds).
{% endstep %}

{% step %}

#### Check the account's defaults

Make sure each account has a default shipping address and default payment method set on Amazon itself. Refract uses the account's data at checkout, not a profile.
{% endstep %}

{% step %}

#### Log the accounts in

Amazon accounts must be logged in **before** you create tasks. Select the accounts and click the **lock** button. Amazon is the only site that logs in this way; do this first, every time.
{% endstep %}
{% endstepper %}

## Task Group Setup

Create a task group with **Amazon US** as the site (see [Task Group Creation](/general-setup/task-creation/task-group-creation.md)), then configure the settings panel:

<figure><img src="https://2861066425-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjdmk3RduT9OdU2B3zFmG%2Fuploads%2Fgit-blob-a3d4a8e4c86bd51110b1ea88a8a9e4f205452f1d%2Famazon-task-group.png?alt=media" alt="The Amazon US task group settings panel" width="380"><figcaption><p>The Amazon group panel. Run ASIN + Offer ID together.</p></figcaption></figure>

| Setting                                  | Value                                | Notes                                                                                                           |
| ---------------------------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------- |
| Use Multi Input                          | OFF unless running multiple products | Formats below                                                                                                   |
| Monitor Input                            | The product's ASIN                   | From the URL: `amazon.com/dp/B08SGTGTZD` → `B08SGTGTZD`. A URL will not work                                    |
| Monitor Proxy List                       | Your ISP list                        | Can be the same list as your tasks                                                                              |
| Monitor Delay                            | `3500` (default)                     |                                                                                                                 |
| Offer ID                                 | The product's OID                    | Run ASIN + OID together. ASIN alone is often too slow                                                           |
| Allow Third Party Vendors                | OFF                                  | ON to include third-party offers. Does nothing with an OID (already seller-specific)                            |
| Allow Used Products                      | OFF                                  | ON to include used offers. Does nothing with an OID (already condition-specific)                                |
| Price Min / Price Max                    | Leave blank                          | Price filters for 1 item, before tax and shipping. Blank means no limit. Whole dollars only: round up, no cents |
| Notify when Offer ID Found               | Optional                             | Posts to your notifications webhook when the monitor finds an Offer ID                                          |
| Skip Monitoring (If Offer ID is present) | OFF                                  | See [Offer ID, explained](#offer-id-explained)                                                                  |
| Max. Checkout Errors                     | `5` (default)                        | Checkout errors allowed before the task stops the attempt and returns to monitoring                             |
| Loop Checkouts                           | OFF                                  | ON to keep attempting checkouts after each success                                                              |

**Multi Input formats** (one per line, only with Use Multi Input on):

```
ASIN
ASIN;MAX_PRICE
ASIN;OFFERID
ASIN;MAX_PRICE;OFFERID
```

All inputs are monitored at once, not one at a time.

<figure><img src="https://2861066425-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjdmk3RduT9OdU2B3zFmG%2Fuploads%2Fgit-blob-38cac12ea6790afb2f7e3387e91d9d32e98a6947%2Famazon-group-settings.png?alt=media" alt="The lower half of the Amazon group settings" width="400"><figcaption><p>The lower half of the panel: vendor and condition toggles, prices, OID options, and Max Checkout Errors.</p></figcaption></figure>

## Task Creation

Click **+** in the task group to open Create Tasks.

{% hint style="danger" %}
**Log in to accounts before creating tasks.** The bot reminds you in this window for a reason. Tasks need logged-in accounts to run.
{% endhint %}

<figure><img src="https://2861066425-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjdmk3RduT9OdU2B3zFmG%2Fuploads%2Fgit-blob-c101dccc813cf4ffeb9b78824917760ac3315e01%2Famazon-create-tasks.png?alt=media" alt="The Amazon Create Tasks window, including Auto Open Browser for 3DS" width="450"><figcaption><p>Normal mode for releases and restocks. Auto Open Browser for 3DS is for Amex SafeKey and Capital One, not Amazon 3DS.</p></figcaption></figure>

| Setting                      | Value                          | Notes                                                                                                                                                                                              |
| ---------------------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Mode                         | Normal                         | **Raffle** enters raffles instead, typically for Amazon Japan                                                                                                                                      |
| Use Account Proxy            | OFF                            | Only if you deliberately assigned account proxies                                                                                                                                                  |
| Task Proxy List              | Your ISP list                  | At least 1 ISP per task                                                                                                                                                                            |
| Accounts                     | Your accounts or Account Group |                                                                                                                                                                                                    |
| Force Free Shipping (Slower) | OFF                            | ON prioritizes free shipping on accounts without Prime, at the cost of speed                                                                                                                       |
| Auto Open Browser for 3DS    | OFF                            | ON opens a browser for Amex SafeKey or Capital One 3DS. Not used for Amazon 3DS. A webhook is sent either way. See [CVV and 3DS](#cvv-and-3ds)                                                     |
| Retry Delay                  | `3500` (default)               |                                                                                                                                                                                                    |
| Task Qty                     | `1` to `5`                     | Tasks created **per account**. Up to 5 per account works if you have the proxies for it                                                                                                            |
| Item Quantity                | `1`                            | A ceiling, not an exact number: the task goes for the max it can get, up to what you set. Safe to set high. See [How Item Quantity works](/general-setup/task-creation.md#how-item-quantity-works) |

## Offer ID, explained

An Offer ID is a unique identifier for a specific product offer from a specific seller. Running an OID targets and spams Add to Cart on that exact listing, bypassing traditional monitoring for speed. For extremely limited items that go out of stock instantly, an OID can be the only way to cart in time.

The rules:

* **ASIN is required alongside the OID.** An OID never runs alone.
* **OIDs are not price-specific.** Prices can and do change on the same OID, so set a Price Max.
* **OIDs change frequently, and that is fine.** The same user can get a different OID on every refresh, multiple OIDs often point to the same offer, and old OIDs keep working. As long as it points to the right offer, it does not matter which one you have.
* OIDs come from your cook group or monitors, and the in-bot [monitor feed](/general-setup/task-creation/monitor-setup-and-multi-input.md#in-bot-monitor-and-checkout-feed).

**Skip Monitoring (If Offer ID is present):** with an OID in place, this skips monitoring entirely and immediately spams cart attempts. Use it when you know the drop time or the item is actively restocking and you need instant carts. Otherwise leave it off.

## CVV and 3DS

After a successful checkout, Amazon can ask for extra payment verification. There are two different prompts, and Refract treats them differently.

### Amazon 3DS (CVV verification)

This is Amazon's own popup, not your bank's. Amazon may ask you to enter the card's CVV on the order after you check out. You have about 5 minutes. If it is not completed in that window, the order is cancelled.

Refract auto-completes this step when the Amazon account has a CVV saved in the Accounts tab. Amazon 3DS does not open a browser. It is completed in the background from that CVV.

{% hint style="warning" %}
**Amazon 3DS is only auto-handled if a CVV is set on the account.** Add it when you create the account, or edit an existing account and fill in **CVV**. This is a separate Amazon popup. It is not Amex SafeKey or Capital One 3DS.
{% endhint %}

On Mass Input, append the CVV as the last field:

```
login:password;proxy;secret;cvv
```

### Bank 3DS (Amex SafeKey, Capital One)

This is a different prompt from your card issuer. The **Auto Open Browser for 3DS** toggle in Create Tasks is for this, not for Amazon 3DS.

* **ON:** Refract opens a browser so you can complete Amex SafeKey or Capital One 3DS.
* **OFF:** the browser does not open.
* A webhook is sent either way, so you still know it happened.

Amazon 3DS is auto-handled regardless of this toggle, as long as a CVV is set on the account.

### Success webhooks

Amazon success webhooks include status and important info. Read the **Info** and **Info (IMPORTANT!)** fields on every success.

<figure><img src="https://2861066425-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjdmk3RduT9OdU2B3zFmG%2Fuploads%2Fgit-blob-b176c0fb4238904e47b6f95c4c1e8d7628b0b9bb%2Famazon-success-webhook.png?alt=media" alt="A Successful Checkout webhook for Amazon with Info and Info (IMPORTANT!) fields" width="560"><figcaption><p>Amazon success webhooks include status and important info. Read every Info field.</p></figcaption></figure>

You may see:

* **Payment verification required:** finish approval in the browser or the email Amazon sends, within about 5 minutes, or the order will be cancelled. If a CVV is set, Amazon 3DS is already being auto-completed. If this is bank 3DS (Amex SafeKey, Capital One), complete it in the browser when **Auto Open Browser for 3DS** is on, or from that email.
* **Could not confirm the order on the account:** check the order on Amazon yourself.
* **Order ID may not match the one on the account:** the order number in the webhook may not be the one Amazon shows. Check the account.

Set your **Checkouts** webhook in **Settings > General** so these arrive. See [Settings](/general-setup/settings.md#webhooks).

## Common statuses

### Access Denied

**What it means:** the account or proxy was flagged. **This is normal on Amazon.** The strategy is to keep running through it and let tasks retry.

On the monitor specifically: a few Access Denied responses when first starting are normal. The monitor rotates proxies and settings in the background until it finds the optimal setup, then sits on "monitoring" for long stretches. That means it is working. The only concern is nonstop Access Denied spam that never recovers, which points to flagged proxies or accounts.

If it truly never recovers: increase task delays, let the account rest for several hours or days, or use fresh, higher-quality proxies.

### Soft Banned (OOS)

**What it means:** Amazon is returning a false Out of Stock even though the product is available. It is a soft ban on the specific account, proxy, or session, usually from too many requests too fast, low-trust proxies, or rapid logins from multiple locations.

**How to handle it:** same strategy, keep running. If it persists: switch proxies, try a different account, let the account rest, or increase the retry delay.

### No Default Payment Method / No Default Address

Amazon sometimes drops default settings on its own. To fix:

1. **Address:** verify the default shipping address on the account (the address section in the top left of the Amazon homepage) and make sure it is marked default.
2. **Payment:** remove the current default payment method and re-add it to re-establish it as the default.

### Payment verification required

**What it means:** Amazon or your bank needs extra approval after checkout. You have about 5 minutes. The success webhook shows this as **Info (IMPORTANT!)**.

**How to handle it:** if the account has a CVV, Refract auto-completes Amazon 3DS. For Amex SafeKey or Capital One, complete it in the browser if **Auto Open Browser for 3DS** is on, or from the email Amazon sends. See [CVV and 3DS](#cvv-and-3ds).

## FAQ

<details>

<summary>How many accounts do I need?</summary>

As many as you can have. There is no set number.

</details>

<details>

<summary>How many tasks per account?</summary>

Up to 5 tasks per account works, assuming you have the proxies for it (at least 1 ISP per task). Set Task Qty accordingly; it creates that many tasks per account.

</details>

<details>

<summary>What delays should I run?</summary>

Monitor `3500`, task retry `3500`. The defaults.

</details>

<details>

<summary>What proxies should I use on Amazon?</summary>

ISP proxies, at least 1 per task.

On Amazon, match your proxy location to where you are running. If your server is in Virginia, run proxies geolocated in Virginia. That is all there is to it, and it is an Amazon rule specifically, not general advice for every site.

</details>

<details>

<summary>Do Amazon Japan items ship to the US?</summary>

Almost none of them do. If your Japan orders keep getting blocked or cancelled, that is usually the reason rather than anything in your setup. Check that the item actually ships to your country before running it.

</details>

<details>

<summary>Do I need an ASIN if I am running an OID?</summary>

Yes. ASIN and OID always run together on Amazon.

</details>

<details>

<summary>Are Teen and Business accounts supported?</summary>

Yes, both.

</details>

<details>

<summary>Can I run another task on an account that is already doing Freebies?</summary>

Yes. Running an additional task for a different item on the same account is fine.

</details>

<details>

<summary>Is Price Max before or after tax and shipping?</summary>

Before. Price Max is the total of just the item.

Use a whole dollar amount: cents are not supported, so round up to the next dollar (`40`, not `39.99`). A price max with cents in it stops the task picking the product up at all.

</details>

<details>

<summary>Will the bot adjust quantity if Amazon's max is lower than my Item Quantity?</summary>

Yes. Item Quantity is a ceiling, not an exact number: if you request 4 and Amazon allows 2, the bot automatically goes for 2. You can set it high and let the task take the most it can get. This is automatic on every site except Walmart, which needs its Allow Lower Item Quantity toggle. See [How Item Quantity works](/general-setup/task-creation.md#how-item-quantity-works).

</details>

<details>

<summary>Do I need to add a CVV on my Amazon accounts?</summary>

Yes, if you want Amazon 3DS auto-handled after checkout. Without a CVV on the account, Refract does not complete Amazon's CVV verification, and the order can be cancelled after about 5 minutes. Add it in the Accounts tab. See [CVV and 3DS](#cvv-and-3ds).

</details>

<details>

<summary>What does Auto Open Browser for 3DS do?</summary>

It opens a browser for bank 3DS prompts, like Amex SafeKey or Capital One. It does not control Amazon 3DS. Amazon 3DS is auto-handled when a CVV is set on the account, whether this toggle is on or off. A webhook is sent either way. See [CVV and 3DS](#cvv-and-3ds).

</details>

<details>

<summary>The success webhook says payment verification required. What do I do?</summary>

You have about 5 minutes. If you set a CVV on the account, Amazon 3DS is already being auto-completed. If this is Amex SafeKey or Capital One 3DS, complete it in the browser (when **Auto Open Browser for 3DS** is on) or from the email Amazon sends. The webhook also includes other **Info** fields, like when the order could not be confirmed on the account. Always read them. See [CVV and 3DS](#cvv-and-3ds).

</details>


---

# 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://help.refractbot.com/modules/amazon/amazon-setup-guide.md?ask=<question>&goal=<endgoal>
```

`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.