Configuration Options

There are a number of settings which can be configured within the backoffice on the configuration screen found here:

Settings -> UmbCheckout -> Configuration

Only users with access to the Settings section can see or change it. The screen also shows a Help & Support box and, on the right, the License Details (see Licensing).

The configuration options and their possible options are as below:

Name	Type	Options
Fallback Currency Code	Text	The 3-letter ISO currency code used when neither the product’s currency node nor the site root sets umbCheckoutCurrencyCode (see Currency)
Success Page URL	Picker	Select either a content node or enter an external URL
Cancel Page URL	Picker	Select either a content node or enter an external URL
Enable Shipping	Boolean	True: The shipping rates are passed to the payment provider False: No shipping rates are passed to the payment provider
*Store Basket In a Cookie	Boolean	True: A cookie is set which stores the users current Basket False: No cookie is set
*Basket Expiry (Cookie)	Integer	The number of days in the future the cookie expires (30 by default)
*Store Basket In The Database	Boolean	True: The users current Basket is stored in the database False: The Basket is not stored
*Basket Expiry (Database)	Integer	The maximum number of days the Basket is stored in the database

Note

Features marked with * require a paid license. Without one, they aren’t shown and are always off.

Caution

The screen shows a warning while Umbraco:CMS:WebRouting:UmbracoApplicationUrl isn’t set. Licensing and the success page need it (see Installing a License).

Storing the Basket in the database also turns on storing it in a cookie: the cookie is how a returning visitor’s Basket is found again. A Basket is stored in the database only when Store Basket In The Database is on, and viewing it doesn’t extend its expiry.

Saving shows a success toast. If a Saving notification handler refuses the change, nothing is saved and the toast shows the handler’s message.