How do I troubleshoot an Amazon connection error in MerchantSpring?

MerchantSpring connects to Amazon Seller Central and Vendor Central through Amazon’s APIs. If the connection encounters an issue, you may see errors indicating that the channel is disconnected or unable to retrieve data.

These connection issues are typically related to authentication, permission changes, or temporary API interruptions.

Understanding how to troubleshoot these errors can help restore the connection quickly.

Common Causes of Amazon Connection Errors

Expired Authorization Tokens

Amazon integrations rely on authorization tokens that periodically expire. When this occurs, MerchantSpring can no longer access the Amazon APIs until the connection is reauthorized.

Permission Changes in Amazon

If user roles or permissions within Seller Central or Vendor Central are modified, the application may lose the ability to access certain datasets.

Amazon Security Updates

Changes such as password updates, two-factor authentication changes, or account ownership transfers may invalidate previously authorized applications.

Amazon API Service Interruptions

Occasionally, Amazon’s APIs may experience temporary outages or maintenance events that interrupt data access.

These interruptions typically resolve automatically.

Steps to Troubleshoot a Connection Error

Navigate to Settings → Channels
Locate your Amazon account connection
Check the connection status
If the status indicates an error, select Reconnect
Complete the Amazon authentication process
Confirm that MerchantSpring is granted the requested permissions

Once the connection is restored, data syncing should resume automatically.

Notes:

Reconnecting the account will not delete historical reporting data.
Advertising integrations may require separate authentication.
Some datasets may take time to refresh after reconnection.

Troubleshooting

If the connection error persists after reconnecting, please contact support@merchantspring.com.au so our team can review the integration.