Skip to end of metadata
Go to start of metadata

What is a store?

The store is the point of sale for your products and services on the Nexway Monetize platform. Your first store was automatically created during the onboarding process which makes for faster and easier setup. You can access this store in Nexway Center (see Getting started) from the Tools & services menu.

You can have several stores for your customer account but we would encourage you to have a single store as this is easier to manage.

The store in Nexway Monetize

The Store feature in Nexway Monetize can be used to define the settings that allow you to sell the right product in the right territory while providing your shoppers with the best user experience possible.

It can be used to control certain actions that happen before, during and after an order is placed and can be configured to meet your business needs. 

You can configure your store to:

  • Provide a localized experience for your shoppers. This includes defining the languages of sale available in the checkout cart. We also use GeoIP technology to automatically display content based on location.
  • Customize your checkout cart to take into account territory restrictions.

  • Customize the look and feel of the Web interfaces (checkout cart, end-user portal) presented to your shoppers so they resemble your Website. This can help you:
    • provide a seamless user experience for shoppers.
    • maintain brand identity in end-user facing communication, and in the checkout cart and end-user portal.
  • Create and customize messages that are displayed in the cart after an order is placed.
  • Implement tracking capabilities on your store by adding a Google Tag Manager (GTM) ID.
  • Specify if user accounts should be created for your shoppers after an order is placed.
  • Customize the payment methods accepted on your store (credit card, e-Wallet, etc.) and their order of appearance.
  • Give your shoppers the option of saving certain payment methods to their user account to prevent them from having to manually enter and re-enter billing and shipping information for future purchases (one-click payment).

The store can be configured in Nexway Center and via API

Store configuration and use cases

Below are a few use cases to assist with configuring your store.

 You want to implement territory restrictions on your store

Via Nexway Center

Two (2) options are available for this:

  • Blocked countries: you can use this option to block sales from certain countries.Blocked countries will not appear in the country selector of the checkout cart and the shoppers from these countries will not be able to complete purchases on your store.


If you want to allow shoppers who live in blocked countries to make purchases on your store, you can define a Fallback Cart Country that will replace their country in the checkout cart. Their billing address will now be from the fallback country and they will be able to complete their purchase.

  • Use GeoIp to force Enduser country: you can use this option to prevent shoppers from changing their country in the checkout cart, with the exception of shoppers from within the European zone. In compliance with EU regulations, shoppers with a European IP should be able to change their country to any of the European Union member states.


To restrict territories of sale via API, use the following properties:

  • "blackListedCountries": to specify the country to be blocked. A shopper whose IP address is in the blocked country will not be able to complete their purchase as they will not be able to provide their billing address to place their order. 
  • "forceGeoipLocalization": set the boolean value to "true"  to prevent shoppers with a specific IP address from changing their country in the checkout cart. 

These properties are found in the Store resource.

 You want to maintain brand identity in Nexway Monetize

In Nexway Monetize you can maintain brand identity with themes and logos.


In Nexway Monetize a theme is a CSS file that defines what the Web pages should look like.

Via Nexway Center

A default Nexway theme is automatically applied to your store for the checkout cart and end-user portal. You can however add your own customized CSS theme to meet your brand identity:

To maintain brand identity with themes do the following:

  • In the Store settings set a theme that corresponds to your company's brand identity in the End-user Portal design and Checkout design sections:
    • From the Design menu in Nexway Center, create a new theme file and copy the content of the default Nexway theme file into it. 
    • Edit the CSS of the new file to meet your requirements and save your changes. 
    • In the Store settings, assign your customized theme file to the End-user portal and checkout. 

There are two (2) methods available for adding images and using them as logos in Nexway monetize. In the Assets section of the Store settings, you can do one of the following: 

  • Upload your images to Nexway Monetize.

    Note: A URL is generated for each uploaded file.
  • Add the URL for images that are hosted on your servers.

You can then assign your images as follows:

    • A logo to be displayed in the checkout cart
    • A logo for the order confirmation email banner
    • A logo for the banner in the invoices generated by Nexway
    • A Favicon to be displayed in the browser of the checkout cart


To implement the above example using APIs do the following:

  • If you want to use a customized theme for your checkout cart and End-user portal, in the Store resources use the "designs": property and enter the name(s) of the CSS file(s) for the corresponding theme values.

For example

  "designs": {
        "checkout": {
            "layout": "default",
            "font": "Josefin Sans",
            "theme": "MyTheme"
        "endUserPortal": {
            "layout": "default",
            "theme": "MyTheme"

      • "logoFavicon": "string": for the browser of the checkout cart
      • "logoStore": "string": for the checkout cart
      • "bannerInvoice": "string": for the invoice banner
      • "bannerOrderConfEmail": "string": for the order confirmation email banner

  • If you want to use URL addresses for images hosted on your servers for logos in Nexway Monetize:
    • Specify your URL addresses as the values for the properties mentioned in step 2 above. 

 You want to specify the languages in which the checkout cart can be displayed

Nexway Monetize currently supports several languages.

The checkout cart's display language is configured to be the same as the language that is set in the shopper's browser. 

When a store is created, you are required to set the following language parameters:

  • Default language: this is the default language of the store. The checkout cart is displayed in this language if the shopper's browser language is not among the sales languages declared for the store.
  • Sales languages: these are all the languages in which the checkout cart can be displayed. These must be selected from the languages supported in Nexway Monetize. Each language is represented by a flag and is available in a drop-down menu that the shopper can use to change the cart's display language.

A list of the languages supported in Nexway Monetize and their corresponding codes for API requests is available here.

Via Nexway Center

To specify your languages in Nexway Center:

  • In the Tools & Services menu, in the Store tab set a default language for the store. This language is implicitly included in the list of sales languages available for the checkout cart so you will not have to add it in that section.  
  • Select the sales languages in which your checkout can be displayed from the languages supported in Nexway Monetize.


To set languages via API use the following properties:

  • "defaultLocale": to set the default language of the store.  
  • "saleLocales": to specify the different languages in which the checkout cart can be displayed. 

Use the ISO language + country codes for these values, e.g fr-FR for France. For more information see the list of supported languages.

 You want to enable one-click payment on your store

The one-click payment feature in Nexway Monetize allows your shoppers to save payment methods used for purchases to their wallet in their user account. They can the re-use these payment methods for successive purchases without having to re-enter their billing and shipping information. You can enable this feature in Nexway Center and via API.

Via Nexway center

If you want your shoppers to be able to save their payment methods to their wallet in the Store settings:

  • Enable the Force End-user creation option. A user account will be generated for your shoppers when they purchase from your store and they will be able to save their payment methods to the wallet in this account.
  • Enable the Promote one-click payment.


To implement the example via during store creation:

  • Set the "createEndUserWithoutSubscription" property to "true" to generate a user account for shoppers.
  • Set the "promoteOneClickPayment" property to "true".

For more information on the one-click payment feature, see One-click payment in Nexway Monetize.

 You want to customize the payment methods available to shoppers and their order of appearance in the checkout cart

In Nexway Monetize the payment methods available in shopping carts are defined by default according to geographic location. Other factors may later influence these methods:

  • The end-user changing their country of residence in the cart
  • The type of product being purchased (subscription products have less payment methods available than stand-alone transactions)
  • Your customized settings, for example, if you restrict certain payment methods from your store

To customize the payment methods available in a cart you can restrict the type of payment methods that are available by blocking the ones that are unwanted.


  • If you would like to block certain payment methods from your cart, this can be done via API with the "blackListedPaymentMethodsproperty during store creation. See Payment methods for more information.

Customizing your payment methods to present the ones that are mostly used in a country first can be very beneficial to your company as shoppers are more likely to complete their purchase thus increasing your conversion rate.

Payment methods are presented in tabs in the checkout cart. By default, credit/debit cards are presented first as these payment methods are used worldwide. You can customize the order in which payment methods appear in the checkout cart as well as create groups of payment methods where payment methods are presented in a particular order for one or several countries.

For example, you want to present your payment methods in the following order:

  • Default: credit/debit card, Sepa, cheque
  • Germany, Austria, United Kingdom: PayPal, Sepa, cheque, credit/debit card
  • France, Italy Switzerland: cheque

Via Nexway Center

In the Payment tabs ranking section:

  • Select the payment methods that you want to customize for the Defaults setting from the list provided.

    Note: The order in which payment method tabs appear in the checkout cart is determined by the position of the corresponding payment method in this setting. Set the payment method you want displayed first in the first position in the field. You can drag payment methods to the desired position if you are not satisfied with their position in the field. 
  • Create a group and add the countries that belong to this group, then select the payment orders to be customized. Only add the methods whose position you want to adjust.
  • Create as many groups as required with their country/countries and the payment orders to be positioned. 
  • Save your settings.


To implement the above example via API use the "rankedPaymentTabsByCountriesList" property during store creation.

"paymentComponent": {
	"rankedPaymentTabsByCountriesList": [
			"rankedPaymentTabs": [
			"countries": [
			"rankedPaymentTabs": [
			"countries": [
			"rankedPaymentTabs": [

 You want to display a customized message when an order is successful

Nexway Monetize provides localized message files for each of the languages available by default for your store. The files include, error messages, order confirmation messages, messages to remind shoppers of products in the checkout cart that have not yet been ordered, etc. The files are available for viewing in the Design menu of Nexway Center on the Translations tab.

You can create or customize your own order confirmation messages to be displayed on the "Thank You" page of the checkout cart when an order has been placed. This message will override the default order confirmation message that is in the corresponding language file.

Via Nexway Center

To set your own customized message:

  • In the Store settings enable the Display product delivery on checkout confirmation option.
  • In the Localized content section enter a generic delivery message that will appear on the "Thank You" page of the checkout cart whenever a purchase is made. You can enter your message in the other available languages if required.  


If you want to customize product-specific order confirmation messages, this is done on the product level (see Product). 


To implement the example via API use the following during store creation:

  • "allowOrderDetailsOnCheckoutConfirmation": set the value to "true" to activate the feature that allows you to display a customized message on the "Thank You" page of the checkout cart.  
  • "thankYouDesc": use this option to provide a generic message. For example, "thankYouDesc": { "en-US": "<p> Thanks for your purchase. To activate your product, call the toll-free number below</p>\..." }.

  • No labels