---
title: "Get Promotions Setting"
method: GET
path: "/settings/promotions"
tags: ["Settings"]
---

# Get Promotions Setting

`GET /settings/promotions`

To retrieve the setting of Promotions<br>獲取優惠相關設定

## Response `200`

OK

- PromotionsSetting
  - `one_coupon_limit_enabled` boolean — Checkout Limitation to One Coupon<br> 購物車限用一組優惠代碼
  - `show_promotion_reminder` boolean — Show non-applied 'Free Shipping' promotion reminder on checkout page<br> 顯示未套用 '免運費' 活動提示於結帳購物車
  - `show_coupon` boolean — Show 'Coupon' in Storefront Member Center<br> 網店會員中心顯示 '優惠券'
  - `multi_order_discount_strategy` 'order_or_tier_promotion' | 'order_and_tier_promotions' | 'multi_order_and_tier_promotions' — Order-Level Discount Setting<br> 全店折扣優惠套用設定<br> order_or_tier_promotion:<br> Apply the promotion with largest discount among order-level discount promotions and membership offer.<br> 結帳擇優套用一組 全店滿額滿件折扣優惠 或 會員等級默認優惠<br> order_and_tier_promotions<br> Apply the promotion with largest discount among order-level discount promotions first and apply membership offer afterward.<br> 結帳擇優套用一組 全店滿額滿件折扣優惠後，疊加套用會員等級默認優惠<br> multi_order_and_tier_promotions<br> Apply multiple order-level discount promotions first and and apply membership offer afterward. 結帳疊加套用多組 全店滿額滿件折扣優惠 與 會員等級默認優惠<br>
  - `order_promotions_ignore_exclude_product` boolean — Order-level discount / Membership offer exclude 'product not applicable to discount'<br> 全店折扣優惠/會員等級默認優惠 排除「不適用折扣商品」
  - `order_gift_exclude_credit_and_point` boolean — [DEPRECATED] Total order over Minimum Amount Gift promotion condition deduct Credits and Points.<br> 全店滿額送贈品優惠條件扣除 折抵購物金 與 點數折現<br> This field will be deprecated. Please use `order_gift_threshold_mode` instead.<br> 此欄位即將淘汰，請改用 `order_gift_threshold_mode`。
  - `order_gift_threshold_mode` 'after_price_discounts' | 'after_all_discounts' — Gift Promotion – Minimum Amount Settings<br> 全店滿額送贈品<br> - `after_price_discounts`: Minimum amount is calculated as: Cart subtotal - Discounts (default)<br> 滿額條件以（購物車小計 - 折扣）計算（默認選中）<br> - `after_all_discounts`: Minimum amount is calculated as: Cart subtotal - Discounts - Credits - Points<br> 滿額條件以（購物車小計 - 折扣 - 折抵購物金 - 點數折現）計算
  - `category_item_gift_threshold_mode` 'before_discounts' | 'after_price_discounts' | 'after_all_discounts' — Free gift for selected products/categories over a minimum amount<br> 指定商品／分類滿額送贈品<br> - `before_discounts`: Minimum amount is calculated as: Selected product subtotal (default)<br> 滿額條件以（指定商品小計）計算（默認選中）<br> - `after_price_discounts`: Minimum amount is calculated as: Selected product subtotal - Discounts<br> 滿額條件以（指定商品小計 - 折扣）計算<br> - `after_all_discounts`: Minimum amount is calculated as: Selected product subtotal - Discounts - Credits - Points<br> 滿額條件以（指定商品小計 - 折扣 - 折抵購物金 - 點數折現）計算
  - `order_free_shipping_threshold_mode` 'after_price_discounts' | 'after_all_discounts' — Free shipping for order over a minimum amount<br> 全店滿額免運費<br> - `after_price_discounts`: Minimum amount is calculated as: Cart subtotal - Discounts<br> 滿額條件以（購物車小計 - 折扣）計算<br> - `after_all_discounts`: Minimum amount is calculated as: Cart subtotal - Discounts - Credits - Points (default)<br> 滿額條件以（購物車小計 - 折扣 - 折抵購物金 - 點數折現）計算（默認選中）
  - `category_item_free_shipping_threshold_mode` 'before_discounts' | 'after_price_discounts' | 'after_all_discounts' — Free shipping for selected products/categories over a minimum amount<br> 指定商品／分類滿額免運費<br> - `before_discounts`: Minimum amount is calculated as: Selected product subtotal (default)<br> 滿額條件以（指定商品小計）計算（默認選中）<br> - `after_price_discounts`: Minimum amount is calculated as: Selected product subtotal - Discounts<br> 滿額條件以（指定商品小計 - 折扣）計算<br> - `after_all_discounts`: Minimum amount is calculated as: Selected product subtotal - Discounts - Credits - Points<br> 滿額條件以（指定商品小計 - 折扣 - 折抵購物金 - 點數折現）計算

## Other responses

- `500` — Server error

---

[API](https://skmtc.net/shoplineapp/apis/shopline-open-api.md) · [All operations](https://skmtc.net/shoplineapp/apis/shopline-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shoplineapp/shopline-open-api/revisions/1675ac12cde7/schema)