Line-item-customization

A deeper interaction for a single line of line-items.

The line-item-customization action facilitates a deeper interaction with products, particularly where choices reflect significant differences in features or commitments, such as different levels of service in subscription models. This not only improves the customer experience but also helps businesses effectively showcase the range and depth of their offerings.

A user's selection experience can be enhanced with richer descriptions/images as well as a simpler interface. No need to modify quantity, instead just make your choice of a single item.

line-item action and line-item-customization action are made to work together to create a great experience while maintaining the need for detailed invoicing and reconciliation.

Related Actions

This action pairs well with the following actions:

State

The selected option will be made available within the state. This is done redundantly as this will also be available within the unioned line-item action.

Union (required)

A line-item action is required as the target union for this action.

Macro level details for how union attribute behaves can be found within the Union documentation.

Features

NameTypeDescriptionRules
selectionVariantstringselectionVariant will be used to more control on layout on GUI side. Based on the requirement of business you can decide layout of line-item and define information that will be more relevant to defined selectionVariant. For example , with 'card' selectionVariant you will be able to see title and description in card layout form.
Examples: "selection", "media", "card", "card-with-image".
Possible values: selection, media, card, card-with-image, tabbed.
selectionBehaviorstringselectionBehavior will have control on transition effect visibility when customer would select line-item on GUI side.Possible values: hidden, shown.

Context (required)

NameTypeDescriptionRules
namestring(required) A unique id within the context of the unioned line-items actions.
Examples: "sku-12345".
MaxLength: 256
MinLength: 1
recommendednumberThe index of the recommended option so that a user has a choice already made, rather than making a choice to progress.
Examples: 10.
optionsarray(required) The options to present to the customer.

Example

Below is an example payload for adding an Line-item-customization action to a business process or blueprint.

{
    "type": "line-item-customization",
    "union": 1,
    "context": {
        "name": "sku-12345",
        "recommended": 10
    },
    "features": {
        "selectionVariant": "card-with-image"
    }
}