2025-02 Amazon Pay Credential Changes

Due to a deprecation of an underlying API used to access Amazon Pay reports, the way users authenticate with Amazon Pay changed. New Amazon Pay merchants and merchants that had an account restructuring in the recent past are now unable to generate the old credentials.

The authentication changed from the previous Merchant ID / Auth Token pair to a public key / API key pair. Two new account fields were added and the old ones marked as deprecated (see Amazon Pay Account Fields) — see Amazon Pay for how to create the new credentials and the request shape for both account creation and updates.

Existing credentials cannot be migrated to the new authentication automatically. Although announced, Amazon doesn't yet provide a migration path. The API keys must therefore be created manually for all existing accounts.

Please inform your users about this change. Based on the information available at time of writing, the old credentials should work until March 2026.