PrestaShop uses a static Webservice Key (HTTP Basic Auth). There is no OAuth flow — you generate the key directly in your PrestaShop back-office and enter it once in Sugibana. A single credential row covers the entire store.
In your PrestaShop back-office, go to Advanced Parameters → Webservice. Enable the webservice if it is not already active.
Create a new webservice key. Grant it full access to: orders, order_details, addresses, products, stock_availables. Copy the generated key — it is shown only once.
Note your store URL (e.g. https://myshop.com). The URL must be HTTPS. HTTP stores are rejected at the connect step.
The webservice key is a static credential with no expiry. Treat it like a password. Never share it in logs, emails, or public repositories. Sugibana encrypts it immediately on save and never returns it in plaintext.
On the Sales Channels page, click Connect PrestaShop. Enter your Store URL and Webservice Key.
Click Save. Sugibana validates the key against /api?output_format=JSON and confirms the required resources are accessible. A green Connected badge confirms success.
Enable the Order sync toggle. Orders will begin importing in the next 5-minute polling cycle.
PrestaShop SKU matching uses the product reference field, which must equal the Sugibana SKU code exactly (case-sensitive). Ensure your PrestaShop products have the reference field populated before enabling stock push.
Orders are polled every 5 minutes via the /api/orders endpoint using a date window filter. Shipping addresses are resolved via a separate /api/addresses/{id} call per order.
PrestaShop status mapping: states 2–3 (Payment accepted / Processing) → Unshipped; states 4–5 (Shipped / Delivered) → Shipped; states 6–7 (Cancelled / Refunded) → Cancelled; state 1 (Awaiting cheque) → Pending.
PrestaShop currency values use the store's internal id_currency integer. Sugibana resolves this to an ISO 4217 code via /api/currencies. Ensure your store's currencies are configured correctly.
Stock push uses the PrestaShop /api/stock_availables/{id} XML endpoint. The ps_product_mapping table must have a row mapping each Sugibana SKU to its PrestaShop ps_product_id and ps_stock_available_id.
Enable the Stock push toggle on the PrestaShop card only after verifying the product mapping is complete. Run the SKU Alignment Wizard to create missing mappings from your existing PrestaShop catalog.
PrestaShop stock updates use an XML PUT body — JSON is silently rejected. The push adapter handles this automatically; no manual action is needed.