@linqapp/sdk 0.50.1 → 0.51.1

package/resources/payment-requests.d.ts

@@ -63,6 +63,45 @@ import { RequestOptions } from "../internal/request-options.js";
  * 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
@@ -220,9 +259,10 @@ export interface PaymentRequest {
      */
     id: string;
     /**
-     * Amount in the currency's minor units. In `subscription` mode this is the
-     * recurring amount (price × quantity) the recipient pays per interval, starting at
-     * checkout.
+     * What the recipient is charged at checkout, in the currency's minor units. 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.
      */
     amount: number;
     /**
@@ -243,6 +283,10 @@ export interface PaymentRequest {
      */
     status: 'requested' | 'succeeded' | 'canceled' | 'expired';
     description?: string;
+    /**
+     * Subscription mode — the discount applied, as Stripe applied it.
+     */
+    discount?: PaymentRequest.Discount;
     /**
      * When an unpaid request auto-expires.
      */
@@ -294,6 +338,23 @@ export interface PaymentRequest {
     updated_at?: string;
 }
 export declare namespace PaymentRequest {
+    /**
+     * Subscription mode — the discount applied, as Stripe applied it.
+     */
+    interface Discount {
+        /**
+         * The ID of the coupon applied.
+         */
+        coupon?: string;
+        /**
+         * The customer-facing discount description shown at checkout.
+         */
+        label?: string;
+        /**
+         * The ID of the promotion code applied, if you passed one.
+         */
+        promotion_code?: string;
+    }
     /**
      * Natural-rail join keys, present when `rail: natural`.
      */
@@ -363,6 +424,11 @@ export interface PaymentRequestCreateParams {
      * Body param: Optional description shown to the recipient at checkout.
      */
     description?: string;
+    /**
+     * Body param: Subscription mode only. The coupon or promotion code to apply to
+     * this subscription payment. Currently, only accept one coupon or one promo code.
+     */
+    discount?: PaymentRequestCreateParams.Discount;
     /**
      * Body param: Required for `rail: natural`. The line the request is sent from, in
      * E.164 format. Must be a phone number your organization owns.
@@ -428,6 +494,26 @@ export interface PaymentRequestCreateParams {
      */
     'Idempotency-Key'?: string;
 }
+export declare namespace PaymentRequestCreateParams {
+    /**
+     * Subscription mode only. The coupon or promotion code to apply to this
+     * subscription payment. Currently, only accept one coupon or one promo code.
+     */
+    interface Discount {
+        /**
+         * The ID of the coupon to apply to this subscription.
+         */
+        coupon?: string;
+        /**
+         * Name of the coupon/promo code displayed to customers.
+         */
+        label?: string;
+        /**
+         * The ID of a promotion code to apply to this subscription.
+         */
+        promotion_code?: string;
+    }
+}
 export interface PaymentRequestListParams {
     /**
      * Max results to return (default 20, max 100).

package/resources/payment-requests.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payment-requests.d.ts","sourceRoot":"","sources":["../src/resources/payment-requests.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,+BAA4B;AAEjD,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAG7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmJG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC9C;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,MAAM,EAAE,0BAA0B,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,cAAc,CAAC;IAYhG;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,cAAc,CAAC;IAIxF;;;;;;;;OAQG;IACH,IAAI,CACF,KAAK,GAAE,wBAAwB,GAAG,IAAI,GAAG,SAAc,EACvD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,0BAA0B,CAAC;IAIzC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,cAAc,CAAC;CAGvF;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB,UAAU,EAAE,MAAM,CAAC;IAEnB,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,EAAE,SAAS,GAAG,cAAc,CAAC;IAEjC,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;IAE3D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAE7C;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAErC;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAE5B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC;IAE/B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yBAAiB,cAAc,CAAC;IAC9B;;OAEG;IACH,UAAiB,OAAO;QACtB;;WAEG;QACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAE5B;;WAEG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB;IAED;;;;;OAKG;IACH,UAAiB,MAAM;QACrB;;;;WAIG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB;;WAEG;QACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAE3B;;WAEG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B;CACF;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAE5B;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAErC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,cAAc,CAAC;IAElC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAE5B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;CACzF;AAED,MAAM,CAAC,OAAO,WAAW,eAAe,CAAC;IACvC,OAAO,EACL,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,wBAAwB,IAAI,wBAAwB,GAC1D,CAAC;CACH"}
+{"version":3,"file":"payment-requests.d.ts","sourceRoot":"","sources":["../src/resources/payment-requests.ts"],"names":[],"mappings":"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"}

package/resources/payment-requests.js

@@ -67,6 +67,45 @@ const path_1 = require("../internal/utils/path.js");
  * 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

package/resources/payment-requests.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-requests.js","sourceRoot":"","sources":["../src/resources/payment-requests.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,oDAAmD;AAEnD,oDAA8C;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmJG;AACH,MAAa,eAAgB,SAAQ,sBAAW;IAC9C;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,MAAkC,EAAE,OAAwB;QACjE,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE;YAC/C,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,gBAAwB,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,wBAAwB,gBAAgB,EAAE,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CACF,QAAqD,EAAE,EACvD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,gBAAwB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,wBAAwB,gBAAgB,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3F,CAAC;CACF;AAtFD,0CAsFC"}
+{"version":3,"file":"payment-requests.js","sourceRoot":"","sources":["../src/resources/payment-requests.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,oDAAmD;AAEnD,oDAA8C;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0LG;AACH,MAAa,eAAgB,SAAQ,sBAAW;IAC9C;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,MAAkC,EAAE,OAAwB;QACjE,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE;YAC/C,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,gBAAwB,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,wBAAwB,gBAAgB,EAAE,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CACF,QAAqD,EAAE,EACvD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,gBAAwB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,wBAAwB,gBAAgB,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3F,CAAC;CACF;AAtFD,0CAsFC"}

package/resources/payment-requests.mjs

@@ -64,6 +64,45 @@ import { path } from "../internal/utils/path.mjs";
  * 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

package/resources/payment-requests.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"payment-requests.mjs","sourceRoot":"","sources":["../src/resources/payment-requests.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAE/C,OAAO,EAAE,YAAY,EAAE,gCAA4B;AAEnD,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmJG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,MAAkC,EAAE,OAAwB;QACjE,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE;YAC/C,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,gBAAwB,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,wBAAwB,gBAAgB,EAAE,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CACF,QAAqD,EAAE,EACvD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,gBAAwB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,wBAAwB,gBAAgB,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3F,CAAC;CACF"}
+{"version":3,"file":"payment-requests.mjs","sourceRoot":"","sources":["../src/resources/payment-requests.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAE/C,OAAO,EAAE,YAAY,EAAE,gCAA4B;AAEnD,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0LG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,MAAkC,EAAE,OAAwB;QACjE,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE;YAC/C,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;gBACnF,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,gBAAwB,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,wBAAwB,gBAAgB,EAAE,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CACF,QAAqD,EAAE,EACvD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,gBAAwB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,wBAAwB,gBAAgB,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3F,CAAC;CACF"}

package/src/client.ts

@@ -990,6 +990,7 @@ export class LinqAPIV3 {
    *
    * - **No expiry timestamp is exposed.** API responses and webhook payloads do not include the deletion time. If you need it, compute `created_at + 24h` yourself.
    * - **No deletion webhook is sent.** There is no `message.deleted` event — a message simply stops being retrievable once its window passes.
+   * - **The backstop governs Linq storage.** API retrievability (the `404` behavior above) and CDN media expire at the 24-hour mark. Removal of the corresponding entries from the sending device happens asynchronously and can complete after the backstop.
    * - **Delivery is unaffected.** Ephemeral messages send, deliver, and fire the usual `message.sent` / `message.received` and status webhooks exactly like standard messages. Only retention changes.
    *
    * **When to choose ephemeral:**
@@ -1306,6 +1307,45 @@ export class LinqAPIV3 {
    * 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

package/src/resources/chats/messages.ts

@@ -64,6 +64,7 @@ import { path } from '../../internal/utils/path';
  *
  * - **No expiry timestamp is exposed.** API responses and webhook payloads do not include the deletion time. If you need it, compute `created_at + 24h` yourself.
  * - **No deletion webhook is sent.** There is no `message.deleted` event — a message simply stops being retrievable once its window passes.
+ * - **The backstop governs Linq storage.** API retrievability (the `404` behavior above) and CDN media expire at the 24-hour mark. Removal of the corresponding entries from the sending device happens asynchronously and can complete after the backstop.
  * - **Delivery is unaffected.** Ephemeral messages send, deliver, and fire the usual `message.sent` / `message.received` and status webhooks exactly like standard messages. Only retention changes.
  *
  * **When to choose ephemeral:**

package/src/resources/chats/polls.ts

@@ -56,6 +56,7 @@ import { path } from '../../internal/utils/path';
  *
  * - **No expiry timestamp is exposed.** API responses and webhook payloads do not include the deletion time. If you need it, compute `created_at + 24h` yourself.
  * - **No deletion webhook is sent.** There is no `message.deleted` event — a message simply stops being retrievable once its window passes.
+ * - **The backstop governs Linq storage.** API retrievability (the `404` behavior above) and CDN media expire at the 24-hour mark. Removal of the corresponding entries from the sending device happens asynchronously and can complete after the backstop.
  * - **Delivery is unaffected.** Ephemeral messages send, deliver, and fire the usual `message.sent` / `message.received` and status webhooks exactly like standard messages. Only retention changes.
  *
  * **When to choose ephemeral:**

package/src/resources/messages/messages.ts

@@ -66,6 +66,7 @@ import { path } from '../../internal/utils/path';
  *
  * - **No expiry timestamp is exposed.** API responses and webhook payloads do not include the deletion time. If you need it, compute `created_at + 24h` yourself.
  * - **No deletion webhook is sent.** There is no `message.deleted` event — a message simply stops being retrievable once its window passes.
+ * - **The backstop governs Linq storage.** API retrievability (the `404` behavior above) and CDN media expire at the 24-hour mark. Removal of the corresponding entries from the sending device happens asynchronously and can complete after the backstop.
  * - **Delivery is unaffected.** Ephemeral messages send, deliver, and fire the usual `message.sent` / `message.received` and status webhooks exactly like standard messages. Only retention changes.
  *
  * **When to choose ephemeral:**

package/src/resources/messages/poll.ts

@@ -56,6 +56,7 @@ import { path } from '../../internal/utils/path';
  *
  * - **No expiry timestamp is exposed.** API responses and webhook payloads do not include the deletion time. If you need it, compute `created_at + 24h` yourself.
  * - **No deletion webhook is sent.** There is no `message.deleted` event — a message simply stops being retrievable once its window passes.
+ * - **The backstop governs Linq storage.** API retrievability (the `404` behavior above) and CDN media expire at the 24-hour mark. Removal of the corresponding entries from the sending device happens asynchronously and can complete after the backstop.
  * - **Delivery is unaffected.** Ephemeral messages send, deliver, and fire the usual `message.sent` / `message.received` and status webhooks exactly like standard messages. Only retention changes.
  *
  * **When to choose ephemeral:**

package/src/resources/payment-requests.ts

@@ -68,6 +68,45 @@ import { path } from '../internal/utils/path';
  * 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
@@ -249,9 +288,10 @@ export interface PaymentRequest {
   id: string;
 
   /**
-   * Amount in the currency's minor units. In `subscription` mode this is the
-   * recurring amount (price × quantity) the recipient pays per interval, starting at
-   * checkout.
+   * What the recipient is charged at checkout, in the currency's minor units. 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.
    */
   amount: number;
 
@@ -280,6 +320,11 @@ export interface PaymentRequest {
 
   description?: string;
 
+  /**
+   * Subscription mode — the discount applied, as Stripe applied it.
+   */
+  discount?: PaymentRequest.Discount;
+
   /**
    * When an unpaid request auto-expires.
    */
@@ -341,6 +386,26 @@ export interface PaymentRequest {
 }
 
 export namespace PaymentRequest {
+  /**
+   * Subscription mode — the discount applied, as Stripe applied it.
+   */
+  export interface Discount {
+    /**
+     * The ID of the coupon applied.
+     */
+    coupon?: string;
+
+    /**
+     * The customer-facing discount description shown at checkout.
+     */
+    label?: string;
+
+    /**
+     * The ID of the promotion code applied, if you passed one.
+     */
+    promotion_code?: string;
+  }
+
   /**
    * Natural-rail join keys, present when `rail: natural`.
    */
@@ -422,6 +487,12 @@ export interface PaymentRequestCreateParams {
    */
   description?: string;
 
+  /**
+   * Body param: Subscription mode only. The coupon or promotion code to apply to
+   * this subscription payment. Currently, only accept one coupon or one promo code.
+   */
+  discount?: PaymentRequestCreateParams.Discount;
+
   /**
    * Body param: Required for `rail: natural`. The line the request is sent from, in
    * E.164 format. Must be a phone number your organization owns.
@@ -495,6 +566,29 @@ export interface PaymentRequestCreateParams {
   'Idempotency-Key'?: string;
 }
 
+export namespace PaymentRequestCreateParams {
+  /**
+   * Subscription mode only. The coupon or promotion code to apply to this
+   * subscription payment. Currently, only accept one coupon or one promo code.
+   */
+  export interface Discount {
+    /**
+     * The ID of the coupon to apply to this subscription.
+     */
+    coupon?: string;
+
+    /**
+     * Name of the coupon/promo code displayed to customers.
+     */
+    label?: string;
+
+    /**
+     * The ID of a promotion code to apply to this subscription.
+     */
+    promotion_code?: string;
+  }
+}
+
 export interface PaymentRequestListParams {
   /**
    * Max results to return (default 20, max 100).

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.50.1'; // x-release-please-version
+export const VERSION = '0.51.1'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.50.1";
+export declare const VERSION = "0.51.1";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.50.1";
+export declare const VERSION = "0.51.1";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.50.1'; // x-release-please-version
+exports.VERSION = '0.51.1'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.50.1'; // x-release-please-version
+export const VERSION = '0.51.1'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map