Pricing Scripts for Checkout Attributes

This article explains how to configure pricing scripts that apply directly to checkout attributes, allowing storefront managers to control pricing dynamically at the checkout stage.
You’ll learn what’s included in this enhancement, how it works, and how to set it up.

About this feature

Previously, pricing scripts could only be attached to products.
With this enhancement, scripts can now be assigned to checkout attributes, such as delivery options, service levels, or gift-wrapping choices - so that selecting an option during checkout can automatically update the basket total.

This gives greater flexibility in how pricing is handled across the entire checkout process, especially for storefronts that require surcharges, discounts, or conditional fees unrelated to individual products.

What’s included

• Ability to assign pricing scripts to checkout attributes

• Live recalculation of basket totals when attribute values change

• Optional debug/output display via info-type attributes

• Support for applying both fixed and percentage-based adjustments

Key settings

• Target Scope: determines where the script will run. Select Checkout Attributes to trigger pricing logic when a checkout field changes.

• Pricing Script: links your script to a specific attribute. Found under Admin → Checkout Attributes → Edit.

• Debug Mode: optional setting that outputs live script results in-basket for testing and verification.

Use cases

• Add a surcharge for “Express Delivery” or “Same-Day Dispatch.”

• Offer a “Gift Wrap” service for an additional fee.

• Apply a discount when a customer selects “Eco Packaging” or “Digital Delivery.”

• Introduce donation or tip fields that modify the basket total automatically.

Step-by-step implementation

Step 1 – Create or edit a pricing script

1. Go to Admin → Pricing Scripts.

2. Click Add new or edit an existing script.

3. Write your pricing logic as required.

4. Set Target Scope to Checkout Attributes.

5. Save the script.

Step 2 – Assign the script to a checkout attribute

1. Navigate to Admin → Checkout Attributes.

2. Select an existing attribute or create a new one.

3. In the Pricing Script field, choose your newly created script.

4. Save the attribute.

Step 3 – Test your configuration

1. Add any product to your basket and proceed to checkout.

2. Change the linked checkout attribute (e.g., tick Gift Wrap).

3. Confirm that basket totals update immediately.

4. (Optional) Enable debug mode to view live calculation results.