PrestaShop settings & tracking

The reference for everything beyond the basic setup: 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. 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.

ps_cronjobs (recommended)

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.

Server cron

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

*/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, 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 and clear your cache (Advanced Parameters → Performance → Clear cache).

For developers

The Frak PrestaShop module is open source, inside the Frak wallet monorepo under plugins/prestashop. Open an issue or a pull request any time.

Purchase webhook referenceHow Frak receives and verifies order updates, for custom integrations.