feat(promotions): PROMO-1064 Add shipping discount action

Author: jpajar

docs/store-operations/promotions/examples/shipping.mdx

@@ -127,6 +127,8 @@
 
 ## Order at least X units of product Y and get free shipping to specific shipping zones
 
+
+
 <Tabs items={['Request', 'Response']}>
   <Tab>
 
@@ -273,17 +275,13 @@
       "meta": {}
     }
     ```
-
   </Tab>
 </Tabs>
 
 ## Order at least 2X of product and get free shipping
 
-
-
 <Tabs items={['Request', 'Response']}>
   <Tab>
-  
     ```json filename="Example request" showLineNumbers copy
     {
       "name": "Order at least 2X of product and get free shipping",
@@ -340,8 +338,6 @@
     }
     ```
 
-
-
   </Tab>
   <Tab>
     ```json filename="Example response" showLineNumbers copy
@@ -419,3 +415,79 @@
 
   </Tab>
 </Tabs>
+
+##Spend at least $100 and get $10 off shipping (specific methods)
+
+<Tabs items={['Request', 'Response']}>
+  <Tab>
+    ```json filename="Example request" showLineNumbers copy
+    {
+      "name": "Spend at least $100 and get $10 off shipping (specific methods)",
+      "redemption_type": "AUTOMATIC",
+      "rules": [
+        {
+          "action": {
+            "shipping_discount": {
+              "discount": { "fixed_amount": 10 },
+              "method_ids": [1, 3]
+            }
+          },
+          "apply_once": true,
+          "stop": false,
+          "condition": { "cart": { "minimum_spend": 100 } }
+        }
+      ],
+      "notifications": [],
+      "stop": false,
+      "status": "ENABLED",
+      "currency_code": "USD",
+      "start_date": "2025-10-01T00:00:00-05:00",
+      "end_date": null
+    }
+    ```
+
+  </Tab>
+  <Tab>
+    ```json filename="Example response" showLineNumbers copy
+      {
+      "data": {
+        "id": 1,
+        "name": "Spend at least $100 and get $10 off shipping (specific methods)",
+        "created_from": "api",
+        "customer": {
+          "group_ids": [],
+          "minimum_order_count": 0,
+          "excluded_group_ids": [],
+          "segments": null
+        },
+        "rules": [
+          {
+            "action": {
+              "shipping_discount": {
+                "discount": { "fixed_amount": "10" },
+                "method_ids": [1, 3]
+              }
+            },
+            "apply_once": true,
+            "stop": false,
+            "condition": { "cart": { "minimum_spend": "100" } }
+          }
+        ],
+        "notifications": [],
+        "stop": false,
+        "currency_code": "USD",
+        "redemption_type": "AUTOMATIC",
+        "shipping_address": null,
+        "current_uses": 0,
+        "max_uses": null,
+        "start_date": "2025-10-01T05:00:00+00:00",
+        "end_date": null,
+        "status": "ENABLED",
+        "schedule": null,
+        "can_be_used_with_other_promotions": true
+      },
+      "meta": {}
+    }
+    ```
+  </Tab>
+</Tabs>

docs/store-operations/promotions/index.mdx

@@ -9,6 +9,7 @@
   * Cart value **action** applies to the promotion value of the entire cart.
   * Gift item **action** gives a free gift item.
   * Fixed price set **action** applies a fixed price for a set of items.
+  * Shipping discount **action** applies discounts to the selected shipping methods.
 </Callout>