Skip to content
  • There are no suggestions because the search field is empty.

Amazon API - Restricted Data Tokens

Learn how to obtain and use your Restricted Data Token (RDT).

To protect its customer level Personal Identifiable Information (PII), Amazon will not include shipping address/contact information as part of an API call response by default. In order to retrieve this information, special authorization in the form of a Restricted Data Token (RDT) must be present.

Note: The Amazon Seller account instructions are based on Developer Central, not the Solution Provider Portal, which is a newer environment.

Applying for Restricted Data Token Access:

  • Point your browser to your Amazon Seller Central account
  • Click the hamburger menu at top-left; under Apps and Services, select the Develop Apps page
    • Click on the View profile link at the top-left 
      • Scroll down to the Data Access section
        • While several roles might trigger the RDT requirement, we utilize the features found in the Direct-to-Consumer Shipping role; select this role
        • The form will expand and require you to fill out a number of security and data retention based questions regarding your organization's handling of PII data
      • When you are done filling out these sections, select the Register button

Your application for an RDT will automatically be submitted to Amazon support, where it will be reviewed as a case log. Response time for this request take up to two weeks and your developer profile registration form will be locked for the duration.

Note: If Amazon denies your request, they will indicate which exact sections need further attention.  Rest assured, there are third parties that can assist you in analyzing your data access and storage retention to ensure full compliance.

Furthermore, you can contact us if you'd like additional assistance in completing the RDT access form.

Tip: if you are completely unable to acquire an RDT with Amazon, we have a backup solution for obtaining and importing shipping address information for your orders on Amazon.

 

Enabling RDT Functionality in your Amazon app:

If your RDT access is approved, you will need to enable this setting inside of every applicable application.
  • Point your browser to your Amazon Seller Central account
  • Click the hamburger menu at top-left; under Apps and Services, select the Develop Apps page
    • Click Edit App for the desired app
      • Scroll down and select the checkbox for role you wish to enable (for most, this will be the Direct-to-Consumer Shipping, which will allow for buyer contact information and address information to be available in API calls)
      • Click Save and exit
Caution: If you updated the role in the application and saved your changes, you will need to click on the drop-down arrow underneath the Action column and select Authorize App next to your application. This will give you a new Refresh Token that you'll need to both save locally and then update in your CSM application

 

Enabling RDT Functionality in CSM:

  • Search for CSM Sales Channels and select the related link
    • Under the Amazon Seller and API Data FastTab, you'll find a section titled Amazon Restricted Data Token Setup
      • Ensure all desired API Functions are checked so your integration can retrieve and store the related PII data

 

➡️ Next Step: Quick Setup Wizard