--- title: Store Variables slug: oms/store-variables docTags: createdAt: 2023-02-18T00:04:51.000Z --- :::ExpandableHeading # Introduction You can use store variables to store credentials and configuration data, which your platforms retrieve when needed. A few prominent types of store variables exist in the Chord platform, each with its use cases. Below, they are grouped by areas/programs. ::: :::ExpandableHeading # What are Store Variables? Store variables are configuration settings available to your store dynamically during runtime. These variables comprise a name and a value. The value can come from various sources such as — third-party API, URLs, text files, etc. The value of these store variables is not hardcoded in your application; rather, they are dynamic and can be changed based on your program's environment. ::: :::ExpandableHeading # Analytics Analytics variables help you with the process of interpreting and communicating significant patterns in data. | **Variable** | **Values** | **Description** | | ------------------------------- | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | SEGMENT\_WRITE\_KEY |
| when creating an account for our tenant  | | EXCLUDED\_TRACKING\_PREFERENCES | Example: ‘Iterable, Google Analytics’ | List of comma-separated values for Segment destinations that *should not* receive Track events, even if the user permits it. | ::: :::ExpandableHeading # Fulfillment Services (3PL) A fulfillment service is a third-party warehouse that prepares and ships your orders for you. | **Variable** | **Values** | Descripti**on** | | --------------------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | EASYPOST\_KEY | | | | EXTERNAL\_TRACKER | enabled or disabled  | Requires an EasyPost account to track packages with a value of **enabled** | | NARVAR\_ENABLED | true or false | Either true or false if you are using Narvar to track packages | | NON\_FULFILLABLE\_SKUS | Comma separated list of SKUs
| SKUs included in this list will *not* be sent for fulfillment. | | EXPORT\_ORDER\_FULFILLMENTS | enabled or disabled  | This will allow the admin user to download their ready order fulfillments into a csv. As well as upload manually fulfilled shipments to be updated in the OMS. | | **SHIPSTATION** | | | | ---------------------------- | ------ | ---------------------------------------------------------- | | SHIPSTATION\_API\_KEY | | Found in your Shipstation account under API keys | | SHIPSTATION\_API\_SECRET |
| Found in your Shipstation account under API keys
| | SHIPSTATION\_STORE\_USERNAME |
| Provided when you create a Shipstation account
| | SHIPSTATION\_STORE\_PASSWORD |
| Provided when you create a Shipstation account

| | SHIPSTATION\_STORE\_ID | | Provided when you create a Shipstation account | | **WINE SHIPPING** |
|
| | ---------------------------- | ------------------------------------------------------------------------------------------------------------ | --------------------------------------------------- | | WINE\_SHIPPING\_PASSWORD |
| Provided when creating a wineshipping account
| | WINE\_SHIPPING\_CUSTOMER\_NO |
|
| | WINE\_SHIPPING\_API\_HOST | api-test.wineshipping.com on **Staging** and
api.wineshipping.com on **Production**


|
| | WINE\_SHIPPING\_USER\_KEY | | | | WINE\_SHIPPING\_API\_VERSION | If not provided it will default to V3 | | | **CAPACITY** |
|
| | ------------------------------ | -------------------------------------------------------------- | ------------------------------------------------------ | | CAPACITY\_CLIENT\_CODE |
| All settings will be provided by Capacity
| | CAPACITY\_API\_ENDPOINT | **Example**: http\://wservices.capacityllc.com:105

| All settings will be provided by Capacity | | CAPACITY\_FTP\_PASSWORD | **Example**: GO
| All settings will be provided by Capacity

| | CAPACITY\_FTP\_PORT |
| All settings will be provided by Capacity

| | CAPACITY\_FTP\_URL |
| All settings will be provided by Capacity

| | CAPACITY\_FTP\_USERNAME |
| All settings will be provided by Capacity

| | CAPACITY\_HTTP\_TIMEOUT |
| **Value**: The default value is 5 seconds. | | CAPACITY\_PASSWORD |
| All settings will be provided by Capacity

| | CAPACITY\_OWNER\_ID |
| All settings will be provided by Capacity

| | CAPACITY\_REST\_API\_KEY |
| All settings will be provided by Capacity

| | CAPACITY\_REST\_CLIENT\_CODE |
| All settings will be provided by Capacity

| | CAPACITY\_REST\_CLIENT\_ID |
| All settings will be provided by Capacity

| | CAPACITY\_REST\_CLIENT\_SECRET |
| All settings will be provided by Capacity

| | CAPACITY\_REST\_URI |
| All settings will be provided by Capacity

| | **ORDER-DESK** | |
| | ---------------------- | ----------------------------------- | ------------------------------------------------------------- | | NOTIFICATIONS\_HOST | **Example**: `tracking.mystore.com` | The OMS will use this to build the shipment notification url. | | ORDER\_DESK\_API\_KEY | | Information available when you create an Orderdesk account | | ORDER\_DESK\_STORE\_ID | | Information available when you create an Orderdesk account | | **SHIPHERO/SHIPMONK** | | | | -------------------------- | - | --------------------------------------------------------- | | SHIP\_HERO\_AUTH\_TOKEN | | Information available when you create an SHIPHERO account | | SHIP\_HERO\_REFRESH\_TOKEN | | Information available when you create an SHIPHERO account | ::: :::ExpandableHeading # Shipping Methods Shipping methods are the rates and services that your customers can choose from at checkout.  | **DELIVERR** | | | | ----------------------------- | --------------- | ---------------------------------------------------------------- | | DELIVERR\_SHIPPING\_EXCLUSIVE | true or false | Only Deliverr method will display at checkout if set to **true** | | DELIVERR\_ENABLED | enabled or true | | | **ACCELPAY** | | | | ----------------------------- | --------------- | --------------------------------------------------------------------- | | ACCELPAY\_SHIPPING\_EXCLUSIVE | true | Only AccelPay shipping method will display in checkout if set to true | | ACCELPAY\_ENABLED | enabled or true | | ::: :::ExpandableHeading # Shipping Settings Used to help you set up and manage your store's **shipping** rates, threshold and more | | | | | ------------------------------------ | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | FREE\_SHIPPING\_THRESHOLD | Example: 30 | If customer reaches $30 free shipping is enabled | | FREE\_SHIPPING\_UNIT |
WEIGHT | Free shipping can be enabled with either a dollar or weight threshold.
By default, the API expects a dollar-based shipping threshold that is
enabled by setting FREE\_SHIPPING\_THRESHOLD with no other configuration necessary. Stores that prefer to use package weight as a qualification mechanism can set FREE\_SHIPPING\_UNIT to WEIGHT, and the threshold value will be compared against the value returned by the package. weight
| | HOLD\_SHIPMENT\_WINDOW\_IN\_MINUTES  | **Example**: 90 (in minutes)  | Default is 60 - in minutes - The window in which an order can be canceled before it is pushed to the warehouse.
| | SHIPPING\_FLAT\_RATE | **Example**: 7.99
| This variable defines the price of your shipping rate.
| | SINGLE\_SHIPMENT\_PRIORITY | **Example**: enabled | Allows for optimization of fulfillment for all items in an order from a single stock location. | ::: :::ExpandableHeading # Tracking Packages A tracking number or tracking code **is a unique number assigned to packages**, allowing you to monitor the parcel's movement between your warehouse and your customers. | **Variable** | **Values** | **Description** | | ----------------- | ------------------- | -------------------------------------------------------------------------- | | EASYPOST\_KEY |
|
| | EXTERNAL\_TRACKER | enabled or disabled | Requires an EasyPost account to track packages with a value of **enabled** | | NARVAR\_ENABLED | true or false | Either true or false if you are using Narvar to track packages | ::: :::ExpandableHeading # Transactional Emails A transactional or triggered email is a personalized email sent to your customers directly responding to their online interaction. They typically have a functional purpose, like reminder emails about their subscriptions, back-in-stock product, shipping notifications, or updating customers about their orders. | **Variable** | **Value** | **Description** | | ------------------------------------------------------ | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ABANDONED\_CART\_EMAIL | enabled or disabled | This variable allows the system to email your customers after they add items to their bag and do not finalize checkout by either closing the browser or leaving it open for a minimum of 60 minutes.
This requires the email template to exist in your CMS and be **published** (if set to enabled) | | SUBSCRIPTION\_DEFAULT\_REMINDER\_DAYS  | **Example**: 15 | Value is in days. This variable allows the system to email your customers before their current Subscription ships - Actionable Date -
This requires the email template to exist in your CMS and be **published** (if set to enabled) | | SUBSCRIPTION\_LAST\_CHANCE\_REMINDER\_DAYS

| **Example**: 5 | Value is in days. This variable allows the system to email your customers offering them a last attempt to edit their subscription before it ships - Actionable Date - This requires the email template to exist in your CMS and be **published** (if set to enabled) | | SCHEDULE\_GIFT\_CARD\_REMINDERS | comma separated list of integers | if present, the OMS will be sending \ + x days, where x is an integer in the list. For Example, if the value is “15,30”, two Gift Card Reminders will be created with a remind\_at date of 15 days and 30 days from now | | REFERRAL\_PROMPT\_EMAIL | **enabled** or **disabled** | This variable allows the system to email your customers after they place an order to remind them they can tell their friends about your business to earn some rewards
This requires the email template to exist in your CMS and be **published** (if set to enabled) | | REFERRAL\_REWARD\_CONFIRMATION\_EMAIL | **enabled** or **disabled** | This variable allows the system to email your customers after their friends placed an order using the referral program. This email to remind them that they have successfully earned some rewards
This requires the email template to exist in your CMS and be **published** (if set to enabled) | | TRANSACTIONAL\_EMAILS\_ENABLED | **enabled** or **disabled** | When set to disabled, Chord will not deliver any transactional emails. This is useful for stores that want to send their transactional emails externally (Klaviyo templates, for example) | | ORDER\_CONFIRMATION\_SUPPRESSION\_LIST | **Example**: comma-delimited list of channels. | If an order is placed in one of provided channels, Order and Shipment confirmation emails are bypassed. | | CROSS\_SELL\_EMAIL | **enabled** or **disabled** | when enabled OMS will send out an email using a "cross\_sell\_email" template to the email associated with the order. | | STOCK\_REQUESTS\_NOTIFICATION\_ENABLED | **enabled** or **disabled** | This variable allows you to send email to your customers who are on the waiting list to let them know an item is back in stock
This requires the email template to exist in your CMS and be **published** (if set to enabled) | ::: :::ExpandableHeading # Payment Processors A payment service provider (PSP) is a third-party company that provides payment services to your business for your online payment methods. | **SQUARE** |
| | | --------------------- | ------------------------------------ | ----------------------------------- | | SQUARE\_LOCATION\_ID |
| Can be found in Square --> Account | | SQUARE\_ENVIRONMENT | either **sandbox** or **production** |
| | SQUARE\_APP\_ID |
| Can be found in Square --> Account | | SQUARE\_ACCESS\_TOKEN | | Can be found in Square --> Account | | **STRIPE** |  |  | | --------------------------------------------------------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | STRIPE\_ALLOWED\_CALLBACK\_URLS



| **Example**: https\://www\.chord.co. | In order to enable **checkout** (Redirect to Stripe) the URL must be listed as a value: i.e., , https\://www2.domain.com | | STRIPE\_API\_KEY | sk\_test\_xxxxx for Staging environment
sk\_live\_xxxxxx for Production | keys found in the customer's dashboard [https://dashboard.stripe.com/apikeys](https://dashboard.stripe.com/apikeys) | | STRIPE\_STATEMENT\_DESCRIPTOR |  **Example**: Chord.co | When your customer get charged, the value provided here will appear on their bank statement | | STRIPE\_WEBHOOK | enabled or disabled
| enabled (to allow for asynchronous events like checkout)
| | STRIPE\_WEBHOOK\_SECRET |  | Key (The endpoint’s secret, used to generate [webhook signatures](https://stripe.com/docs/webhooks/signatures). Only returned at creation.)
| | STRIPE\_SHIPPING\_ADDRESS\_MESSAGE | | The message you are typing here is what will display to your customers under Shipping Address at checkout | | STRIPE\_SUBMIT\_MESSAGE | | The message you are typing here is what will display to your customers under Billing Address at checkout | | STRIPE\_ALLOWED\_COUNTRIES | **Example**: US, CA, IT, FR | Allows for shipping to countries you select | | STRIPE\_PHONE\_NUMBER\_COLLECTION\_ENABLED | enabled or disabled | If enabled, your customers will have to provide their phone numbers at checkout. 
| | STRIPE\_CHECKOUT\_COMPLETED\_WEBHOOK\_ENABLED | enabled or disabled | Only used for POS Orders- Consumes the payment\_intent.succeeded event from Stripe. | | STRIPE\_CHECKOUT\_EXPIRATION\_IN\_MINUTES | 60 | Minimum value is an hour (in minutes) | | STRIPE\_CHECKOUT\_EXPIRED\_WEBHOOK\_ENABLED | **enabled** or **disabled** | This allows for enabling cart abandonment feature | | STRIPE\_CANCEL\_URL | cart | This value will be appended to the stripe base callback url. For example if callback url is `https://mystore.com` then the cancel url will be `https://mystore.com/cart` | | STRIPE\_REDIRECT\_URL\_LOCALE\_ENABLED | **enabled** or **disabled** | when enabled OMS will add the locale to stripe callback url, for example `https://mystore.com/en-US/order/confirmation`
| | STRIPE\_INVOICE\_DAYS\_UNTIL\_DUE | **Example**: 30 | For stores using Stripe Invoices, allows stores to configure the number of days until payment is due on an invoice. | | STRIPE\_PK\_KEY | **Example**:
sk\_test\_xxxxxxxx for staging
sk\_live\_xxxxx for Production
| Publishable keys found in Stripe [https://dashboard.stripe.com/test/apikeys](https://dashboard.stripe.com/test/apikeys)
| | STRIPE\_PRODUCT\_SYNC | enabled or disabled | When enabled, the OMS product catalog will be synced with Stripe. **This is required for Payment Links to work** | | STRIPE\_AUTOMATIC\_TAXES\_ENABLED
| enabled or disabled | to allow [automatic taxes](https://stripe.com/tax) to collect the right amount of tax wherever you sell your goods.
| | STRIPE\_PROMOTION\_CONSENT\_COLLECTION
| enabled or disabled
| **Enabled required.** If enabled, your customers will see an option to check to receive promotional offers at checkout
| | STRIPE\_SUBSCRIPTION\_CONSENT\_MESSAGE | | | | STRIPE\_CART\_RECOVERY\_PROMO\_CODE
| **Example**: promo\_1Lb9J2IkikXvVt8cphQDHAL8
| The ID of the coupon created with the Stripe Dashboard. This is used during checkout abandoned flow, the promo code should be applied in** checkout** when customers click on abandoned checkout link. | | STRIPE\_SUCCESS\_URL\_FORMAT
| path | if this is set to a value different than "path" the stripe success url will look like:
mystore.com/order/confirmation?number=OrderNumber\&checkout\_session\_id=\{CHECKOUT\_SESSION\_ID}
where by default order number and checkout session id are part of the URL path:
mystore.com/order/confirmation/number/\{CHECKOUT\_SESSION\_ID} | | STRIPE\_STATEMENT\_DESCRIPTOR | **Example**: chord | defaults to OMS Store name. This value is sent to stripe when creating a payment. See stripe [docs](https://stripe.com/docs/account/statement-descriptors#requirements) | | STRIPE\_SUBSCRIPTION\_CONSENT\_REQUIRED | **enabled** or **disabled** | Default value is "disabled". When set to "enabled" stripe checkout will require accepting terms of service before accepting orders with a subscription.

See stripe [docs](https://stripe.com/docs/payments/checkout/customization#collect-a-terms-of-service-agreement) | | STRIPE\_CHARGE\_EXPIRED\_WEBHOOK\_ENABLED | enabled or disabled | Auto-void expired payments on the OMS when Stripe sends us the charge.expired event | ::: :::ExpandableHeading # Content Management A Content Management System, also known as CMS, is used to manage your online store content, such as products, prices and much more. | **SANITY** |
|
| | ----------------------- | ----------------------------------- | -------------------------------------------------------------------------------------- | | SANITY\_DATASET | **production** or **staging**
| The name of the dataset within the project holding the entries to sync with OMS
| | SANITY\_PROJECT\_ID |
| The name of the project holding the entries to sync with OMS
| | SANITY\_TOKEN |
| Security token OMS uses to authenticate with Sanity when syncing entries.
| | SANITY\_WEBHOOK\_SECRET |
| Security token OMS uses to authenticate webhooks with Sanity
| | **CONTENTFUL** |
|
| | --------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------------------- | | CONTENTFUL\_ENVIRONMENT | **master** for Production
**staging** for Test Environment | Ensure to match the name that you have in your **Space** in Contentful
| | CONTENTFUL\_HOST | cdn.contentful.com

|
| | CONTENTFUL\_SPACE\_ID | Space ID
| Found in Contentul under Settings --> General Settings
| | CONTENTFUL\_WEBHOOK\_SECRET |
| Found in Contentful under Webhooks Settings
| | CONTENTFUL\_ACCESS\_TOKEN | | Found under Settings --> API KEYS. **Content Delivery API - access token** | ::: :::ExpandableHeading # Authentication Passwordless authentication | **MAGIC** | | | | --------------- | ------------------------- | ------------------ | | MAGIC\_API\_KEY | Example: sk\_live\_xxxxxx | Provided by Chord | | **STYTCH** | |
| | ------------------- | -------------------------------- | ------ | | AUTH\_PROVIDER | stytch | | | STYTCH\_PROJECT\_ID | Used for Stytch authentication | | | STYTCH\_SECRET | Used for Stytch authentication |
| | STYCTCH\_PROJECT | Used for Stytch authentication | | | STYTCH\_ENV | **live** or **test** if staging | | ::: :::ExpandableHeading # Taxes You can use Avalara or Stripe automated Taxes | **STRIPE TAXES** | | | | --------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------- | | STRIPE\_AUTOMATIC\_TAXES\_ENABLED | **enabled** or **disabled**
| If using Stripe automated taxes, enabled is required
| | SKIP\_STRIPE\_TAX\_RECALCULATION | **enabled** or **disabled** | Determines whether Stripe Tax caching will be used for automatic subscription installment orders | | **TAX FREE CHANNELS** | | | | --------------------- | --------------------------- | -------------------------------- | | TAX\_FREE\_CHANNELS | example: EDI, or wholesale  | Channels are defined in the OMS  | | **AVALARA** | |
| | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- | | AVATAX\_ACCOUNT | account ID (numeric) |
| | AVATAX | enabled or disabled | | | AVATAX\_COMPANY\_CODE |
| Provided when you create your Avalara Account
| | AVATAX\_LICENSE\_KEY |
| Provided when you create your Avalara Account
| | AVATAX\_LOG\_ENABLED | true or false |
| | AVATAX\_ORIGIN | **Example**: \{ "line1": "33 Irving Pl", "line2": "", "city": "New York", "region": "NY", "postalCode": "10003", "country": "US" } | Address of your business
| | AVATAX\_TAX\_CALCULATION\_ENABLED | true or false | **True** is suggested if using Avalara
| ::: :::ExpandableHeading # Affiliate Program An affiliate program is an agreement in which your business pays an influencer ('the affiliate') a commission for sending traffic and sales their way. | **Affiliate** | | | | -------------------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | AFFILIATE\_COMMISSION\_PERCENTAGE | Integer | The default commission amount paid on affiliate orders or line items | | AFFILIATE\_REVERSALS\_ENABLED | enabled or disabled | When enabled, when a refund is processed for an order with an associated affiliate payment, a transfer reversal will occur to reverse the commission payment | | AFFILIATE\_TRANSFER\_TIME\_IN\_MINUTES | Integer | Number of minutes after a payment is captured or a return is processed to wait before initiating the transfer or reversal with Stripe Connect | ::: :::ExpandableHeading # Referral Programs A Referral Program allows customers to earn promotional reward credits for future purchases by referring friends/family to your site. | **Referral** | | | | ------------------------------------- | ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | REFERRAL\_HOST  | URL of host who provides the referral program. i.e., www\.chord.com | usually the tenants’ site  | | REFERRAL\_CREDIT\_AMOUNT | Amount given to referrer i.e., 10 | the person who refers will get that amount when the person they referred places an order  | | REFERRAL\_ANNUAL\_LIMIT  | Annual Limit the Referrer is limited to referring i.e., 50 |
| | REFERRAL\_MAILER\_DELIVERY\_DELAY |
| select a number of days before sending the above email after a customer places an order  | | REFERRAL\_PROMPT\_EMAIL |  Either enabled or disabled |
| | REFERRAL\_REWARD\_CONFIRMATION\_EMAIL |  Either enabled or disabled |
| ::: :::ExpandableHeading # Email (SMTP) SMTPs are your outgoing mail server emails - At Chord we are using Mailgun or Sendgrid | **SMTP** | | | | -------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------ | | SMTP\_DOMAIN  | **Example**: smtp.mailgun.org
smtp.sendgrid.org

|
| | SMTP\_PASSWORD |
| Provided when setting up a new domain in Mailgun or Sendgrid | | SMTP\_USERNAME | | Provided when setting up a new domain in Mailgun or Sendgrid
| | SMTP\_ADDRESS  | | Provided when setting up a new domain in Mailgun or Sendgrid
| ::: ::::ExpandableHeading # Subscriptions For emails associated with Subscriptions please refer to Transactional Emails section. | **Subscriptions** | | | | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | FREE\_SHIPPING\_FOR\_SUBSCRIPTIONS  | **disabled** or **enabled ** | to get free shipping for Subscription orders | | SKIP\_PREPAID\_INSTALLMENT\_PROMOTIONS | **disabled** or **enabled ** | Controls whether prepaid installment orders will have any promotions applied | | STALE\_SUBSCRIPTION\_THRESHOLD\_DAYS | Integer | 180 The number of days that an incomplete subscription order will remain in current state before it is automatically canceled. | | SUBSCRIPTION\_MAXIMUM\_REPROCESSING\_COUNTER | integer | Maximum payment retry that can be executed after the last successful subscription installment. After that time, the subscription will be auto-canceled. | | STRIPE\_SUBSCRIPTION\_CONSENT\_REQUIRED | **disabled** or **enabled ** | Whether consent is required for subscriptions. When enabled, requires customer consent for subscription orders. | | STRIPE\_MONTHLY\_SUBSCRIPTION\_POST\_PROMOTION\_CONSENT\_MESSAGE | **disabled** or **enabled ** | When enabled, it would display:

*"This %\{interval\_length} month subscription plan will automatically renew for the same duration at the renewal amount of %\{price\_before\_discount} (plus applicable shipping & tax). You may pause or cancel your automatic renewal at any time by logging into your account dashboard."* | | STRIPE\_SUBSCRIPTION\_CONSENT\_MESSAGE | String \| **Default empty** | Additional consent text appended to regular (non-prepaid) subscription line item descriptions. | | STRIPE\_PREPAID\_RECURRING\_SUBSCRIPTION\_CONSENT\_MESSAGE | String \| **Default:**
This is a prepaid subscription for %\{installment\_count}(s) installments. Your subscription will automatically renew every %\{installment\_count} %\{interval\_units} at the renewal amount of %\{full\_price} (plus applicable tax). | Consent text shown for prepaid auto-renewing subscriptions. Explains the number of installments, how often the plan renews, and the renewal amount.

:::BlockQuote Available placeholders: %{installment_count}, %{interval_units}, %{full_price}, %{quantity}, %{price}, %{interval_length}, %{details} ::: | | STRIPE\_PREPAID\_GIFT\_SUBSCRIPTION\_CONSENT\_MESSAGE | String \| **Default:**
The gift recipient will receive 1 box every %\{interval\_length}%\{interval\_units}(s) for a total of %\{installment\_count} boxes. This gift plan doesn't auto-renew once the final box is shipped. | Consent text shown for gift prepaid subscriptions. Explains how many boxes the recipient will receive, how often they ship, and that the plan does not auto-renew.

:::BlockQuote Available placeholders: %\{interval\_length}, %\{interval\_units}, %\{installment\_count}, %\{quantity}, %\{price}, %\{full\_price}, %\{details} ::: | | STRIPE\_PREPAID\_SUBSCRIPTION\_CONSENT\_MESSAGE | String \| **Default:**
This is a prepaid subscription for %\{installment\_count} installments. Each installment includes the following: %\{details}. Your subscription will automatically end after all installments have been fulfilled. | Generic consent text for prepaid subscriptions that end automatically after all installments. Describes the number of installments and what each includes.

:::BlockQuote Available placeholders: %\{installment\_count}, %\{details}, %\{quantity}, %\{price}, %\{full\_price}, %\{interval\_length}, %\{interval\_units} ::: | :::: :::ExpandableHeading # Cross/Post-Sell A post-sales process is a series of tasks that you perform after your customer buys a product or service from you.  | **Cross-Sell** | | | | ------------------------------------- | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------- | | CROSS\_SELL\_EMAIL | **enabled** or **disabled** | when enabled OMS will send out an email using a "cross\_sell\_email" template to the email associated with the order.
| | CROSS\_SELL\_POST\_CHECKOUT | **enabled** or **disabled** | Allow your customer to be given the opportunity to cross-sell after checkout.
| | ORDER\_CROSS\_SELL\_TIME\_IN\_MINUTES | Any integer but defaults to 15 | used to define the `cross_sell_ends_at` property in orders api response
| ::: :::ExpandableHeading # Channels Order channels are a way to distinguish and organize orders by the way in which they pass through the OMS. | | | | | -------------------------------------- | ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | AUTOMATIC\_APPROVAL\_CHANNELS | comma-delimited list of channels
**Example**: Chord,Subscription, Batch | Orders that belong to a specified channel will bypass the manual approval process that can be enabled on certain shipping zones. | | ORDER\_CONFIRMATION\_SUPPRESSION\_LIST | **Example**: comma-delimited list of channels. | If an order is placed in one of provided channels, Order and Shipment confirmation emails are bypassed. | | TAX\_FREE\_CHANNELS | **Example**: EDI, or wholesale  | Channels are defined in the OMS  | ::: :::ExpandableHeading # Bundles | **SKU/BUNDLES** | | | | --------------------------- | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | VALIDATE\_PART\_LINE\_ITEMS | enabled/disabled | When enabled, OMS will prevent a customer from adding a part to a bundle *unless* explicitly permitted in Contentful. See [the note](https://docs.chord.co/syncing-content-with-contentful) | | SYNC\_SKU\_BASED\_BUNDLES | enabled/disabled | When disabled, kits from Contentful will no longer create SKU-based bundles. This is to switch to the new dynamic bundles. | ::: :::ExpandableHeading # Importer The Importer allows you to import specific data, such as Orders, Products, Customers, Gift Cards, and Subscriptions. | **GIFT CARD IMPORTER** | | | | ------------------------------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | GIFT\_CARD\_IMPORTER\_CREATE\_STORE\_CREDIT | **enabled** or **disabled** | When importing gift cards, states whether OMS should create associated store credits. If disabled, OMS will *not* create new credits but will instead try to find a matching existing store credit. | | GIFT\_NOTES\_ONLY\_WITH\_ASCII | **enabled** or **disabled** |
| ::: :::ExpandableHeading # Error Reporting The SENTRY\_DSN variable allows you to add your Sentry account information if you want to monitor and get alerts sent to your account. | **Error** **Reporting** | | | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------ | | SENTRY\_DSN | You can find the **DSN** in your Sentry project *settings* by navigating to **\[Project] > Settings > Client Keys (DSN)** in . | Set this to capture and record errors in Sentry. | ::: :::ExpandableHeading # International Passport is the international shipping carrier for your international sites | **PASSPORT**  | Value | Notes | | --------------------------- | ---------------------------- | ------------------------------------------- | | PASSPORT\_SHIPPING\_ENABLED | **enabled** or **disabled**  | enables when you create a Passport account | ::: :::ExpandableHeading # Miscellaneous | **Variable** | **Values** | **Descripti** | | ---------------------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | `INCLUDE_STOCK_AVAILABILITY_COUNT` | Enabled/ disabled | Include available stock quantity on [certain API endpoints](https://chord.stoplight.io/docs/chord-oms/359fc5352bdd1-return-the-variant-availability). | | `INCLUDE_BACKORDERABLE_IN_STOCK` | Enabled/ disabled | Account for "backorderable" stock setting when determining if item is in stock. | | `OVERRIDE_STOCK_LEVELS` | Enabled/ disabled | Allows orders to be shipped even when inventory unitrss are in a **backordered **state. | | `CAPTURE_PAYMENT_ON_SHIPMENT` | Enabled/ disabled | Payment capture is
**delayed until the shipment is shipped**
. Excludes orders containing prepaid subscriptions. | :::