Paazl Checkout Widget

Version v1.22.0
Platform Magento 2
Last Updated 26 March 2026

Paazl Checkout Selections Magento 2 | Verzending Analytics & Inzichten

Looking for Magento 2 Paazl checkout integration? View the full Magento 2 Paazl checkout integration page to explore features, configuration options, and pricing.

Checkout Selections

This guide explains the Checkout Selections feature of the Paazl Checkout Widget. This feature captures all shipping options presented to your customers during checkout and sends them to Paazl for analytics. It helps you understand which delivery options are being offered and chosen, so you can optimize your shipping strategy over time.

How It Works

When a customer reaches the checkout and the Paazl widget loads shipping options, those options are automatically saved in your Magento database. A background task then sends this data to Paazl in batches. Once sent, each record is marked as processed and won't be sent again.

The data sent to Paazl includes:

  • All shipping options that were presented to the customer
  • The option the customer actually selected
  • Whether a "green" (eco-friendly) shipping option was available
  • Customer and shipping address details (configurable — see Privacy section)
  • The order reference and API token for linking back to the Paazl order

Configuration

Navigate to Stores > Configuration > Sales > Shipping Methods > Paazl Checkout Widget.

Save Checkout Selections

Found under the Advanced Settings section.

Enables or disables the entire feature. When set to "Yes", checkout shipping options are captured for every quote where the Paazl widget loads. When set to "No", no data is saved or sent.

Checkout Selections Batch Size

Controls how many checkout selections are sent to Paazl per scheduled run. The default is 100. If you have a high-traffic store and notice unsent records building up, you can increase this number.

When to change: Most stores can leave this at the default. Only increase if you process a very large number of orders and want the data to reach Paazl faster.

Exclude Customer Fields from Checkout Selections API

Found under the Privacy (GDPR) section.

This multiselect field lets you choose which customer and address fields should not be sent to Paazl. This is important for GDPR compliance and data minimization.

Available fields you can exclude:

  • Email
  • First Name
  • Last Name
  • Company
  • Street Address
  • City
  • Postal/Zip Code
  • Province/Region
  • Country
  • Phone Number

When to use: If your privacy policy or data processing agreement with Paazl does not cover sharing certain personal data, exclude those fields here. The shipping options and selected option data will still be sent — only the customer/address fields you select are removed.

Tip: Excluding "Province/Region" will also automatically exclude the internal region ID to ensure consistency.

Automatic Sending

When enabled, a scheduled task runs every 5 minutes and performs the following:

  1. Collects all unsent checkout selections (up to the configured batch size).
  2. Sends them to Paazl in a single API call.
  3. If the API responds successfully, marks all sent records as processed.
  4. If the API call fails, the records remain unsent and will be retried on the next run.

No manual intervention is needed — the process is fully automatic once enabled.

What Data Is Captured

For each checkout session where the Paazl widget loads, the following is recorded:

  • Shipping options: All delivery and pickup options that were available for the customer's address and cart.
  • Selected option: The shipping option the customer actually chose (if they completed checkout).
  • Green option: Whether any of the available options was marked as eco-friendly ("GREEN").
  • Customer details: Email, name (subject to exclusion settings above).
  • Shipping address: Full address details (subject to exclusion settings above).
  • Order reference: The Magento order number (with reference prefix if configured).
  • Guest status: Whether the customer checked out as a guest.
  • Timestamp: When the quote was last updated.

Privacy and GDPR

This feature sends customer data to an external Paazl endpoint. To ensure compliance with privacy regulations:

  • Use the Exclude Customer Fields setting to limit which personal data is shared.
  • Review your data processing agreement with Paazl to confirm which fields may be sent.
  • At minimum, consider excluding fields like email and phone number if they are not required for Paazl's analytics.

The shipping options themselves (carrier names, rates, delivery dates) are always sent, as they do not contain personal data.

Troubleshooting

Checkout selections are not being saved

  • Verify that Save Checkout Selections is set to "Yes" in the configuration.
  • Ensure the Paazl widget is loading correctly on the checkout page — if no shipping options are returned by the API, nothing will be saved.
  • Check that Magento cron is running. The send process depends on the scheduled task.

Data is not reaching Paazl

  • Check var/log/paazl.log (with debug mode enabled) for error messages from the send process.
  • Verify your API credentials (API Key and API Secret) are correct — the same credentials used for order syncing are used here.
  • If you see HTTP error codes in the log, contact Paazl support with the details.

Too many unsent records accumulating

  • Increase the Checkout Selections Batch Size in the configuration.
  • Verify that the cron job is executing every 5 minutes as expected.
  • Check the Paazl API is responding successfully — failed sends will cause records to pile up.

Need More Help?

Support:

For a complete overview of features and configuration options, see Magento 2 Paazl checkout integration.

Article Updated:
Download PDF
star star star star star
star star star star star
Alexandru-Manuel Carabus
Magmodules sets the bar for Magento module quality and support—we check their catalog first for client feature requests, and they’re our first choice for licenses.
Google 11 Nov 2025
star star star star star
star star star star star
Matt Austin
Possibly the fastest support response times of any Magento Extension vendor. Great extensions too!
Google 09 Sep 2025
star star star star star
star star star star star
Jan Privé
Dankzij de heldere uitleg en snelle reactie van Magmodules kon mijn vraag, en dus mijn Magento-probleem, binnen enkele uren worden beantwoord. Doeltreffend, zonder moeilijke termen, gewoon zo als het zou moeten zijn.... Bedankt!
Google 05 Sep 2025
star star star star star
star star star star star
Denis Metzler
To evaluate a provider, it is not enough to consider only the product offered, but also its after-sales service, such as support and troubleshooting. Magmodules has been extremely satisfactory at all levels on multiple occasions and sets the bar at the top when comparing the competition.
Google 02 Sep 2025
star star star star star
star star star star star
Bleijenberg winkelinrichting en materialen
Goed bereikbaar, reageren snel en denken oplossingsgericht. Een aanrader.
Google 30 Jul 2025
star star star star star
star star star star star
Patrick Verduijn
Magmodules biedt plugins aan die van hoge kwaliteit zijn tegen een goede prijs, waar dit bedrijf in uitblinkt is de bereidheid om de zeldzame feedback & problemen met de plugins te willen onderzoeken, mee te willen denken in het debuggen van problemen en goede oplossingen toe te passen. In mijn decennium ervaring met Magento & 3th parties is Magmodules absoluut een uniqum binnen de markt.
Google 25 Jul 2025
star star star star star
star star star star star
Erik de Groot
Magemodules heeft hele sterke Magento extensies en een proactieve support. Al jaren heel erg tevreden over jullie service en producten!
Google 18 Jul 2025
star star star star star
star star star star star
René Zeuner
We are using the Mollie Magento extension from Magmodules. It works excellently without flaws. Very fast, competent and friendly support. Thanks!
Google 30 Jun 2025
star star star star star
star star star star star
R. U.
Erg goed team, reageren snel en duidelijk en hebben met toegang tot onze database erg goed geholpen (eigenlijk een gratis customization).
Google 18 Jun 2025
star star star star star
star star star star star
Hugo de Groot
Uitstekende support! Wij gebruiken o.a. de Rich Snippets Suite extensie voor onze Magento 2 webshop (Hyvä) en hadden een specifieke vraag over structured data op PLP-pagina’s. Binnen no-time kregen we een inhoudelijk en duidelijk antwoord. Zeer prettig contact en goed onderbouwde uitleg. Absoluut een betrouwbare partner voor Magento-extensies!
Google 13 Jun 2025