dodopayments 2.42.2 → 2.43.0

package/src/resources/discounts.ts

@@ -42,7 +42,7 @@ export class Discounts extends APIResource {
    * ```ts
    * const discount = await client.discounts.create({
    *   amount: 0,
-   *   type: 'percentage',
+   *   type: 'flat',
    * });
    * ```
    */
@@ -133,6 +133,11 @@ export interface Discount {
    */
   created_at: string;
 
+  /**
+   * Who may redeem this discount code.
+   */
+  customer_eligibility: 'any' | 'first_time' | 'existing' | 'specific';
+
   /**
    * The unique discount ID
    */
@@ -160,10 +165,16 @@ export interface Discount {
   times_used: number;
 
   /**
-   * The type of discount. Currently only `percentage` is supported.
+   * The type of discount (`percentage` or `flat`).
    */
   type: DiscountType;
 
+  /**
+   * Per-currency options (flat deduction / percentage cap + minimum subtotal). Empty
+   * for discounts without any configured currency options.
+   */
+  currency_options?: Array<Discount.CurrencyOption>;
+
   /**
    * Optional date/time after which discount is expired.
    */
@@ -174,6 +185,17 @@ export interface Discount {
    */
   name?: string | null;
 
+  /**
+   * Maximum number of times a single customer may redeem this discount, if any.
+   */
+  per_customer_usage_limit?: number | null;
+
+  /**
+   * Optional date/time before which the discount is not yet active. NULL = active
+   * immediately.
+   */
+  starts_at?: string | null;
+
   /**
    * Number of subscription billing cycles this discount is valid for. If not
    * provided, the discount will be applied indefinitely to all recurring payments
@@ -187,6 +209,35 @@ export interface Discount {
   usage_limit?: number | null;
 }
 
+export namespace Discount {
+  /**
+   * A per-currency discount option (response shape). `max_amount_possible` mirrors
+   * the DB column of the same name.
+   */
+  export interface CurrencyOption {
+    /**
+     * The currency this option applies to.
+     */
+    currency: MiscAPI.Currency;
+
+    /**
+     * Whether this is the default row FX conversions pivot from.
+     */
+    is_default: boolean;
+
+    /**
+     * Eligible-cart threshold in this currency's subunits (0 = no minimum).
+     */
+    minimum_subtotal: number;
+
+    /**
+     * The most this code discounts in this currency's subunits (flat deduction or
+     * percentage cap).
+     */
+    max_amount_possible?: number | null;
+  }
+}
+
 /**
  * Response struct for a discount with its position in a stack and optional
  * cycle-tracking information (for subscriptions).
@@ -274,11 +325,13 @@ export interface DiscountDetail {
   usage_limit?: number | null;
 }
 
-export type DiscountType = 'percentage';
+export type DiscountType = 'flat' | 'percentage';
 
 export interface DiscountListParams extends DefaultPageNumberPaginationParams {
   /**
-   * Filter by active status (true = not expired, false = expired)
+   * Filter by active status. `true` = currently redeemable (started, not expired,
+   * not usage-exhausted). `false` = not currently redeemable (expired,
+   * usage-exhausted, or pending a future `starts_at`).
    */
   active?: boolean;
 
@@ -308,7 +361,7 @@ export interface DiscountCreateParams {
   amount: number;
 
   /**
-   * The discount type. Currently only `percentage` is supported.
+   * The discount type: `percentage` or `flat` (`flat_per_unit` stays blocked).
    */
   type: DiscountType;
 
@@ -320,6 +373,21 @@ export interface DiscountCreateParams {
    */
   code?: string | null;
 
+  /**
+   * Per-currency options (flat deduction / percentage cap + minimum subtotal).
+   * Required for `flat` codes (must include a resolvable default); optional
+   * per-currency caps for `percentage` codes. Per-row invariants are checked in
+   * `normalize_currency_options`, not via `#[validate(nested)]`.
+   */
+  currency_options?: Array<DiscountCreateParams.CurrencyOption> | null;
+
+  /**
+   * Who may redeem this discount code. Defaults to `any` (unrestricted). `specific`
+   * starts with zero attached customers (fails closed) until customers are attached
+   * via `POST /discounts/{id}/customers`.
+   */
+  customer_eligibility?: 'any' | 'first_time' | 'existing' | 'specific' | null;
+
   /**
    * When the discount expires, if ever.
    */
@@ -332,6 +400,12 @@ export interface DiscountCreateParams {
 
   name?: string | null;
 
+  /**
+   * Maximum number of times a single customer may redeem this discount. Must be
+   * `<= usage_limit` when both are set.
+   */
+  per_customer_usage_limit?: number | null;
+
   /**
    * Whether this discount should be preserved when a subscription changes plans.
    * Default: false (discount is removed on plan change)
@@ -343,6 +417,12 @@ export interface DiscountCreateParams {
    */
   restricted_to?: Array<string> | null;
 
+  /**
+   * When the discount becomes active, if scheduled for the future. NULL = active
+   * immediately. Must be strictly before `expires_at` when both are set.
+   */
+  starts_at?: string | null;
+
   /**
    * Number of subscription billing cycles this discount is valid for. If not
    * provided, the discount will be applied indefinitely to all recurring payments
@@ -356,6 +436,40 @@ export interface DiscountCreateParams {
   usage_limit?: number | null;
 }
 
+export namespace DiscountCreateParams {
+  /**
+   * A per-currency discount option (request shape).
+   *
+   * `max_amount_possible` is the most this code discounts in this currency — the
+   * flat deduction for `flat` codes, or the max-discount cap for `percentage` codes.
+   * Maps to the DB column of the same name.
+   */
+  export interface CurrencyOption {
+    /**
+     * The currency this option applies to.
+     */
+    currency: MiscAPI.Currency;
+
+    /**
+     * Whether this row is the default to convert from for unconfigured currencies. At
+     * most one row per discount may be default.
+     */
+    is_default?: boolean;
+
+    /**
+     * The most this code discounts in this currency's subunits. For `flat` codes this
+     * is the deduction; for `percentage` codes it is the max-discount cap. Must be > 0
+     * if provided.
+     */
+    max_amount_possible?: number | null;
+
+    /**
+     * Eligible-cart threshold in this currency's subunits (0 = no minimum).
+     */
+    minimum_subtotal?: number;
+  }
+}
+
 export interface DiscountUpdateParams {
   /**
    * If present, update the discount amount in **basis points** (e.g., `540` =
@@ -370,6 +484,19 @@ export interface DiscountUpdateParams {
    */
   code?: string | null;
 
+  /**
+   * If present, fully replaces the discount's currency options (replace-set
+   * semantics, like `restricted_to`). Send an empty array to clear them.
+   */
+  currency_options?: Array<DiscountUpdateParams.CurrencyOption> | null;
+
+  /**
+   * If present, update who may redeem this discount. Plain field (not
+   * double-option): the DB column is `NOT NULL`, so it can never be cleared back to
+   * unset, only changed to another `CustomerEligibility` value.
+   */
+  customer_eligibility?: 'any' | 'first_time' | 'existing' | 'specific' | null;
+
   expires_at?: string | null;
 
   /**
@@ -379,6 +506,13 @@ export interface DiscountUpdateParams {
 
   name?: string | null;
 
+  /**
+   * If present, update the per-customer usage limit (double-option: send `null` to
+   * clear it back to unlimited). Must be `<= usage_limit` (the value in effect after
+   * this patch) when both are set.
+   */
+  per_customer_usage_limit?: number | null;
+
   /**
    * Whether this discount should be preserved when a subscription changes plans. If
    * not provided, the existing value is kept.
@@ -391,6 +525,11 @@ export interface DiscountUpdateParams {
    */
   restricted_to?: Array<string> | null;
 
+  /**
+   * If present, update `starts_at` (double-option: send `null` to clear it).
+   */
+  starts_at?: string | null;
+
   /**
    * Number of subscription billing cycles this discount is valid for. If not
    * provided, the discount will be applied indefinitely to all recurring payments
@@ -399,13 +538,47 @@ export interface DiscountUpdateParams {
   subscription_cycles?: number | null;
 
   /**
-   * If present, update the discount type. Currently only `percentage` is supported.
+   * If present, update the discount type (`percentage` or `flat`).
    */
   type?: DiscountType | null;
 
   usage_limit?: number | null;
 }
 
+export namespace DiscountUpdateParams {
+  /**
+   * A per-currency discount option (request shape).
+   *
+   * `max_amount_possible` is the most this code discounts in this currency — the
+   * flat deduction for `flat` codes, or the max-discount cap for `percentage` codes.
+   * Maps to the DB column of the same name.
+   */
+  export interface CurrencyOption {
+    /**
+     * The currency this option applies to.
+     */
+    currency: MiscAPI.Currency;
+
+    /**
+     * Whether this row is the default to convert from for unconfigured currencies. At
+     * most one row per discount may be default.
+     */
+    is_default?: boolean;
+
+    /**
+     * The most this code discounts in this currency's subunits. For `flat` codes this
+     * is the deduction; for `percentage` codes it is the max-discount cap. Must be > 0
+     * if provided.
+     */
+    max_amount_possible?: number | null;
+
+    /**
+     * Eligible-cart threshold in this currency's subunits (0 = no minimum).
+     */
+    minimum_subtotal?: number;
+  }
+}
+
 export declare namespace Discounts {
   export {
     type Discount as Discount,

package/src/resources/payments.ts

@@ -358,6 +358,15 @@ export interface Payment {
    */
   error_message?: string | null;
 
+  /**
+   * Purpose-built failure messaging for the merchant and the customer, derived from
+   * `error_code`. Present whenever `error_code` is set, regardless of payment
+   * status; unrecognised codes still resolve via a generic fallback rather than
+   * being omitted. The customer copy is always generic for fraud-sensitive declines
+   * (lost/stolen/pickup/fraudulent) so the true reason is never leaked.
+   */
+  failure_details?: Payment.FailureDetails | null;
+
   /**
    * Invoice ID for this payment. Uses India-specific invoice ID if available.
    */
@@ -429,6 +438,78 @@ export interface Payment {
 }
 
 export namespace Payment {
+  /**
+   * Purpose-built failure messaging for the merchant and the customer, derived from
+   * `error_code`. Present whenever `error_code` is set, regardless of payment
+   * status; unrecognised codes still resolve via a generic fallback rather than
+   * being omitted. The customer copy is always generic for fraud-sensitive declines
+   * (lost/stolen/pickup/fraudulent) so the true reason is never leaked.
+   */
+  export interface FailureDetails {
+    /**
+     * The unified error code (echoes `error_code`).
+     */
+    code: string;
+
+    /**
+     * The primary CTA to show the customer.
+     */
+    customer_cta:
+      | 'edit_and_retry'
+      | 'use_another_method'
+      | 'try_again'
+      | 'try_later'
+      | 'retry_and_verify'
+      | 'restart'
+      | 'update_method';
+
+    /**
+     * Whether the customer can resolve this themselves (e.g. fix CVC).
+     */
+    customer_fixable: boolean;
+
+    /**
+     * The customer-facing string. Always generic (`C11`) for the fraud-4.
+     */
+    customer_message: string;
+
+    /**
+     * The customer message template identifier (C1..C20).
+     */
+    customer_template:
+      | 'C1'
+      | 'C2'
+      | 'C3'
+      | 'C4'
+      | 'C5'
+      | 'C6'
+      | 'C7'
+      | 'C8'
+      | 'C9'
+      | 'C10'
+      | 'C11'
+      | 'C12'
+      | 'C13'
+      | 'C14'
+      | 'C15'
+      | 'C16'
+      | 'C17'
+      | 'C18'
+      | 'C19'
+      | 'C20';
+
+    /**
+     * Soft or hard decline.
+     */
+    decline_type: 'soft' | 'hard';
+
+    /**
+     * Merchant-facing headline + recommended action (Payment Details). For the fraud-4
+     * this includes the operator "do not reveal" warning.
+     */
+    merchant_message: string;
+  }
+
   export interface ProductCart {
     product_id: string;
 
@@ -519,7 +600,6 @@ export type PaymentMethodTypes =
   | 'sepa'
   | 'sepa_bank_transfer'
   | 'sofort'
-  | 'sunbit'
   | 'swish'
   | 'touch_n_go'
   | 'trustly'
@@ -758,6 +838,156 @@ export interface PaymentListParams extends DefaultPageNumberPaginationParams {
    */
   created_at_lte?: string;
 
+  /**
+   * Filter by currency
+   */
+  currency?:
+    | 'AED'
+    | 'ALL'
+    | 'AMD'
+    | 'ANG'
+    | 'AOA'
+    | 'ARS'
+    | 'AUD'
+    | 'AWG'
+    | 'AZN'
+    | 'BAM'
+    | 'BBD'
+    | 'BDT'
+    | 'BGN'
+    | 'BHD'
+    | 'BIF'
+    | 'BMD'
+    | 'BND'
+    | 'BOB'
+    | 'BRL'
+    | 'BSD'
+    | 'BWP'
+    | 'BYN'
+    | 'BZD'
+    | 'CAD'
+    | 'CHF'
+    | 'CLP'
+    | 'CNY'
+    | 'COP'
+    | 'CRC'
+    | 'CUP'
+    | 'CVE'
+    | 'CZK'
+    | 'DJF'
+    | 'DKK'
+    | 'DOP'
+    | 'DZD'
+    | 'EGP'
+    | 'ETB'
+    | 'EUR'
+    | 'FJD'
+    | 'FKP'
+    | 'GBP'
+    | 'GEL'
+    | 'GHS'
+    | 'GIP'
+    | 'GMD'
+    | 'GNF'
+    | 'GTQ'
+    | 'GYD'
+    | 'HKD'
+    | 'HNL'
+    | 'HRK'
+    | 'HTG'
+    | 'HUF'
+    | 'IDR'
+    | 'ILS'
+    | 'INR'
+    | 'IQD'
+    | 'JMD'
+    | 'JOD'
+    | 'JPY'
+    | 'KES'
+    | 'KGS'
+    | 'KHR'
+    | 'KMF'
+    | 'KRW'
+    | 'KWD'
+    | 'KYD'
+    | 'KZT'
+    | 'LAK'
+    | 'LBP'
+    | 'LKR'
+    | 'LRD'
+    | 'LSL'
+    | 'LYD'
+    | 'MAD'
+    | 'MDL'
+    | 'MGA'
+    | 'MKD'
+    | 'MMK'
+    | 'MNT'
+    | 'MOP'
+    | 'MRU'
+    | 'MUR'
+    | 'MVR'
+    | 'MWK'
+    | 'MXN'
+    | 'MYR'
+    | 'MZN'
+    | 'NAD'
+    | 'NGN'
+    | 'NIO'
+    | 'NOK'
+    | 'NPR'
+    | 'NZD'
+    | 'OMR'
+    | 'PAB'
+    | 'PEN'
+    | 'PGK'
+    | 'PHP'
+    | 'PKR'
+    | 'PLN'
+    | 'PYG'
+    | 'QAR'
+    | 'RON'
+    | 'RSD'
+    | 'RUB'
+    | 'RWF'
+    | 'SAR'
+    | 'SBD'
+    | 'SCR'
+    | 'SEK'
+    | 'SGD'
+    | 'SHP'
+    | 'SLE'
+    | 'SLL'
+    | 'SOS'
+    | 'SRD'
+    | 'SSP'
+    | 'STN'
+    | 'SVC'
+    | 'SZL'
+    | 'THB'
+    | 'TND'
+    | 'TOP'
+    | 'TRY'
+    | 'TTD'
+    | 'TWD'
+    | 'TZS'
+    | 'UAH'
+    | 'UGX'
+    | 'USD'
+    | 'UYU'
+    | 'UZS'
+    | 'VES'
+    | 'VND'
+    | 'VUV'
+    | 'WST'
+    | 'XAF'
+    | 'XCD'
+    | 'XOF'
+    | 'XPF'
+    | 'YER'
+    | 'ZAR'
+    | 'ZMW';
+
   /**
    * Filter by customer id
    */

package/src/resources/products/products.ts

@@ -583,6 +583,18 @@ export namespace Price {
      */
     tax_inclusive?: boolean | null;
 
+    /**
+     * Amount charged today for a paid trial, in the price currency's minor units.
+     * Requires `trial_period_days > 0`. Omit or null for a free trial (the default).
+     */
+    trial_amount?: number | null;
+
+    /**
+     * Whether discount codes reduce the trial charge. Defaults to false. Only
+     * meaningful when a paid trial is configured.
+     */
+    trial_apply_discounts?: boolean | null;
+
     /**
      * Number of days for the trial period. A value of `0` indicates no trial period.
      */

package/src/resources/subscriptions.ts

@@ -677,6 +677,13 @@ export interface Subscription {
    * Tax identifier provided for this subscription (if applicable)
    */
   tax_id?: string | null;
+
+  /**
+   * Per-unit trial amount after discounts, snapshotted at subscription creation
+   * (price currency minor units, pre-quantity, pre-tax). Null for a free trial or no
+   * trial.
+   */
+  trial_amount?: number | null;
 }
 
 export type SubscriptionStatus = 'pending' | 'active' | 'on_hold' | 'cancelled' | 'failed' | 'expired';
@@ -819,6 +826,12 @@ export interface SubscriptionCreateResponse {
    * URL to checkout page
    */
   payment_link?: string | null;
+
+  /**
+   * Per-unit trial amount after discounts, in the price currency's minor units
+   * (pre-quantity, pre-tax). Null for a free trial or no trial.
+   */
+  trial_amount?: number | null;
 }
 
 export namespace SubscriptionCreateResponse {
@@ -980,6 +993,13 @@ export interface SubscriptionListResponse {
    * Tax identifier provided for this subscription (if applicable)
    */
   tax_id?: string | null;
+
+  /**
+   * Per-unit trial amount after discounts, snapshotted at subscription creation
+   * (price currency minor units, pre-quantity, pre-tax). Null for a free trial or no
+   * trial.
+   */
+  trial_amount?: number | null;
 }
 
 export namespace SubscriptionListResponse {

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '2.42.2'; // x-release-please-version
+export const VERSION = '2.43.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "2.42.2";
+export declare const VERSION = "2.43.0";
 //# 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 = '2.42.2'; // x-release-please-version
+exports.VERSION = '2.43.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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