Blank offers page docs

source/includes/_blank_offers.md

@@ -0,0 +1,24 @@
+# Blank Offers Page
+
+Recently, Amazon has begun to return an empty page instead of a list of product offers.
+This appears to be an anti-bot response by Amazon, caused by the IP addresses used to place orders.
+
+This appears to primarily affect the UK, DE, and IN regions. US, CA, and FR currently appear unaffected.
+
+When this happens, our ordering agent will respond with the error `amazon_antibot_blank_offers_page`.
+
+This is done because we cannot guarantee full ordering safeguards without accessing this offers page.
+
+There are two workarounds that can be attempted:
+
+1. Set `take_buybox_offers` to true on the top level of the ordering object.
+   This will automatically accept the first offer on the Amazon product page,
+   without applying any `seller_selection_criteria`. For safety, it is
+   suggested to set `max_price` and `max_delivery_days` as well. Because this
+   accepts the default offer, it will not require loading the broken page.
+
+2. Bring your own proxy with BYOP. Ideally, you should use a real
+   residential IP that is dedicated to your ordering flow. For more details,
+   review the [BYOP docs](/#proxies).
+
+We will continue to monitor the situation and update this page as new details emerge.

source/includes/_proxies.md

@@ -2,6 +2,14 @@
 
 The Zinc API interfaces with the retailers via proxies. This enables each retailer interaction session to use unique and consistent IP addressing. Due to many factors, sometimes the bulk proxies available to us become blocked by retailers. The best path to keeping your own account from being blocked is to provide your own proxy service, by either hosting your own proxy or purchasing a proxy from a provider. We call this "bring-your-own-proxy" (BYOP).
 
+## Where do I get a proxy?
+
+We cannot recommend any specific proxy provider. Many commerical providers are
+unsuitable because their IPs are low quality and shared among many users. It is
+best to use a real residential IP address dedicated to your ordering flow.
+
+One option is to deploy the Zinc proxy container, on Github at [zinc/zn-proxy](https://github.com/zincio/zn-proxy).
+
 ## Configure ZincAPI for your own proxy (BYOP)
 
 To configure a BYOP, you must provide the retailer, email account, and full proxy connection URL.
@@ -46,3 +54,4 @@ curl "https://api.zinc.io/v1/proxies/byop" \
 ## Disable BYOP
 
 Use the DELETE method instead of PUT.
+

source/index.html.md

@@ -20,6 +20,7 @@ includes:
   - object_reference
   - errors
   - FAQ
+  - blank_offers
 
 search: true
 ---