Troubleshooting

"Could not connect to Envato. Please try again later."

The module failed to reach the Envato API. Check:

1. Personal token — go to Admin → Envato Integration and verify the token is saved. Re-enter it if unsure.
2. Token permissions — the token must have the "View your items' sales history" scope. Check on build.envato.com.
3. Server outbound access — confirm your server can make HTTPS requests to api.envato.com.

"The purchase code could not be verified."

The Envato API did not find a sale for this code. Most common causes:

• The code was copied incorrectly (must be a UUID like xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
• The purchase was on a different Envato account than the one linked to your personal token.
• The token belongs to an author but the item was purchased from a different author — the /v3/market/author/sale endpoint only sees sales on the token holder's items.

"This purchase has already been claimed."

Each purchase code can only be used once. If the buyer accidentally used another store's claim page or entered the wrong code, contact support to revoke and re-issue the license manually via Admin → Licenses.

"The purchased item is not configured in this store."

The Envato item ID returned by the sale (shown in the error message) does not have an enabled mapping. Go to Admin → Envato Items and add or enable a mapping for that item ID.

OAuth login: "We could not retrieve your email address from Envato."

The Envato OAuth app is missing required permissions. Open your app at build.envato.com/my-apps and make sure all of these are enabled:

• View and search Envato sites
• View the user's Envato Account username
• View the user's email address
• View the user's account profile details
• List purchases the user has made

See Setup → Step 3 for the full setup guide.

Auto-claim issued 0 licenses after OAuth login

• The List purchases the user has made permission is not enabled on your Envato app — without it the module cannot retrieve the customer's purchase history.
• The customer's Envato account has no purchases that match an enabled item mapping.
• The Auto-claim all eligible purchases after OAuth login toggle is disabled in settings.
• The OAuth token was not available — this can happen if the customer was already logged in when they authorised Envato (the token is only stored during the OAuth callback flow).