# PrestaShop settings & tracking

# PrestaShop settings & tracking

The reference for everything beyond the [basic setup](/guides/platforms/prestashop/): requirements, brand fields, how order tracking keeps itself reliable, and what to do when something looks off.

## Requirements

- **PrestaShop 8.1+** with **PHP 8.1+**.
- The module ships everything it needs inside the zip. There's nothing to install on a command line.
**Using a subdomain?:** If your store runs on a subdomain (like `shop.your-store.com`) that's different from the domain you registered, open **Allowed Domains** in the dashboard and add it before installing. Otherwise tracking won't connect.

## Brand fields

The **Website Information** panel sets what customers see in the Frak window:

- **Shop Name**: defaults to your PrestaShop shop name. Used as the title.
- **Logo**: paste a public **Logo URL**, or use **Or upload a file** (JPG, PNG, GIF, or SVG up to 2 MB). The preview on the right updates as you type.

The rest of the wording and translations are managed from the [business dashboard](https://business.frak.id/). Click **Save Settings** when done.
**Tip:** If your logo doesn't load in the Frak window, upload the file instead of linking to it. Uploaded logos avoid third-party caching and CORS issues.

## How order tracking stays reliable

When an order's status changes, the module tells Frak so rewards go out on real sales. If a message can't get through, it's saved and retried automatically (up to 5 times, spaced further apart each time). To make sure those retries actually run, set up one of the two options below.

Install the official **ps_cronjobs** module from the Module Manager. Frak registers itself automatically, and the **Retry Cron** line on the settings page turns green. Nothing else to do.

The **Retry Cron** line shows a ready-made URL. Add it to a cron that runs every 5 minutes, for example with `crontab -e`:

```cron
*/5 * * * * curl -fs 'https://your-shop.example/index.php?fc=module&module=frakintegration&controller=cron&token=<paste-from-settings>'
```

The URL includes a private token from your settings page, so keep it to yourself.

You can also run a retry on demand: open **Maintenance → Webhook queue** and click **Drain queue now**.

## Keep an eye on the queue

The **Maintenance → Webhook queue** panel shows the health of order tracking at a glance:

- **Pending**: waiting for the next attempt.
- **Delivered**: sent successfully.
- **Parked (failed)**: gave up after retrying. A red badge appears if this isn't zero.
- **Last error**: the most recent problem, with a timestamp.

### Which order statuses count

Orders that reach **Awaiting payment validation**, **Payment accepted**, **Delivered**, or **Awaiting payment (out of stock)** are tracked as confirmed sales. **Cancelled** and **Payment error** mark the sale as cancelled, and any refund (including partial refunds and returns) marks it as refunded. **Preparation in progress** and **Shipping** are ignored on purpose, so they don't clutter your results.

## Troubleshooting

- **Merchant says "Not resolved for this domain".** Confirm your store's domain is registered on the [dashboard](https://business.frak.id/), then open **Maintenance** and click **Refresh Merchant**. (Your main domain works automatically; only subdomains need adding.)
- **Deliveries failing right after setup.** Re-copy the key from **Purchase Tracker → PrestaShop** in the dashboard, paste it back into **Webhook Secret**, and click **Save Settings**.
- **Parked count keeps growing.** Open **Advanced Parameters → Logs** and filter on `FrakIntegration`. The **Last error** line on the queue panel usually points straight at the cause.
- **Buttons missing on the storefront.** Confirm the placement is enabled in [Component Placements](/guides/platforms/prestashop/components/) and clear your cache (**Advanced Parameters → Performance → Clear cache**).

## For developers

The Frak PrestaShop module is open source, inside the [Frak wallet monorepo](https://github.com/frak-id/wallet) under `plugins/prestashop`. Open an issue or a pull request any time.

[Purchase webhook reference](/developers/api/webhook/)