Change your store's settings

The Settings section of the Commerce tab holds the store's own settings: its details, what checkout asks of shoppers, returns and policies, low stock alerts and how often the store pays out. Each card saves on its own.

• You need the Admin or Owner role to change settings. Other members see each card's values, with a note that the page is read-only for them.
• The rest of the store's setup has sections of its own beside Settings, under Setup: Shipping, Fulfilment, Fees, Emails, Storefront for the publishable keys and sales channels, and the Merchant profile.

1. In the dashboard, open the organization, then Commerce, then Setup, then Settings.
2. Change the fields on a card. The card's footer counts the changes to save.
3. Select Save changes on that card, or Discard to put its fields back.

An optional field you empty goes back to its default when you save.

Store name

Shoppers see it in the emails the store sends them.

Support email

The store's emails tell shoppers to write to this address.

Storefront address

Order links in the store's emails open on it, and PayPal or your payment page sends shoppers back to it after they pay. It starts with https://.

Sites that may call the Store API

One site per line, up to 20, each a scheme and a host such as https://shop.example.com. With none listed, any site can call the Store API from a browser. With a list, only those sites can, and the card warns you when the storefront's own site is missing from it.

Default currency

Prices are in it wherever no region applies, since each region sells in its own currency. The import form starts on it.

Other currencies

Where no region applies, a storefront can ask for prices in these, and an import can price in them. Once you remove one, a storefront that asks for it where no region applies is refused. A region that sells in it keeps selling in it.

Default language and Other languages

Your storefront reads the languages from the Store API and starts in the default one. Each order keeps the language its cart was in. Other languages are tags such as en-GB or de, separated by commas.

Guest checkout

On by default: shoppers can order without an account. Turned off, they sign in first.

Terms of sale

With a page set, checkout asks shoppers to accept it, and each order records when they did.

Terms version

Up to 40 characters, recorded on each order with the acceptance. Change it when the terms change.

Privacy policy

Your storefront reads it from the Store API, to link to it.

Order links work for

How long the order link in the store's emails opens the order without signing in: from 1 to 3,650 days, and 90 days unless set.

Next order number

The number the store's next order gets, from 1 to 999,999,999. A new store starts at #1001. To carry on from the shop this store replaces, enter one more than its last order number. From there each order gets the next number, and no number is used twice. Numbers only go up: once the store has taken an order, a lower number changes nothing, and the field warns you before you save one.

Unpaid checkouts end after

How long a shopper has to finish paying, counted from when the payment started or from when they came back to it: from 15 to 1,440 minutes, and 60 minutes unless set. Then Coritan cancels the payment, and the checkout moves to Unpaid checkouts. A payment the provider reports as still processing waits for its money instead.

High-value first order

A first order from an email address above this total is one risk signal. Two signals, or a high rating from the payment provider, hold the order until you release it in Orders. The default is 500.00 in the store's default currency, and the same number counts in every currency.

Orders count as completed when

Shipped, the default, or Delivered. It decides when an order's status turns from Processing to Completed, in Orders and in the Store API. An order with nothing to ship is completed once it is paid.

Return window

How long after delivery shoppers can ask for a return from your storefront, or after shipping when there is no delivery date: from 0 to 3,650 days, and 30 days unless set. 0 turns shopper requests off, and you can still open returns yourself.

Refund policy and Shipping policy

Up to 5,000 characters each. Coritan sends them with your evidence when a shopper disputes a payment.

The Low stock card emails your own people when an item runs low. Track stock and stock locations explains each field.

Pay out

Daily, Weekly or Monthly, and weekly unless set. Days start at midnight, weeks on Monday and months on the 1st, all in UTC. Payouts shows the minimum for each currency, and lets you ask for a payout sooner.

Each card confirms what it saved, such as "Checkout settings saved.", and shows the new values.

The storefront's pages cannot call the Store API

Sites that may call the Store API lists sites, and the storefront's own site is not one of them. Add it, or empty the list.

A card says it could not save

The alert or the field gives the reason. Fix the value, then select Save changes again.

• Run your store from the Commerce tab
• Connect a storefront to your store
• Send orders to a fulfilment provider
• Set up regions and shipping

PATCH https://api.coritan.com/api/v1/orgs/{org_slug}/commerce/store changes the store's details, and takes these keys under settings: guest_checkout, terms_url, terms_version, privacy_url, order_access_days, unpaid_minutes, risk_high_value, completed_when (shipped or delivered), returns_window_days, refund_policy, shipping_policy, auto_dispatch, release_delay_minutes, payout_schedule, order_number_start, storefront (a JSON object, replaced whole), leads_turnstile, notify_shipped, notify_delivered and notify_new_referral. The last three turn the shipping email, the delivery email and the affiliate commission email on or off, as Emails describes: notify_shipped is on unless you set it to false, and notify_delivered and notify_new_referral are off unless you set them to true. A setting sent as null goes back to its default. The answer's next_order_number is the number the next order gets. Change the store's settings has the details.

curl -X PATCH "https://api.coritan.com/api/v1/orgs/acme/commerce/store" \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"settings": {"guest_checkout": false, "returns_window_days": 14}}'