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
On the Settings > Currencies tab, select the +New Currency button.
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
- Select the payment gateway name.
- 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
On the Settings > Integrations tab, select +New Integration.
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
- Select +Invite user.
- 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.
On the Settings > Authentication Realms tab, select the Buyer Organization realm.
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.
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.
On the Settings > Authentication Realms tab, select the Merchant Organization realm.
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.
Click Save to save the configuration.
Adding a new provider
Select a realm on the Settings > Authentication Realms page.
In the dialog box that opens, click Add New Provider.
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. 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.