Settings

You can manage site settings including currencies, payment gateways, integrations, and team management on the Settings page.

Currencies

You can view your store’s currencies on the Settings > Currencies tab.

Sorting and filtering currencies

You can sort this list by Code or Status.

You can filter the list to show which currencies are Enabled or Disabled.

Creating a new currency

1. On the Settings > Currencies tab, select the +New Currency button.

2. Enter the following information:

   Attribute name	Attribute value
   Code	A three-letter currency code. For example: JPY for the Japanese Yen. It is recommended that you use the ISO 4217 currency code standard. See https://www.iso.org/iso-4217-currency-codes.html or https://en.wikipedia.org/wiki/ISO_4217.
   Exchange Rate	The exchange rate from the default currency.
   Format	Specify how the price currency is displayed. For example, ¥{price} is the format of the Japanese Yen when displayed in text.
   Decimal point	The decimal point character. For example, ..
   Thousands separator	The thousand separator character. For example, ,.
   Decimal places	How many decimal places the currency is formatted to. For example, the US dollar is formatted to two (2) decimal places.
   Default	If this is the default currency, check the box.
   Enabled	If this currency is available in your store, check the box.

Payment Gateways

You can view your store’s payment gateways on the Settings > Payment Gateways tab.

For an overview of how payments work in Elastic Path Commerce Cloud, see Payments.

Sorting and filtering payment gateways

You can sort the payment gateway list by Name or Status.

You can filter the payment gateway list to show which gateways are Enabled or Disabled.

Modifying a payment gateway

1. Select the payment gateway name.
2. Enter the details for the payment gateway.

note

Each payment gateway can require different information, and the field names can be specific to that gateway only.

Contact your payment provider for details.

Integrations

You can view your store’s integrations on the Settings > Integrations tab.

For an overview of how integrations work in Elastic Path Commerce Cloud, see Events and webhooks.

Sorting and filtering integrations

You can sort the integrations list by Name, Description, or Status.

You can filter the integrations list to show which integrations are enabled or disabled.

Creating a new integration

1. On the Settings > Integrations tab, select +New Integration.

2. On the Create New Integration page, enter the following information:

   Section	Fields
   Integration details	Name and Description. The Integration type is fixed at webhook.
   Configuration	URL for the integration, and Secret key. The secret key is forwarded along with the request as a header.
   Observes	These events can trigger webhooks. Select the ones you want to trigger the webhook: Created, Updated, or Deleted for most objects; Updated or Deleted for Cart; Created or Deleted for File; Created, Updated, Fulfilled, Authorized, Paid/Captured, or Refunded for Order; Updated for Payment Gateway. Created, Updated, or Deleted for customers. Only five events can be added.
   Enabled	Enable the integration.

Team Management

You can manage team members from the Team Management tab.

Sorting team members

You can sort the team member list by Name, Email, or Role.

Adding team members

1. Select +Invite user.
2. In the dialog box that opens, enter a name, email address, and choose a role.

For more information, see Inviting Team Members.

Deleting team members

You can delete team members from the Settings > Team Management page. This action cannot be undone.

You can re-add deleted users. They receive a new client_id and client_secret.

Authentication Management

The Authentication Management tab is used to configure one or more single sign-on authentication providers. Single sign-on is used to verify a user’s identity using the OpenID Connect protocol, without saving user information such as a password.

warning

Changing these settings affects how customers authenticate with your store. Any misconfiguration might prevent users from authenticating.

For more information, see Single sign-on and authentication and Single sign-on with OpenID Connect.

important

To set up single sign-on for customers of your store, use the Buyer Organization realm. To set up single sign-on for store administrators and developers, use the Merchant Organization realm.

Buyer Organization: Adding redirect URLs

When the storefront begins the single sign-on flow for an end user or customer, it must tell Elastic Path Commerce Cloud which URI the user should be redirected to when the authentication completes. This is the redirect_uri parameter discussed in Single sign-on with OpenID Connect. These URLs must be explicitly listed as Redirect URIs to prevent phishing and other security vulnerabilities.

1. On the Settings > Authentication Realms tab, select the Buyer Organization realm.

2. In the Edit Configuration area for the realm, enter redirect URIs.

   You can view the list of redirect URIs as tags or as a comma-separated list.

3. Click Save to save the configuration.

Merchant Organization: URL prefix

To log into the correct store’s Dashboard as a developer or administrator when using single sign-on, you must set a URL prefix for your store’s Merchant Organization realm.

note

This prefix must be unique, and comprised of between two and 24 alphanumeric characters.

1. On the Settings > Authentication Realms tab, select the Merchant Organization realm.

2. In the Edit Configuration area for the realm, enter your URL prefix.

   You enter the URL prefix every time you log in to the Dashboard.

3. Click Save to save the configuration.

Adding a new provider

1. Select a realm on the Settings > Authentication Realms page.

2. In the dialog box that opens, click Add New Provider.

3. Enter the following information:

   Field	Information
   Name	The name of the configuration.
   Discovery Url	The URL where the OpenID Connect authentication configuration is found. This is often at the URL of the provider. For example: https://<URL>/.well-known/openid-configuration
   Client Id	The client identifier that Commerce Cloud uses to identify itself with the authentication provider.
   Client Secret	A secret code known only to Commerce Cloud and the authentication provider.

4. In the Redirect URL for Provider dialog box that opens, click Copy to copy the Redirect URL for Provider URL.

   This redirect URL must be configured in your single sign-on authentication provider setup.

   You can also copy the Redirect URL for Provider field after you have saved the configuration for a new provider. Use the Copy button to copy the URL.

After you have properly configured one or more authentication providers, when customers open the Login dialog box, a Login with [provider] button is available for single sign-on authentication workflow.