Picture of Checkout Requirements | BG_064

Checkout Requirements | BG_064

Here, we'll take a look at configuring Checkout Requirements. This group of settings allows you to apply various configurations of rules which will prevent end users from proceeding to checkout under various scenarios. If any of the rules are not met when a user tries to check out, they will not be able to do so. We'll look at an example of one simple configuration, where checkout can only occur if the basket quantity is between set values.

Tutorial Video Transcript

A transcript of our tutorial video, ensuring you can find exactly what you need, when you need it.

You can search this page to find the relevant time-stamp in the video. Also, this text can be used as part of the tutorial search feature.

00:00:07:20 - 00:00:10:20
Here, we'll take a look at configuring
check out requirements.

00:00:10:21 - 00:00:14:14
This group of settings allows you to apply
various configurations of rules,

00:00:14:19 - 00:00:17:05
which will prevent your end users
from proceeding.

00:00:17:05 - 00:00:20:05
To check out on the various scenarios.

00:00:20:12 - 00:00:23:22
If any of the rules are not met
when a user tries to check out,

00:00:23:22 - 00:00:26:22
they will not be able to do so.

00:00:27:24 - 00:00:29:03
We'll start off by navigating

00:00:29:03 - 00:00:32:03
to our checkout settings.

00:00:32:22 - 00:00:35:01
And then within here
there's a Checkout requirements

00:00:35:01 - 00:00:38:01
section that we can go in and configure.

00:00:40:28 - 00:00:42:23
Now the Checkout requirements screen

00:00:42:23 - 00:00:45:24
is split into numerous different sections.

00:00:47:09 - 00:00:50:23
And in these you can create rules
for a number of different scenarios.

00:00:51:06 - 00:00:54:06
Each of these sections has a title.

00:00:54:10 - 00:00:58:22
It has a brief description
of its functionality, and it has an Add

00:00:58:22 - 00:01:02:17
New Item button where you can create one
or more rules within that section.

00:01:04:07 - 00:01:05:27
So available sections consist

00:01:05:27 - 00:01:08:27
of shipping fees, product tags,

00:01:10:01 - 00:01:11:28
product groups,

00:01:11:28 - 00:01:14:06
order, subtotal,

00:01:14:06 - 00:01:16:26
order quantity.

00:01:16:26 - 00:01:19:00
orderline total

00:01:19:00 - 00:01:21:01
orderline quantity.

00:01:21:01 - 00:01:24:01
Checkout attribute and category.

00:01:30:12 - 00:01:31:11
So as an example

00:01:31:11 - 00:01:34:11
we're going to focus on order quantity.

00:01:34:27 - 00:01:39:09
We'll create a basic rule and see this
in action on the front end basket screen.

00:01:40:06 - 00:01:42:17
So we're going to go ahead
and find that section and click

00:01:42:17 - 00:01:45:17
Add New Item.

00:01:49:23 - 00:01:50:24
Now the requirements

00:01:50:24 - 00:01:53:24
will be slightly different
depending on the section you choose.

00:01:53:24 - 00:01:56:09
But we do need to enter
this required information.

00:01:56:09 - 00:01:59:15
In this case
it's just a threshold above and below.

00:02:00:13 - 00:02:03:13
So looking at the description
it will check the order quantity across

00:02:03:13 - 00:02:04:12
all order lines.

00:02:04:12 - 00:02:07:12
If the value is above or below
the threshold.

00:02:07:29 - 00:02:10:00
So basically I could say something like

00:02:11:07 - 00:02:14:17
I'm going to disallow or allow checkout

00:02:15:27 - 00:02:18:27
if threshold is.

00:02:21:01 - 00:02:23:29
Above zero.

00:02:23:29 - 00:02:25:22
Below

00:02:25:22 - 00:02:27:16
ten for example.

00:02:27:16 - 00:02:29:25
So now checkout will be disallowed

00:02:29:25 - 00:02:32:25
if we are between those values.

00:02:38:28 - 00:02:41:06
Then go ahead and click on save.

00:02:41:06 - 00:02:43:15
Your new rule will then be created.

00:02:43:15 - 00:02:47:18
Multiple rules can be created
if required, both in the same section.

00:02:48:17 - 00:02:52:02
So order quantity
in this case or within different sections.

00:02:56:29 - 00:02:58:17
I'm going to navigate
to the top of the screen

00:02:58:17 - 00:03:02:08
and just make sure you click save
to confirm those new rules you've created.

00:03:03:28 - 00:03:07:09
Now before we leave this page,
one last thing to note

00:03:07:09 - 00:03:10:09
is this section here,
which is a debug mode.

00:03:10:11 - 00:03:13:22
So we've implemented a debug mode
for the checkout requirements.

00:03:14:01 - 00:03:17:10
This allows you to use your browser's
console to review

00:03:17:10 - 00:03:20:14
how any applied rules
are being enacted on the basket.

00:03:20:27 - 00:03:22:20
And we'll see this in action later.

00:03:22:20 - 00:03:25:08
And this is a great way to test
whether you've

00:03:25:08 - 00:03:28:08
input all your rules
as you're expected to do so.

00:03:28:11 - 00:03:30:03
So I'm going to
make sure debug mode is on.

00:03:31:06 - 00:03:34:06
And then make sure you save it.

00:03:36:29 - 00:03:37:26
I'm now going to navigate

00:03:37:26 - 00:03:40:26
to my front end of my storefront.

00:03:43:16 - 00:03:44:13
So I'm just going to go ahead

00:03:44:13 - 00:03:47:13
and add an item to my basket.

00:03:50:05 - 00:03:53:01
And you can see that
that rule has already come into play.

00:03:53:01 - 00:03:57:25
So because I only have a quantity of one,
it's come up with an error message there

00:03:57:25 - 00:03:59:12
saying that check out is restricted

00:03:59:12 - 00:04:02:26
if the total order quantity
is in the range 0 to 10.

00:04:03:16 - 00:04:04:28
So I'm not allowed to check out.

00:04:04:28 - 00:04:08:03
Now if I click on the check out button
it will return me to basket.

00:04:09:04 - 00:04:11:26
So we can use debugging mode
if it's enabled to check

00:04:11:26 - 00:04:14:26
which of our rules are being triggered.

00:04:15:26 - 00:04:19:09
Now, please note these functions
may differ slightly between browsers.

00:04:19:10 - 00:04:22:10
I'm using Google Chrome
during the creation of this guide.

00:04:23:08 - 00:04:27:26
So if we right click anywhere
on our browser and go for inspect page

00:04:29:16 - 00:04:32:16
and go over to our console

00:04:32:19 - 00:04:35:19
and for Google Chrome, that is just a tab
at the top of the screen.

00:04:36:24 - 00:04:39:16
Within this console,
you'll see written records detailing

00:04:39:16 - 00:04:42:23
if any specified rule
is preventing checkout,

00:04:42:23 - 00:04:46:00
along with any details
of the requirements of these rules.

00:04:46:18 - 00:04:50:07
So for example, we can see here
that we can't pass checkout because.

00:04:50:27 - 00:04:52:05
And then the rule details.

 

Incomplete
Step by Step Guide

Checkout Requirements | BG_064

Here, we'll take a look at configuring Checkout Requirements. This group of settings allows you to apply various configurations of rules which will prevent end users from proceeding to checkout under various scenarios. If any of the rules are not met when a user tries to check out, they will not be able to do so.

We'll look at an example of one simple configuration, where checkout can only occur if the basket quantity is between set values.

Creation Date: Jul 01, 2024
Created By: Sam Webster

1. Navigate to Checkout Settings

Navigate to Checkout Settings

2. Click on Configure under the Checkout Requirements section

Click on Configure under the Checkout Requirements section

3. Checkout Requirements screen

The checkout requirements screen is split into numerous sections where you can create rules for a number of different scenarios. Each section has a title, a description of its functionality and an "Add" button where you can create one or more rules within that section.

Available sections and their use cases consist of:

  • Shipping Fee | It will check the order shipping costs (without tax) if the value is above/below the threshold.

  • Product tag | It will check each line item if the line item has the product tag. The product tag can be found by id or name

  • Product Group | It will check each line item if it is part of the group. The product group can be found by id or name

  • Order Subtotal | It will check the order subtotal if the value is above/below the threshold. There are multiple scope to create a rule here: Customer, Department, Customer Role.

    • Customer Scope: This can be configured either globally or per customer rule. If a customer-specific rule is defined, it will override the global rule. Customers can be identified by id, username, or email/full name.

    • Customer Role Scope: can be found by id or name

    • Department Scope: can be found by id or name

  • Order Quantity | It will check the order quantity across all order lines if the value is above/below the threshold

  • Orderline Total | It will check the order line total (excl tax) value if is above/below the threshold.

  • Orderline Quantity | It will check each mapped order line quantity value individually if is above/below the threshold. It can be configured as global or per order line product rule. The defined order line product rule will override the global rule. The product can be found by name.

  • Checkout Attribute | It will check the value of the checkout attribute and if the regular expression matches. The checkout attribute can be found by id or name

  • Category | It will check each line item if it is in the category. The category can be found by id or name

Checkout Requirements screen

4. As an example, we will focus on Order Quantity

We'll create a basic rule and see this in action on our front-end basket screen

As an example, we will focus on Order Quantity

5. Click on Add new item

Click on Add new item

6. Enter the required information (in this case an upper and lower threshold) and specify whether this should disallow checkout using the available checkbox

Enter the required information (in this case an upper and lower threshold) and specify whether this should disallow checkout using the available checkbox

7. Click on Save

Click on Save

8. Your new rule will be created

Multiple rules can be created if required, both in the same section (so Order quantity in this case) or within different sections.

Your new rule will be created

9. Remember to navigate to the top of the page and click on Save

Remember to navigate to the top of the page and click on Save

10. It's a good idea to test your rules

We've implemented a debug mode for the Checkout Requirements. This allows you to use your browsers Console to review how any applied rules are being enacted. We'll see this in action later.

It's a good idea to test your rules

11. Navigate to your Storefront's front end

Add item(s) to your basket (cart) and navigate to the basket screen

Navigate to your Storefront's front end

12. If your Checkout Requirements have not been met, a message will be displayed customised to your rule

Whilst the Checkout button is still available, clicking on it will simply return you to the basket screen.

If your Checkout Requirements have not been met, a message will be displayed customised to your rule

13. Use Debugging (if enabled) to check which of your rules are being trigger

Please note: These functions may differ slightly between browsers. I am using Google Chrome during the creation of this guide.

Right click anywhere on your browser and inspect the page.

Navigate to the console

Within the console, you will see written records detailing if any specified rule is preventing checkout, along with details of the requirements of those rules.

Use Debugging (if enabled) to check which of your rules are being trigger