Articles on: PrestaShop

How can I create an account if my PrestaShop domain is invalid?

When registering your PrestaShop store on syncX: Stock Sync, receiving an "invalid domain" error typically indicates an issue with your PrestaShop Webservice API key rather than your actual store URL. Resolving the API key formatting allows the registration process to authenticate and complete successfully.

How to Fix the "Invalid Domain" Error

Go to PrestaShop Admin → Advanced Parameters → Webservice

Access Webservice Keys: Open your PrestaShop admin panel and navigate to Configuration → Advanced Parameters → Webservice.
Review Existing Key: Inspect the API key currently in use to verify its length and character format.
Generate a Compliant Key: Click Add new webservice key, then click Generate to create a standard 32-character key without hyphens.
Assign Permissions: Ensure full permissions (View, Modify, Add, Delete) are checked for combinations, images, products, and stock_availables.
Retry Registration: Return to the Stock Sync PrestaShop Registration Page, enter your store domain along with the new key, and submit the sign-up form.

PrestaShop's native generator automatically creates compliant 32-character keys; avoid using external key generators that produce UUIDs.

Key Format Verification & Detailed Breakdown

1. API Key Format Requirements

Stock Sync validates your PrestaShop connection during registration by testing the Webservice API key. The key must adhere strictly to PrestaShop's standard alphanumeric format:

Format Check	Compliant Example	Rejected / Non-Compliant Example	Reason for Rejection
Character Length	32 characters (`1234567890ABCDEF1234567890ABCDEF`)	Less than or greater than 32 characters	Fails length validation check
Hyphens / Dashes	No hyphens or special symbols	UUID format (`12345678-ABCD-1234-ABCD-1234567890AB`)	Hyphens trigger the "invalid domain" error
Character Set	Standard alphanumeric (letters and numbers only)	Contains spaces, symbols, or punctuation	Rejected by Webservice parser

A key formatted as a UUID (containing dashes) will be rejected by the validation parser and surface as an "invalid domain" error.

Always click PrestaShop's built-in Generate button to ensure the key contains exactly 32 alphanumeric characters without dashes.

Key Rules & Technical Details

Misleading Error Context: Although the error message states "invalid domain", the root failure is an invalid or unparseable Webservice API key string.
Permission Requirements: Even if the key is 32 characters without hyphens, registration will fail if permissions for combinations, images, products, and stock_availables are not fully granted.
Webservice Activation: PrestaShop's webservice engine must be toggled to Yes under Configuration → Advanced Parameters → Webservice.

Critical rule: Ensure the Webservice API key contains no spaces, dashes, or special characters before submitting the registration form.

Troubleshooting Steps

Issue: The sign-up form continues showing "invalid domain" despite generating a new key → Solution: Copy the Webservice key into a plain text editor to confirm there are no leading or trailing whitespace characters, and verify it contains no hyphens.
Issue: Error persists after verifying key format and length → Solution: Share your Webservice key and store URL with Stock Sync Support so the technical team can test the API handshake directly.
Issue: PrestaShop admin displays an authentication error when accessing webservice URLs → Solution: Confirm that your web server passes the Authorization: Basic HTTP header to PHP, particularly if using CGI mode or FastCGI/PHP-FPM.

Good Articles to Continue

How to Connect syncX: Stock Sync to PrestaShop → Full walkthrough on generating API keys, assigning permissions, and connecting your store.

Updated on: 03/11/2026

Was this article helpful?

Thank you!