Permissionn for WooCommerce

Description

AI assistants now browse, fill carts and check out for people. Permissionn shows you which agents visit your store, whether they proved who they are, and what they tried: browsing, adding to cart, checking out, signing in.

  • Agent report. Start in watch-only mode: nothing is blocked, and you see what your rules would have done.
  • Store rules. Keep agents out of checkout, block agents that cannot prove who they are, slow down fast agents, or ask the shopper to approve agent purchases over an amount you choose.
  • No slowdown for shoppers. Page views are reported after the page is delivered. Only add to cart, checkout and sign-in wait for a decision, limited to 1.5 seconds.
  • Never takes your store down. If Permissionn cannot be reached, shoppers are let through (you can change this).
  • Every decision is recorded on the order, with a link to its signed receipt.

Works with the classic checkout and the checkout block, and with order storage in custom tables (HPOS).

External services

This plugin connects to Permissionn, a paid service that identifies AI agents and applies your store’s rules to them. It is needed for everything the plugin does; without an API key the plugin sends nothing.

What is sent, and when:

  • Page views (after the page has been delivered): the page URL, request method, the visitor’s IP address, and the user agent, language and agent signature headers (Signature, Signature-Input, Signature-Agent). Never cookies, passwords or form contents.
  • Add to cart, checkout and sign-in (before they complete, to get a decision): the same request details, plus at checkout the order total and currency, and a one-way hash of the billing email (or the customer’s account id when signed in). The billing email itself is sent only if you choose to have Permissionn email shoppers a confirmation link.
  • Test connection on the settings page: your API key, to read back which workspace it belongs to.

The data goes to the Permissionn address you enter in the settings (by default the hosted service at https://permissionn.ai). It is processed under Permissionn’s terms of service (https://permissionn.ai/legal/terms) and privacy policy (https://permissionn.ai/legal/privacy), and kept for the history period set in your Permissionn workspace.

Privacy

The plugin adds no cookies and stores no visitor data in your WordPress database, apart from a note on each checked order with Permissionn’s decision and a link to its receipt. Suggested text for your privacy policy is added to WordPress under Settings › Privacy.

Installation

  1. Upload the plugin and activate it.
  2. Create a workspace at https://permissionn.ai/signup and choose a plan (Permissionn is a paid service; plans start at $399 a month), then copy an API key from Settings, API keys.
  3. Go to WooCommerce Permissionn, enter your Permissionn URL and API key, and click Test connection.
  4. Browse your store, then open the Agent report in Permissionn.

For extra safety, put the key in wp-config.php instead: define( 'PERMISSIONN_API_KEY', 'pn_live_...' );

FAQ

What data is sent to Permissionn?

For each checked request: the URL, method, IP address, and a short list of headers (user agent, language, and agent signature headers). Never cookies or passwords. At checkout, the order total, and a one-way hash of the billing email to recognise returning guests. The email itself is sent only if your Permissionn workspace emails confirmations to shoppers.

Does this slow down my store?

Page views: no, they are reported after the page is sent (on PHP-FPM and LiteSpeed). Add to cart, checkout and sign-in wait for a decision, typically a few tens of milliseconds and never more than 1.5 seconds.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Permissionn for WooCommerce” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.7.1

  • Every request value the plugin reads is sanitized and validated. The request body is read only for signed agent requests that carry a Content-Digest, to check that digest.

1.7.0

  • Shopper permissions: with the E-commerce module on in Permissionn, add to cart and checkout are checked against what the shopper allowed (items or SKUs, categories, amount and store), and an agent’s Permissionn-Mandate header is passed on.
  • Approvals: after the shopper (or the store) approves a held purchase, the retry goes through.
  • A new message for purchases the store confirms itself.
  • Refunds are no longer sent to Permissionn as shopper actions; they are issued by the store owner.
  • Permissionn 3.0 blocks negative amounts. The plugin always sends positive order totals; if you added your own code that sends refunds or credits to Permissionn as negative amounts, send them as a separate action with a positive amount.
  • Confirmations: Permissionn now emails confirmations to the shopper by default (or the store confirms them), so the plugin sends the billing email with checks that need one.

1.6.1

  • The shopper’s email is sent to Permissionn only when your workspace emails confirmations to shoppers.
  • Text domain matches the plugin slug (permissionn-for-woocommerce), for translations on WordPress.org.
  • External services and privacy sections in this readme.

1.6.0

  • Settings page shows whether the store is connected, to which Permissionn workspace, and whether rules are on, with setup steps for new stores and a preview of what shoppers see.
  • Test connection now checks the API key (it used to accept any key).
  • Clearer messages for shoppers: asking to confirm is shown as a notice, not an error, with a Confirm button; the block checkout spells out the confirmation link.

1.5.1

  • Added the full GPL license text.

1.5.0

  • First release.