Install the app on your server, give your own private Amazon app the minimum role it needs, test the connection and schedule the official 1–3★ feedback report.
Before you start
config.php in protected backups.Download version 1.0.0, 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.
Open https://your-domain.example/feedback-manager/install.php. The first screen checks PHP, extensions, HTTPS and write access. Then enter the empty database details and create a 12+ character administrator password.
config.php. It then attempts to delete itself. If it cannot, delete install.php manually when instructed.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 SP-API app for your own organisation.
Select Selling Partner Insights. Amazon also maps the feedback report to Amazon Fulfillment, but Selling Partner Insights is the narrower performance-information fit. Do not add restricted order/address roles for this Manager.
Open the app's LWA 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.
Log in to the Feedback Manager, open Amazon connection, enter the three credentials and tick only the marketplaces you actually sell in. Choose Test and save. The Manager mints a short-lived access token and checks marketplace participation. Credentials are saved only after that succeeds.
Saved values use authenticated AES-256-GCM encryption. The key is outside the database in config.php, so a database-only leak does not reveal the credentials.
Open Settings and copy the exact command shown under Daily schedule into your hosting control panel. Schedule it once per day at a quiet time. The job uses a database lock, so a manual fetch cannot overlap it.
Choose Fetch now. Amazon creates one report per marketplace and applies a strict create-report rate limit, so a multi-country run can take several minutes. A marketplace Amazon marks CANCELLED can simply mean there was no negative or neutral feedback in the requested window; the Manager records that as empty, not as a failure.
Back up the MySQL database and config.php together to protected storage outside the web root. Review unseen and unanswered rows, open associated orders in Seller Central, and export filtered CSV when needed. Formula-leading CSV cells are neutralised.
If you enable email alerts, the message contains a count only. Your server must have PHP mail configured; feedback text and order IDs remain in the dashboard.
Troubleshooting
Re-copy all three LWA values. If the refresh token was revoked, self-authorise again and save the new token.
Confirm Selling Partner Insights is approved on the developer profile and app, then re-authorise so the refresh token includes it.
This is often correct: Amazon returns no document when there is no 1–3★ feedback in the explicit lookback window.
Your host may disable background exec. Run the Settings cron command directly; daily cron remains the reliable route.
Count alerts depend on your host's PHP mail configuration. The feedback fetch itself is unaffected.
Wait 15 minutes after repeated failures, or run the included interactive tools/reset-password.php command.