linq-python 0.36.1__tar.gz → 0.37.0__tar.gz

linq_python-0.37.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.37.0"
+}

{linq_python-0.36.1 → linq_python-0.37.0}/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.37.0](https://github.com/linq-team/linq-python/compare/v0.36.1...v0.37.0) (2026-08-28)
+
+
+### Features
+
+* add discount support with coupons and promotion codes ([5427381](https://github.com/linq-team/linq-python/commit/5427381d5591b92d80cf169774f4bde887fcd28b))
+
 ## [0.36.1](https://github.com/linq-team/linq-python/compare/v0.36.0...v0.36.1) (2026-08-28)
 
 

{linq_python-0.36.1 → linq_python-0.37.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: linq-python
-Version: 0.36.1
+Version: 0.37.0
 Summary: The official Python library for the linq-api-v3 API
 Project-URL: Homepage, https://github.com/linq-team/linq-python
 Project-URL: Repository, https://github.com/linq-team/linq-python

{linq_python-0.36.1 → linq_python-0.37.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "linq-python"
-version = "0.36.1"
+version = "0.37.0"
 description = "The official Python library for the linq-api-v3 API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{linq_python-0.36.1 → linq_python-0.37.0}/src/linq/_client.py

@@ -548,6 +548,45 @@ class LinqAPIV3(SyncAPIClient):
         the Customer and Subscription, so correlating in either direction is
         trivial. There are no renewal webhooks from Linq by design.
 
+        ### Discounts
+
+        Pass a `discount` with a **coupon** or **promotion code** from your
+        connected Stripe account to apply it to the subscription. Create either in
+        your Stripe Dashboard under Product catalog → Coupons; Linq only forwards
+        the id.
+
+        ```json
+        {
+          "mode": "subscription",
+          "price_id": "price_1QAbCdEfGhIjKlMn",
+          "discount": {
+            "coupon": "7fKCMvBh",
+            "label": "50% OFF FIRST MONTH"
+          }
+        }
+        ```
+
+        Stripe applies the coupon and prices the first invoice; the `amount` we
+        return is that invoice's amount due, so a `$50.00/month` price with a
+        50%-off-first-month coupon comes back as `2500` and the recipient is
+        charged **$25.00** at checkout. A coupon that covers the whole first
+        invoice returns `amount: 0`; checkout shows $0.00 and collects the card for
+        the renewal rather than charging now. Renewals bill at the full price
+        automatically — how long a discount lasts is the coupon's `duration`,
+        enforced by Stripe on your account, and Linq never re-prices anything.
+
+        Use `promotion_code` instead of `coupon` to apply a promotion code by id
+        (`promo_...`, not the customer-facing code string); pass one or the other,
+        never both.
+
+        `label` is the customer-facing promotion name displayed at checkout instead
+        of the coupon or promotion code ID. The label is displayed exactly as
+        provided, so include important terms such as "FIRST MONTH" or
+        "FIRST 3 MONTHS" when applicable. These terms are not displayed elsewhere
+        on the checkout screen.
+
+        If omitted, Stripe uses the coupon's name as the promotion label.
+
         ### Free trials
 
         Add `trial_period_days` (or a fixed `trial_end` timestamp) to start the
@@ -1624,6 +1663,45 @@ class AsyncLinqAPIV3(AsyncAPIClient):
         the Customer and Subscription, so correlating in either direction is
         trivial. There are no renewal webhooks from Linq by design.
 
+        ### Discounts
+
+        Pass a `discount` with a **coupon** or **promotion code** from your
+        connected Stripe account to apply it to the subscription. Create either in
+        your Stripe Dashboard under Product catalog → Coupons; Linq only forwards
+        the id.
+
+        ```json
+        {
+          "mode": "subscription",
+          "price_id": "price_1QAbCdEfGhIjKlMn",
+          "discount": {
+            "coupon": "7fKCMvBh",
+            "label": "50% OFF FIRST MONTH"
+          }
+        }
+        ```
+
+        Stripe applies the coupon and prices the first invoice; the `amount` we
+        return is that invoice's amount due, so a `$50.00/month` price with a
+        50%-off-first-month coupon comes back as `2500` and the recipient is
+        charged **$25.00** at checkout. A coupon that covers the whole first
+        invoice returns `amount: 0`; checkout shows $0.00 and collects the card for
+        the renewal rather than charging now. Renewals bill at the full price
+        automatically — how long a discount lasts is the coupon's `duration`,
+        enforced by Stripe on your account, and Linq never re-prices anything.
+
+        Use `promotion_code` instead of `coupon` to apply a promotion code by id
+        (`promo_...`, not the customer-facing code string); pass one or the other,
+        never both.
+
+        `label` is the customer-facing promotion name displayed at checkout instead
+        of the coupon or promotion code ID. The label is displayed exactly as
+        provided, so include important terms such as "FIRST MONTH" or
+        "FIRST 3 MONTHS" when applicable. These terms are not displayed elsewhere
+        on the checkout screen.
+
+        If omitted, Stripe uses the coupon's name as the promotion label.
+
         ### Free trials
 
         Add `trial_period_days` (or a fixed `trial_end` timestamp) to start the
@@ -2634,6 +2712,45 @@ class LinqAPIV3WithRawResponse:
         the Customer and Subscription, so correlating in either direction is
         trivial. There are no renewal webhooks from Linq by design.
 
+        ### Discounts
+
+        Pass a `discount` with a **coupon** or **promotion code** from your
+        connected Stripe account to apply it to the subscription. Create either in
+        your Stripe Dashboard under Product catalog → Coupons; Linq only forwards
+        the id.
+
+        ```json
+        {
+          "mode": "subscription",
+          "price_id": "price_1QAbCdEfGhIjKlMn",
+          "discount": {
+            "coupon": "7fKCMvBh",
+            "label": "50% OFF FIRST MONTH"
+          }
+        }
+        ```
+
+        Stripe applies the coupon and prices the first invoice; the `amount` we
+        return is that invoice's amount due, so a `$50.00/month` price with a
+        50%-off-first-month coupon comes back as `2500` and the recipient is
+        charged **$25.00** at checkout. A coupon that covers the whole first
+        invoice returns `amount: 0`; checkout shows $0.00 and collects the card for
+        the renewal rather than charging now. Renewals bill at the full price
+        automatically — how long a discount lasts is the coupon's `duration`,
+        enforced by Stripe on your account, and Linq never re-prices anything.
+
+        Use `promotion_code` instead of `coupon` to apply a promotion code by id
+        (`promo_...`, not the customer-facing code string); pass one or the other,
+        never both.
+
+        `label` is the customer-facing promotion name displayed at checkout instead
+        of the coupon or promotion code ID. The label is displayed exactly as
+        provided, so include important terms such as "FIRST MONTH" or
+        "FIRST 3 MONTHS" when applicable. These terms are not displayed elsewhere
+        on the checkout screen.
+
+        If omitted, Stripe uses the coupon's name as the promotion label.
+
         ### Free trials
 
         Add `trial_period_days` (or a fixed `trial_end` timestamp) to start the
@@ -3516,6 +3633,45 @@ class AsyncLinqAPIV3WithRawResponse:
         the Customer and Subscription, so correlating in either direction is
         trivial. There are no renewal webhooks from Linq by design.
 
+        ### Discounts
+
+        Pass a `discount` with a **coupon** or **promotion code** from your
+        connected Stripe account to apply it to the subscription. Create either in
+        your Stripe Dashboard under Product catalog → Coupons; Linq only forwards
+        the id.
+
+        ```json
+        {
+          "mode": "subscription",
+          "price_id": "price_1QAbCdEfGhIjKlMn",
+          "discount": {
+            "coupon": "7fKCMvBh",
+            "label": "50% OFF FIRST MONTH"
+          }
+        }
+        ```
+
+        Stripe applies the coupon and prices the first invoice; the `amount` we
+        return is that invoice's amount due, so a `$50.00/month` price with a
+        50%-off-first-month coupon comes back as `2500` and the recipient is
+        charged **$25.00** at checkout. A coupon that covers the whole first
+        invoice returns `amount: 0`; checkout shows $0.00 and collects the card for
+        the renewal rather than charging now. Renewals bill at the full price
+        automatically — how long a discount lasts is the coupon's `duration`,
+        enforced by Stripe on your account, and Linq never re-prices anything.
+
+        Use `promotion_code` instead of `coupon` to apply a promotion code by id
+        (`promo_...`, not the customer-facing code string); pass one or the other,
+        never both.
+
+        `label` is the customer-facing promotion name displayed at checkout instead
+        of the coupon or promotion code ID. The label is displayed exactly as
+        provided, so include important terms such as "FIRST MONTH" or
+        "FIRST 3 MONTHS" when applicable. These terms are not displayed elsewhere
+        on the checkout screen.
+
+        If omitted, Stripe uses the coupon's name as the promotion label.
+
         ### Free trials
 
         Add `trial_period_days` (or a fixed `trial_end` timestamp) to start the
@@ -4398,6 +4554,45 @@ class LinqAPIV3WithStreamedResponse:
         the Customer and Subscription, so correlating in either direction is
         trivial. There are no renewal webhooks from Linq by design.
 
+        ### Discounts
+
+        Pass a `discount` with a **coupon** or **promotion code** from your
+        connected Stripe account to apply it to the subscription. Create either in
+        your Stripe Dashboard under Product catalog → Coupons; Linq only forwards
+        the id.
+
+        ```json
+        {
+          "mode": "subscription",
+          "price_id": "price_1QAbCdEfGhIjKlMn",
+          "discount": {
+            "coupon": "7fKCMvBh",
+            "label": "50% OFF FIRST MONTH"
+          }
+        }
+        ```
+
+        Stripe applies the coupon and prices the first invoice; the `amount` we
+        return is that invoice's amount due, so a `$50.00/month` price with a
+        50%-off-first-month coupon comes back as `2500` and the recipient is
+        charged **$25.00** at checkout. A coupon that covers the whole first
+        invoice returns `amount: 0`; checkout shows $0.00 and collects the card for
+        the renewal rather than charging now. Renewals bill at the full price
+        automatically — how long a discount lasts is the coupon's `duration`,
+        enforced by Stripe on your account, and Linq never re-prices anything.
+
+        Use `promotion_code` instead of `coupon` to apply a promotion code by id
+        (`promo_...`, not the customer-facing code string); pass one or the other,
+        never both.
+
+        `label` is the customer-facing promotion name displayed at checkout instead
+        of the coupon or promotion code ID. The label is displayed exactly as
+        provided, so include important terms such as "FIRST MONTH" or
+        "FIRST 3 MONTHS" when applicable. These terms are not displayed elsewhere
+        on the checkout screen.
+
+        If omitted, Stripe uses the coupon's name as the promotion label.
+
         ### Free trials
 
         Add `trial_period_days` (or a fixed `trial_end` timestamp) to start the
@@ -5280,6 +5475,45 @@ class AsyncLinqAPIV3WithStreamedResponse:
         the Customer and Subscription, so correlating in either direction is
         trivial. There are no renewal webhooks from Linq by design.
 
+        ### Discounts
+
+        Pass a `discount` with a **coupon** or **promotion code** from your
+        connected Stripe account to apply it to the subscription. Create either in
+        your Stripe Dashboard under Product catalog → Coupons; Linq only forwards
+        the id.
+
+        ```json
+        {
+          "mode": "subscription",
+          "price_id": "price_1QAbCdEfGhIjKlMn",
+          "discount": {
+            "coupon": "7fKCMvBh",
+            "label": "50% OFF FIRST MONTH"
+          }
+        }
+        ```
+
+        Stripe applies the coupon and prices the first invoice; the `amount` we
+        return is that invoice's amount due, so a `$50.00/month` price with a
+        50%-off-first-month coupon comes back as `2500` and the recipient is
+        charged **$25.00** at checkout. A coupon that covers the whole first
+        invoice returns `amount: 0`; checkout shows $0.00 and collects the card for
+        the renewal rather than charging now. Renewals bill at the full price
+        automatically — how long a discount lasts is the coupon's `duration`,
+        enforced by Stripe on your account, and Linq never re-prices anything.
+
+        Use `promotion_code` instead of `coupon` to apply a promotion code by id
+        (`promo_...`, not the customer-facing code string); pass one or the other,
+        never both.
+
+        `label` is the customer-facing promotion name displayed at checkout instead
+        of the coupon or promotion code ID. The label is displayed exactly as
+        provided, so include important terms such as "FIRST MONTH" or
+        "FIRST 3 MONTHS" when applicable. These terms are not displayed elsewhere
+        on the checkout screen.
+
+        If omitted, Stripe uses the coupon's name as the promotion label.
+
         ### Free trials
 
         Add `trial_period_days` (or a fixed `trial_end` timestamp) to start the

{linq_python-0.36.1 → linq_python-0.37.0}/src/linq/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "linq"
-__version__ = "0.36.1"  # x-release-please-version
+__version__ = "0.37.0"  # x-release-please-version

{linq_python-0.36.1 → linq_python-0.37.0}/src/linq/resources/payment_requests.py

@@ -90,6 +90,45 @@ class PaymentRequestsResource(SyncAPIResource):
     the Customer and Subscription, so correlating in either direction is
     trivial. There are no renewal webhooks from Linq by design.
 
+    ### Discounts
+
+    Pass a `discount` with a **coupon** or **promotion code** from your
+    connected Stripe account to apply it to the subscription. Create either in
+    your Stripe Dashboard under Product catalog → Coupons; Linq only forwards
+    the id.
+
+    ```json
+    {
+      "mode": "subscription",
+      "price_id": "price_1QAbCdEfGhIjKlMn",
+      "discount": {
+        "coupon": "7fKCMvBh",
+        "label": "50% OFF FIRST MONTH"
+      }
+    }
+    ```
+
+    Stripe applies the coupon and prices the first invoice; the `amount` we
+    return is that invoice's amount due, so a `$50.00/month` price with a
+    50%-off-first-month coupon comes back as `2500` and the recipient is
+    charged **$25.00** at checkout. A coupon that covers the whole first
+    invoice returns `amount: 0`; checkout shows $0.00 and collects the card for
+    the renewal rather than charging now. Renewals bill at the full price
+    automatically — how long a discount lasts is the coupon's `duration`,
+    enforced by Stripe on your account, and Linq never re-prices anything.
+
+    Use `promotion_code` instead of `coupon` to apply a promotion code by id
+    (`promo_...`, not the customer-facing code string); pass one or the other,
+    never both.
+
+    `label` is the customer-facing promotion name displayed at checkout instead
+    of the coupon or promotion code ID. The label is displayed exactly as
+    provided, so include important terms such as "FIRST MONTH" or
+    "FIRST 3 MONTHS" when applicable. These terms are not displayed elsewhere
+    on the checkout screen.
+
+    If omitted, Stripe uses the coupon's name as the promotion label.
+
     ### Free trials
 
     Add `trial_period_days` (or a fixed `trial_end` timestamp) to start the
@@ -203,6 +242,7 @@ class PaymentRequestsResource(SyncAPIResource):
         currency: str | Omit = omit,
         customer_id: str | Omit = omit,
         description: str | Omit = omit,
+        discount: payment_request_create_params.Discount | Omit = omit,
         from_: str | Omit = omit,
         metadata: Dict[str, str] | Omit = omit,
         mode: Literal["payment", "subscription"] | Omit = omit,
@@ -254,6 +294,9 @@ class PaymentRequestsResource(SyncAPIResource):
 
           description: Optional description shown to the recipient at checkout.
 
+          discount: Subscription mode only. The coupon or promotion code to apply to this
+              subscription payment. Currently, only accept one coupon or one promo code.
+
           from_: Required for `rail: natural`. The line the request is sent from, in E.164
               format. Must be a phone number your organization owns.
 
@@ -308,6 +351,7 @@ class PaymentRequestsResource(SyncAPIResource):
                     "currency": currency,
                     "customer_id": customer_id,
                     "description": description,
+                    "discount": discount,
                     "from_": from_,
                     "metadata": metadata,
                     "mode": mode,
@@ -511,6 +555,45 @@ class AsyncPaymentRequestsResource(AsyncAPIResource):
     the Customer and Subscription, so correlating in either direction is
     trivial. There are no renewal webhooks from Linq by design.
 
+    ### Discounts
+
+    Pass a `discount` with a **coupon** or **promotion code** from your
+    connected Stripe account to apply it to the subscription. Create either in
+    your Stripe Dashboard under Product catalog → Coupons; Linq only forwards
+    the id.
+
+    ```json
+    {
+      "mode": "subscription",
+      "price_id": "price_1QAbCdEfGhIjKlMn",
+      "discount": {
+        "coupon": "7fKCMvBh",
+        "label": "50% OFF FIRST MONTH"
+      }
+    }
+    ```
+
+    Stripe applies the coupon and prices the first invoice; the `amount` we
+    return is that invoice's amount due, so a `$50.00/month` price with a
+    50%-off-first-month coupon comes back as `2500` and the recipient is
+    charged **$25.00** at checkout. A coupon that covers the whole first
+    invoice returns `amount: 0`; checkout shows $0.00 and collects the card for
+    the renewal rather than charging now. Renewals bill at the full price
+    automatically — how long a discount lasts is the coupon's `duration`,
+    enforced by Stripe on your account, and Linq never re-prices anything.
+
+    Use `promotion_code` instead of `coupon` to apply a promotion code by id
+    (`promo_...`, not the customer-facing code string); pass one or the other,
+    never both.
+
+    `label` is the customer-facing promotion name displayed at checkout instead
+    of the coupon or promotion code ID. The label is displayed exactly as
+    provided, so include important terms such as "FIRST MONTH" or
+    "FIRST 3 MONTHS" when applicable. These terms are not displayed elsewhere
+    on the checkout screen.
+
+    If omitted, Stripe uses the coupon's name as the promotion label.
+
     ### Free trials
 
     Add `trial_period_days` (or a fixed `trial_end` timestamp) to start the
@@ -624,6 +707,7 @@ class AsyncPaymentRequestsResource(AsyncAPIResource):
         currency: str | Omit = omit,
         customer_id: str | Omit = omit,
         description: str | Omit = omit,
+        discount: payment_request_create_params.Discount | Omit = omit,
         from_: str | Omit = omit,
         metadata: Dict[str, str] | Omit = omit,
         mode: Literal["payment", "subscription"] | Omit = omit,
@@ -675,6 +759,9 @@ class AsyncPaymentRequestsResource(AsyncAPIResource):
 
           description: Optional description shown to the recipient at checkout.
 
+          discount: Subscription mode only. The coupon or promotion code to apply to this
+              subscription payment. Currently, only accept one coupon or one promo code.
+
           from_: Required for `rail: natural`. The line the request is sent from, in E.164
               format. Must be a phone number your organization owns.
 
@@ -729,6 +816,7 @@ class AsyncPaymentRequestsResource(AsyncAPIResource):
                     "currency": currency,
                     "customer_id": customer_id,
                     "description": description,
+                    "discount": discount,
                     "from_": from_,
                     "metadata": metadata,
                     "mode": mode,

{linq_python-0.36.1 → linq_python-0.37.0}/src/linq/types/payment_request.py

@@ -6,7 +6,20 @@ from typing_extensions import Literal
 
 from .._models import BaseModel
 
-__all__ = ["PaymentRequest", "Natural", "Stripe"]
+__all__ = ["PaymentRequest", "Discount", "Natural", "Stripe"]
+
+
+class Discount(BaseModel):
+    """Subscription mode — the discount applied, as Stripe applied it."""
+
+    coupon: Optional[str] = None
+    """The ID of the coupon applied."""
+
+    label: Optional[str] = None
+    """The customer-facing discount description shown at checkout."""
+
+    promotion_code: Optional[str] = None
+    """The ID of the promotion code applied, if you passed one."""
 
 
 class Natural(BaseModel):
@@ -47,10 +60,11 @@ class PaymentRequest(BaseModel):
     """Unique identifier of the payment request."""
 
     amount: int
-    """Amount in the currency's minor units.
+    """What the recipient is charged at checkout, in the currency's minor units.
 
-    In `subscription` mode this is the recurring amount (price × quantity) the
-    recipient pays per interval, starting at checkout.
+    In `subscription` mode this is the first invoice's amount due — all items after
+    any discounts are applied — so a discount that covers the whole invoice returns
+    `0` and checkout shows $0.00.
     """
 
     checkout_url: str
@@ -74,6 +88,9 @@ class PaymentRequest(BaseModel):
 
     description: Optional[str] = None
 
+    discount: Optional[Discount] = None
+    """Subscription mode — the discount applied, as Stripe applied it."""
+
     expires_at: Optional[datetime] = None
     """When an unpaid request auto-expires."""
 

{linq_python-0.36.1 → linq_python-0.37.0}/src/linq/types/payment_request_create_params.py

@@ -8,7 +8,7 @@ from typing_extensions import Literal, Annotated, TypedDict
 
 from .._utils import PropertyInfo
 
-__all__ = ["PaymentRequestCreateParams"]
+__all__ = ["PaymentRequestCreateParams", "Discount"]
 
 
 class PaymentRequestCreateParams(TypedDict, total=False):
@@ -39,6 +39,13 @@ class PaymentRequestCreateParams(TypedDict, total=False):
     description: str
     """Optional description shown to the recipient at checkout."""
 
+    discount: Discount
+    """Subscription mode only.
+
+    The coupon or promotion code to apply to this subscription payment. Currently,
+    only accept one coupon or one promo code.
+    """
+
     from_: Annotated[str, PropertyInfo(alias="from")]
     """Required for `rail: natural`.
 
@@ -102,3 +109,21 @@ class PaymentRequestCreateParams(TypedDict, total=False):
     """
 
     idempotency_key: Annotated[str, PropertyInfo(alias="Idempotency-Key")]
+
+
+class Discount(TypedDict, total=False):
+    """Subscription mode only.
+
+    The coupon or promotion code to apply to
+    this subscription payment. Currently, only accept one coupon or one
+    promo code.
+    """
+
+    coupon: str
+    """The ID of the coupon to apply to this subscription."""
+
+    label: str
+    """Name of the coupon/promo code displayed to customers."""
+
+    promotion_code: str
+    """The ID of a promotion code to apply to this subscription."""

{linq_python-0.36.1 → linq_python-0.37.0}/tests/api_resources/test_payment_requests.py

@@ -35,6 +35,11 @@ class TestPaymentRequests:
             currency="usd",
             customer_id="cus_QAbCdEfGhIjKlMn",
             description="Coffee with Ava",
+            discount={
+                "coupon": "7fKCMvBh",
+                "label": "15% OFF FIRST 3 MONTHS",
+                "promotion_code": "promo_1QAbCdEfGhIjKlMn",
+            },
             from_="+12025550123",
             metadata={"order_id": "order_8675309"},
             mode="payment",
@@ -212,6 +217,11 @@ class TestAsyncPaymentRequests:
             currency="usd",
             customer_id="cus_QAbCdEfGhIjKlMn",
             description="Coffee with Ava",
+            discount={
+                "coupon": "7fKCMvBh",
+                "label": "15% OFF FIRST 3 MONTHS",
+                "promotion_code": "promo_1QAbCdEfGhIjKlMn",
+            },
             from_="+12025550123",
             metadata={"order_id": "order_8675309"},
             mode="payment",

{linq_python-0.36.1 → linq_python-0.37.0}/uv.lock

@@ -530,7 +530,7 @@ wheels = [
 
 [[package]]
 name = "linq-python"
-version = "0.36.0"
+version = "0.36.1"
 source = { editable = "." }
 dependencies = [
     { name = "anyio" },

linq_python-0.36.1/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "0.36.1"
-}