Skip to content

Settings

The Settings page is where you set up the parts of the shop that only an administrator should touch: whether the public website is open or hidden, your company details for invoices, how emails are sent, and how customers pay.

Think of it as the shop's control room. Most of these you set once and rarely change again.

Changes apply immediately

There is no separate "publish" step. The moment you save a field, the change is live. Each card saves on its own, so you can fill things in any order.


How to open it

  1. Sign in to the admin (KCMS).
  2. In the menu, go to Settings.

You will see six cards stacked down the page, in this order:

  1. Launch (the Site setting)
  2. Company & invoice details
  3. Outbound email (Resend)
  4. Card payments & invoice links (Stripe)
  5. Card payments (Nets Easy)
  6. Checkout

Each card is explained below.


Launch

What it's for. This controls what the public sees when they visit rmsnordic.se. There are two states:

  • Under construction - visitors see a branded "coming soon" splash page. The real shop is hidden.
  • Live - the real shop is open to everyone.

You can always preview

Administrators, and anyone who has visited rmsnordic.se?preview=1, always see the real site even while it says "Under construction". So you can check everything looks right before you open the doors to the public.

How to set it

  1. Look at the coloured badge. Amber "Under construction" means hidden; green "Live" means open.
  2. To open the shop, click Launch site. You will be asked to confirm ("Launch the storefront to the public right now?"). Click OK.
  3. To hide the shop again, click Back to under construction.

Only one button is clickable at a time - the one that changes the current state. After a change you'll see "Saved."

The public website checks this setting every 30 seconds, so a change takes effect almost straight away.

Setting What it does
Launch mode Switches the public site between Under construction (hidden splash) and Live (open shop).

Company & invoice details

What it's for. These are your business's details. They appear in every invoice header, on payment instructions, and in customer emails. Fill them in so invoices look correct and customers know who they are paying.

How to set it

Each row has its own Save button. Type into a field and click the Save next to it. The button shows "Saved ✓" when it worked. Fill them in any order; you don't have to complete them all at once.

Field What it's for
Company name Your business name. Appears in the invoice header and email subject.
Organization number Your company registration number.
VAT number Your VAT registration number, e.g. SE556677889901.
Address Street address (first line).
Address line 2 Optional second address line.
Postal code Postcode.
City Town or city.
Country Country.
Email Your business contact email (shown to customers).
Phone Your business phone number.
Website Your website address.
IBAN International bank account number, used for payment instructions on invoices.
BIC Your bank's BIC/SWIFT code, paired with the IBAN.
Bankgiro Swedish Bankgiro number, used for invoice payments.
Plusgiro Swedish Plusgiro number, used for invoice payments.
Payment terms (days) The default number of days a customer has to pay an invoice.
Invoice footer text A free-text note printed at the bottom of every invoice.

Tip

Bankgiro, Plusgiro and IBAN/BIC are how customers pay an invoice by bank transfer, so make sure at least one of them is filled in and correct.


Outbound email (Resend)

What it's for. The shop sends emails - order confirmations, password resets, contact-form messages, abandoned-cart reminders - through a service called Resend. This card connects the shop to your Resend account.

No key, no emails

If the Resend API key is not saved, the shop cannot send any email at all. Customers will not get order confirmations or password resets. This is the single most important field on the whole Settings page.

An API key is simply a long password that lets the shop log in to Resend on your behalf. You get it from your Resend account.

How to set it

  1. In Resend, go to API Keys and copy your key (it starts with re_).
  2. Paste it into the Resend API key field and click Spara (Save).
  3. Fill in the Avsändaradress (from address) - the address emails are sent from. It must use a domain you have verified in Resend.
  4. Fill in the Svara-till-adress (reply-to address) - where customer replies land. Use a real, monitored inbox.

Each field saves on its own. The key is hidden after saving and shown as •••••••• (sparad); leave it untouched to keep it, or type a new one to replace it.

Send a test email

At the bottom of the card, type any address into the box and click Skicka test (Send test). The shop sends a simple email using the current settings.

  • Success shows "Skickat" with a message id.
  • If no key is saved yet, you'll see "Ingen API-nyckel sparad än" (no API key saved yet).

Use this to confirm everything is wired up correctly.

Field What it's for
Resend API key The password that lets the shop send email through Resend. Required - without it, no emails send. Starts with re_.
Avsändaradress (From address) The address emails are sent from. Must match a domain verified in Resend, e.g. RMS Nordic <no-reply@rmsnordic.se>.
Svara-till-adress (Reply-to address) Where customer replies go. Use a staffed inbox, e.g. info@rmsnordic.se.
Send test email Sends a test message to any address to check the setup works.

What it's for. Stripe is the payment company that handles card payments. It powers two things:

  • Paying by card in the checkout.
  • The "Pay online" link on an invoice (the Faktura pay-link), so a customer can settle an invoice with a card.

This card holds the keys that connect the shop to your Stripe account, and a switch between Test and Live.

Test or Live?

At the top of the card is a Miljö (environment) switch:

  • Test - no real card is charged. Use Stripe's test card 4242 4242 4242 4242 to try a purchase safely.
  • Live - real cards are really charged. This is for the real shop.

Click Test or Live to switch. The choice saves immediately. The shop then uses whichever set of keys matches the chosen mode.

Match the mode to the keys

In Test mode the shop uses the three test keys. In Live mode it uses the three live keys. Before switching to Live, make sure the live keys and the live webhook secret are all saved.

The keys. Each mode needs three values, found in your Stripe Dashboard under Developers → API keys:

  • A secret key - a server-side password. Keep it private.
  • A publishable key - a public key that runs in the customer's browser. Safe to share.
  • A webhook signing secret - lets the shop trust the payment confirmations Stripe sends back.

How to set it

  1. Choose Test or Live with the environment switch.
  2. In your Stripe Dashboard, go to Developers → API keys and copy the secret and publishable keys for that mode.
  3. Paste each into the matching field and click Spara (Save).
  4. Set up the webhook: in Stripe go to Developers → Webhooks, add the URL https://api.rmsnordic.se/api/v1/webhooks/stripe, and subscribe to at least the event checkout.session.completed. Copy the Signing secret (starts with whsec_) into the matching webhook field here and save.

Secret keys are hidden after saving (shown as •••••••• (sparad)). Leave a field untouched to keep the saved value, or type a new one to replace it.

Field What it's for
Test secret key Server-side key for test mode. Starts sk_test_ or rk_test_. Keep private.
Test publishable key Public key for test mode. Starts pk_test_. Safe to expose.
Test webhook signing secret Verifies Stripe's confirmations in test mode. Starts whsec_.
Live secret key Server-side key for live (real) mode. Starts sk_live_ or rk_live_. Keep private.
Live publishable key Public key for live mode. Starts pk_live_. Safe to expose.
Live webhook signing secret Verifies Stripe's confirmations in live mode. Starts whsec_.

Restricted keys are recommended

Stripe lets you create a "Restricted key" (rk_...) that can only do what the shop needs. Using one of those instead of the all-powerful secret key is safer if the key were ever exposed.


Card payments (Nets Easy)

What it's for. Nets Easy is an older card-payment provider. It is the legacy system that is being replaced by Stripe (above). It is kept here for reference and fallback. For new setups, use Stripe.

The card works just like the Stripe one: a Test / Live switch and the keys that connect the shop to your Nets Easy account (from the Nets Easy Portal).

How to set it

  1. Choose Test or Live with the Miljö (environment) switch.
  2. In the Nets Easy Portal, under Integration keys, copy the secret and checkout keys for that environment.
  3. Paste each into the matching field and click Spara (Save).
  4. For webhooks, in the Nets Easy Portal go to Subscriptions → Webhooks, add the URL https://api.rmsnordic.se/api/v1/webhooks/nets, subscribe to at least payment.charge.created.v2, and set the Authorization header to match the value you save in Webhook authorization header here.
Field What it's for
Test secret key Server-side key for the Nets test environment.
Test checkout key Public key used by the checkout in the browser, test environment.
Live secret key Server-side key for the Nets live (real) environment.
Live checkout key Public key used by the checkout in the browser, live environment.
Webhook authorization header A shared secret the shop expects when Nets sends webhooks. Set the same value on the Nets webhook subscription.

Note

Because Nets is being phased out, most shops will only ever need the Stripe card above. If you're not sure, leave Nets as it is.


Checkout

What it's for. This card controls two checkout behaviours: when customers may pay by invoice, and how abandoned carts are handled.

Invoice threshold

This is the minimum order total (in Swedish kronor, SEK) before the "pay by invoice" option appears at checkout.

Two conditions are needed for invoice payment

A customer only sees the invoice option if both are true:

  1. Their order total is at or above this threshold, and
  2. Their profile has the Allow invoice payment flag switched on.

Leaving this field blank turns off invoice payment for the whole shop.

Abandoned carts

An "abandoned cart" is a cart a customer filled but never checked out.

  • Threshold (minutes) - how long a cart must sit untouched before it counts as abandoned. A background job checks every 15 minutes.
  • Send recovery email when cart is abandoned - if ticked, the customer gets a reminder email (via Resend) nudging them to finish. Each cart is emailed at most once, until the customer changes the cart again.

How to set it

  1. Enter the Invoice threshold (SEK), or leave it blank to disable invoice payment. It must be a positive number.
  2. Enter the Threshold (minutes) for abandoned carts (a positive number).
  3. Tick or untick Send recovery email when cart is abandoned.
  4. Click Save. Unlike the other cards, this one saves all three at once.
Field What it's for
Invoice threshold (SEK) Minimum order total before "pay by invoice" appears. Blank = invoice payment off everywhere. Also needs the customer's Allow invoice payment flag.
Abandoned-cart threshold (minutes) How long a cart sits untouched before it's flagged as abandoned. Checked every 15 minutes.
Send recovery email when cart is abandoned If ticked, sends the customer one reminder email per abandoned cart.

Common mistakes

Read before you change payment or email settings

  • No Resend API key = no emails. If the Resend key is missing, the shop sends nothing - no order confirmations, no password resets. Set it first, then send yourself a test email to confirm.
  • Wrong Stripe (or Nets) mode. In Test mode no real money moves; in Live mode real cards are charged. Selling for real but stuck in Test? No money arrives. Testing but set to Live? You'll charge real cards. Always match the mode to the keys you've saved.
  • Forgetting the webhook secret. Card payments confirm through a "webhook". If the webhook signing secret isn't saved for the active mode, confirmations may not be trusted. Save it whenever you switch modes.
  • Never share secret keys. The secret keys (Stripe/Nets) and the Resend API key are passwords. Never email them, paste them into chat, or share a screenshot. Publishable keys (pk_...) are safe to expose; secret keys are not.
  • From address not verified. If the email "from" address uses a domain you haven't verified in Resend, emails will fail. Verify the domain in Resend first.
  • Blank invoice threshold. Leaving it blank switches off invoice payment for the whole shop - only do that on purpose.
  • Launching too early. Once you click Launch site, the public sees the real shop. Preview it first with rmsnordic.se?preview=1.

Still stuck?

If something isn't working or you're unsure about a setting, don't guess with payment or email keys. Email developers@kavelsoftware.se and describe what you were trying to do.