FAQ
How long should I expect my integration with Amazon Instant Access to take?
We expect that integration takes 2-3 days with an additional 3-5 days for verification/testing.
Who do I contact for technical support?
Send an email to d3-support@amazon.com. Please include your company name in the subject line to make tracking easier.
Do my API endpoint URLs need to be HTTPS?
Yes. For security reasons, the fulfillment and account link API endpoints must use HTTPS.
My tests are failing due to an "SSL error". How do I fix this?
Your SSL certificate may not be valid. Please ensure that your certificate is valid and passes testing in common tools such as the one found here: https://sslshopper.com/ssl-checker.html
How can my subscription customers manage their subscriptions on the Amazon website?
To direct a customer to billing details for a specific subscription, link them to the following URL:
Here's an example with an ID filled in (please note that this example link will take you to our top-level subscriptions management page, as this example's subscription ID does not belong to your Amazon account):
We would like to send a "Welcome Email" to our subscribers who sign up through Amazon. Are we allowed to do that?
Absolutely. We have several vendors who send "welcome kit" emails to customers. These emails can tell them about the product, how to navigate, engage, etc. These are fine as long as these emails don't encourage a customer to move to subscribe directly with the vendor or describe confusing billing.
What IP addresses should I whitelist on my firewall so Amazon can contact my service (for inbound connections)?
The IP ranges used by Amazon are available in JSON form from here. You should expect these IP ranges to change up to several times per week. As such, your systems must must poll the list of IP ranges and update the whitelist accordingly, as described in the documentation.
Please keep in mind that authentication is built-in to the Instant Access API, thanks to the Authorization signature included in all messages sent by Amazon to you. As such, IP whitelisting for the purpose of authentication is almost always unnecessary.
What is the size of the popup registration window?
The size of the popup registration window is 600x500.
What kind of SLAs should I have?
For the link API call:
- 50% of all responses should occur within 1 second
- 99% of all responses should occur within 5 seconds
For purchasing and subscribing API calls:
- 50% of all responses should occur within 5 seconds
- 99% of all responses should occur within 15 seconds
Does Amazon have any sort of retry policy?
For link and purchasing APIs:
- If the initial request fails, Amazon makes a quick series of rapid-fire requests
- If all of those requests fail, then Amazon retries 3 more times in 15 minutes intervals.
- If all of those attempts fail, then the purchase is cancelled and refunded.
For subscribing APIs:
Subscriptions products in Amazon.co.jp:
- If the initial request fails, Amazon makes a quick series of rapid-fire requests
- If all of those requests fail, then Amazon retries 3 more times in 15 minutes intervals.
- If all of those attempts fail, then the purchase is cancelled and refunded.
Subscriptions products in Amazon.com:
- If activateSubscription call fails, then it will surface to the Amazon Customer. The customer can make the decision to retry.
- If deactivateSubscription call fails, then Amazon makes a quick series of rapid-fire requests. If all requests failed, the subscription will be deactivated on Amazon, however the subscription may not be deactivated on your end.
I went to view my products on Amazon.com and they were not purchasable. What happened?
Amazon has a service that periodically monitors the health of all of it's vendors. This is to ensure that products available on the detail pages are actually purchasable in order to provide the best experience possible to Amazon customers. If we detect that your end point is not working as intended, Amazon will make your products unavailable to maintain a good customer experience. When Amazon detects that your end point is back functioning, the availability of your products will be restored.
I'm getting a lot of requests to my system's endpoint. Why is this?
Amazon sends automated health checks to all vendors to ensure that they are available to process requests that we might be sending. To ensure a consistent and positive customer experience, we will disable your products if your system is in an unhealthy state. For more information on the health check, please see section 2.1 Account Linking.