> 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/general-setup/common-errors-and-statuses.md). # Common Errors & Statuses The most common statuses and errors you will see across sites, alphabetized. Every entry here is general; the site-specific breakdowns live in each module's guide, and those are the authoritative ones for drop night. {% hint style="info" %} **Running a specific site? Check its guide first.** [Walmart's release guide](/modules/walmart/walmart-release-guide.md#common-errors-and-fixes) covers every Walmart error including Access Denied (456) and queue statuses. [Target's guides](/modules/target.md) cover Shape blocks, Waiting for Cookies, and cancellations. [Amazon](/modules/amazon/amazon-setup-guide.md#common-statuses), [Best Buy](/modules/bestbuy-us.md), and [Apple](/modules/apple.md) each cover their own statuses. {% endhint %} ## Statuses & Errors (A-Z) **Access Denied** * **What it means:** the account or proxy was flagged by the site's security. Seen on Amazon, and on Walmart as Access Denied (456). * **How to fix it:** let the task auto-rotate and retry. If it never recovers: increase delays, let the account rest, or use fresh higher-quality proxies. On Walmart, 456 has been extremely heavy at add to cart lately across all bots; see [Access Denied (456)](/modules/walmart/walmart-release-guide.md#access-denied-456) for the current situation and the only advice that helps. *** **Account In Use, Waiting** * **What it means:** the same account is being used by multiple tasks at once, which some sites do not allow. * **How to fix it:** run one task per account, and use more unique accounts. *** **Invalid Account Session** * **What it means:** the account has been logged out or the session expired. * **How to fix it:** re-login. Amazon: the lock button in the Accounts tab. Target: harvest login cookies. Walmart: run tasks with Use Saved Session off to generate a fresh session. *** **Invalid Address** * **What it means:** the site is rejecting the address in your profile. * **How to fix it:** verify every profile field is filled and formatted correctly (especially imported profiles), test the address manually on the site, and adjust your jig if blocked. Test with the exact info from the profile, pasted field for field: if the site rejects it manually, the bot cannot make it work either. On Walmart, see [Invalid Address Details](/modules/walmart/walmart-setup-guide.md#invalid-address-details). *** **Invalid Card Details** * **What it means:** the card is invalid, or the bank is blocking authorization attempts after too many in a short time. * **How to fix it:** verify the card details, then let the card cool off; the block clears on its own. Reuse the same card on the same account where possible. The full breakdown is in the [Walmart setup guide](/modules/walmart/walmart-setup-guide.md#invalid-card-details-max-card-attempts), and the same logic applies elsewhere. *** **Invalid Login** * **What it means:** the email or password is incorrect. * **How to fix it:** recheck the credentials in the Accounts tab, and verify by logging in manually. *** **Login via Tasks** * **What it means:** this site logs in through tasks, not the Accounts tab. Nothing is wrong. * **How to fix it:** just run your tasks. Do not try to log in manually. *** **Out of Stock, Retrying** * **What it means:** the product is out of stock and the bot is retrying. * **How to fix it:** no action needed. Let the task run. *** **Payment Failure** * **What it means:** your payment was declined, usually flagged as suspicious by your bank. * **How to fix it:** contact your bank to whitelist the charge, use a different card, or let the card rest. *** **Product Not Supported** * **What it means:** hover over the status for the reason. On Target it usually reads "Shipping not available for this product (Target $35+ restriction)": Refract only checks out with free shipping, and Target's free shipping needs a $35+ cart, so a product under $35 cannot check out on its own. * **How to fix it:** enable **Add Extra Product** on your tasks and set a custom filler item, like a Lego set, to bring the cart over $35. The filler is cancelled after checkout. See the [Target setup guide](/modules/target/target-setup-guide.md#task-creation). *** **Proxy Error** * **What it means:** the proxy is dead, expired, banned, out of data, or the provider is down. * **How to fix it:** test the proxies, replace the list, and remove any account proxies you did not mean to set. *** **Request Timed Out** * **What it means:** the task got no response, from site issues, proxy problems, or an overloaded network. * **How to fix it:** reduce task count, check your proxies, test on local IP, and check whether the site itself is down. *** **Setting Cookies** * **What it means:** the bot is generating cookies required to proceed. Normal. * **How to fix it:** let it continue. If tasks loop here (especially Walmart or Best Buy), your proxies are likely flagged; swap them. *** **SMS Required** (older versions: **Not SMS Verified**) * **What it means:** on Walmart, the account has no phone number attached and Walmart currently has SMS enforcement switched on. Enforcement comes and goes without warning. * **How to fix it:** verify the account with SMS, or run accounts that already have a number on them. See [SMS Required](/modules/walmart/walmart-setup-guide.md#sms-required). *** **Soft Banned (OOS)** * **What it means:** the site (typically Amazon) is returning a false Out of Stock even though the product is available. A soft ban on the account, proxy, or session, usually from too many requests too fast. * **How to fix it:** keep running and let tasks retry. If it persists: switch proxies, try another account, let things rest, or increase delays. See the [Amazon guide](/modules/amazon/amazon-setup-guide.md#soft-banned-oos). *** **Waiting for Product** * **What it means:** the task is waiting on the monitor, either because the product has not been found yet or because it is out of stock. This is the expected pre-drop status; tasks move on their own the moment stock is picked up. * **How to fix it:** nothing, if the product is out of stock or you have no monitor input set. If the product is in stock and tasks still sit here, check that the monitor input is correct and your monitor proxies are working. Also check your price max: cents are not supported, so a cap like `39.99` stops the product being picked up at all. Round up to the next whole dollar. * Older versions split this into two statuses, with "Waiting for Restock" shown once the monitor found an out-of-stock product. "Waiting for Restock" no longer exists; it is always "Waiting for Product" now. *** **Unknown Error / Unknown Response \[XXX]** * **What it means:** the site returned something the bot does not recognize. * **How to fix it:** check your proxies (the cause of most unknown errors), check your profiles for missing fields, restart the task, and open a ticket if it persists. On Walmart, Unknown Response \[400] usually means Walmart+ is required; see the [setup guide](/modules/walmart/walmart-setup-guide.md#unknown-response-400). --- # 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/general-setup/common-errors-and-statuses.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.