Setup guide · free Feedback Manager

From download to
your first feedback check.

Install the app on your server, give your private Amazon app only the permission it needs, test the connection and schedule a daily check for Amazon's official 1–3★ feedback report.

Before you start

Have these ready

Your hosting

  • PHP 8.1 or newer; ask your host to confirm it supports MySQL, outgoing web connections and encryption
  • Empty MySQL or MariaDB database and user
  • A private HTTPS address for the app
  • A hosting account that can run one scheduled command each day
  • Amazon professional seller account
  • Seller Central Primary user
  • Apps & Services → Develop Apps access
  • A truthful Amazon developer profile and security answers
Data responsibility stays with you. The report contains confidential seller information and order IDs. Host it securely, keep PHP and the server updated, restrict administrator access and include both the database and config.php in protected backups.
1

Verify your email, then download and upload

Request version 1.0.0, open the verification link sent to your email within 24 hours, and confirm once to download the ZIP. Unzip it and upload the whole feedback-manager folder to your own hosting. Use a private path under an HTTPS domain. Do not put the zip, database backup or a copy of config.php in a publicly downloadable folder.

2

Run the three-step installer

Open https://your-domain.example/feedback-manager/install.php. The first screen checks your version of PHP, HTTPS and whether the required folders can be written to. Then enter the empty database details and create an administrator password with at least 12 characters.

The installer creates a unique encryption key and saves it in config.php, separately from the database. It then tries to delete itself. If it cannot, delete install.php manually when instructed.
3

Create a private Amazon connection

Sign in to Seller Central as the Primary user, open Apps & Services → Develop Apps, complete Amazon's developer registration if needed and create a private Selling Partner API app for your own organisation.

Select Selling Partner Insights. This is the Amazon permission the Manager needs to read performance information. Do not add permissions for restricted order or address data; the Manager does not need them.

Use truthful security answers. The app runs on your server and stores only the star rating, comment, seller response and order ID needed for the dashboard. It does not store the email address included in Amazon's report.
4

Authorise the app and copy the three connection details

Open the app's Login with Amazon credentials and copy the full Client ID and Client Secret. Choose Authorize app for your seller account and copy the resulting Refresh Token. Do not email them, paste them into support messages or include them in screenshots.

5

Test before saving

Log in to the Feedback Manager, open Amazon connection, enter the three connection details and tick only the marketplaces where you sell. Choose Test and save. The Manager checks that Amazon accepts the details and that your seller account is active in those marketplaces. It saves the details only after the test succeeds.

The saved details are strongly encrypted. The encryption key is kept in config.php, outside the database, so a copy of the database alone cannot reveal them.

6

Schedule the daily check

Open Settings and copy the exact command shown under Daily schedule into your hosting control panel's scheduled-tasks section, sometimes called Cron Jobs. Run it once per day at a quiet time. The app prevents a manual check and a scheduled check from running at the same time.

The check runs privately on your server. It does not use a reusable web link that could appear in browser or server logs.
7

Run the first check and read the result correctly

Choose Fetch now. Amazon prepares a separate report for each marketplace and limits how quickly reports can be requested, so a multi-country check can take several minutes. If Amazon marks a marketplace CANCELLED, it can simply mean there was no negative or neutral feedback in the requested period. The Manager records that as an empty result rather than a failure.

1–3★ only. The official report does not contain 4–5★ positive feedback. The dashboard shows feedback that may need a reply; it is not a complete feedback record.
8

Back it up and use it

Back up the MySQL database and config.php together to protected storage that cannot be downloaded from your website. Review new feedback and feedback without a response, open associated orders in Seller Central, and download a filtered CSV spreadsheet when needed. Text that a spreadsheet could mistake for a formula is made harmless before download.

If you enable email alerts, the message says only how many new items there are. Your hosting account must be able to send email; feedback text and order IDs remain in the dashboard.

Troubleshooting

The usual causes

Amazon says “Invalid grant”

Copy all three connection details again. If Amazon cancelled the Refresh Token, authorise the app again and save the new token.

Amazon says “403” or “Access denied”

Confirm that Selling Partner Insights is approved on both your developer profile and the app, then authorise the app again so the permission is included.

Report is empty

This is often correct: Amazon returns no report when there is no 1–3★ feedback in the period being checked.

Manual check will not start

Your hosting company may prevent PHP from starting a task in the background. Run the command shown in Settings directly; the daily scheduled task remains the reliable method.

Email not received

Email alerts depend on your hosting account's email setup. The feedback check itself is unaffected.

Locked out

Wait 15 minutes after repeated failures, or run the included tools/reset-password.php command and follow its prompts.

Ready to install?

The software and this guide are both free. A verified email is required for the ZIP.

Get version 1.0.0Product page