Connecting Amazon

You'll need

• An approved Amazon Associates account (your usual affiliate account)
• 10 qualifying sales in the last 30 days — Amazon's eligibility threshold for PA-API access through the Creators API
• 5 minutes

Step 1 — Find the Creators API panel

Log into Amazon Associates Central. In the top navigation, open Tools → Creators API. You'll see a card called Applications.

If you see "Your account does not currently meet the eligibility requirements," you don't have 10 qualifying sales in the last 30 days yet. Amazon retired the older PA-API 5.0 in May 2026; only the Creators API is available, and it requires the higher threshold.

That doesn't block you from using Velantio. Skip this whole page for now and use Creating a table → Add manually to enter products by hand. Embedding, click tracking, analytics, and the WordPress plugin all work without an Amazon connection. The only features that wait on eligibility are ASIN/keyword search inside the editor, and the 24-hour price auto-refresh. Come back here when Amazon turns the API on for your account.

Step 2 — Create an application

Click Create App. Give it any name (e.g. Velantio tables). Submit.

Step 3 — Add a new credential

Inside the app, click Add new credential. Amazon shows a dialog with three fields:

• Credential ID — starts with amzn1.application-oa2-client.
• Secret — starts with amzn1.oa2-cs.v1.
• Version — e.g. v3.1

Copy the secret before closing the dialog. Amazon won't show it again. You'll have to delete the credential and create a new one if you miss it.

Step 4 — Paste into Velantio

In Velantio go to Dashboard → Settings. Fill in:

• Marketplace — pick the Amazon storefront you're sending traffic to (US, UK, DE, etc.)
• Credential version — the version Amazon showed you. Most new NA accounts get v3.1. The form auto-picks based on marketplace; override if Amazon shows something different.
• Credential ID — paste it
• Credential secret — paste it
• Partner tag — your Associates store ID (e.g. yoursite-20)

Click Verify and save. Velantio calls Amazon with a known-good test ASIN to confirm everything works, then encrypts the secret with AES-256-GCM before storing it.

Region rules

Credentials are region-scoped:

• v3.1 (NA) covers US, CA, MX, BR
• v3.2 (EU) covers UK, DE, FR, IT, ES
• v3.3 (FE) covers JP, IN, AU

If you pick a marketplace outside your credential's region, Velantio returns a clear error before sending the request. To sell in multiple regions, generate a separate credential per region and (for now) keep one Velantio account per region.

What we do with the secret

• Encrypted at rest with AES-256-GCM in the database
• Decrypted only at request time, in memory
• Never logged, never proxied, never sent anywhere except Amazon's token endpoint and PA-API
• You can disconnect at any time from Dashboard → Settings

Troubleshooting

| Error message | What it means | |---|---| | Amazon says this account isn't eligible… | Not 10 qualifying sales in 30 days yet, or Amazon is still reviewing eligibility (up to 48 h). | | These credentials look wrong | Typo in ID, secret, or partner tag. Most often a copy-paste that picked up whitespace. | | Amazon is rate-limiting… | One request per second per credential. Wait a few seconds and retry. | | Could not reach Amazon | Transient network issue. Retry in a minute. |