dodopayments 2.42.1 → 2.43.0

package/src/resources/payments.ts

@@ -247,6 +247,12 @@ export interface Payment {
    */
   disputes: Array<DisputesAPI.Dispute>;
 
+  /**
+   * Whether this payment was created solely to update a subscription's payment
+   * method (a zero-/setup-amount charge). `false` for normal charges.
+   */
+  is_update_payment_method: boolean;
+
   /**
    * Additional custom data associated with the payment
    */
@@ -352,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.
    */
@@ -372,6 +387,11 @@ export interface Payment {
    */
   payment_method?: string | null;
 
+  /**
+   * Identifier of the saved payment method used for this payment, if any.
+   */
+  payment_method_id?: string | null;
+
   /**
    * Specific type of payment method (e.g. "visa", "mastercard")
    */
@@ -418,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;
 
@@ -508,7 +600,6 @@ export type PaymentMethodTypes =
   | 'sepa'
   | 'sepa_bank_transfer'
   | 'sofort'
-  | 'sunbit'
   | 'swish'
   | 'touch_n_go'
   | 'trustly'
@@ -747,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 {
@@ -1272,6 +1292,11 @@ export interface SubscriptionListParams extends DefaultPageNumberPaginationParam
    */
   brand_id?: string;
 
+  /**
+   * Filter by cancel_at_next_billing_date (subscriptions scheduled for cancellation)
+   */
+  cancel_at_next_billing_date?: boolean;
+
   /**
    * Get events after this created time
    */

package/src/resources/webhook-events.ts

@@ -37,6 +37,7 @@ export type WebhookEventType =
   | 'subscription.expired'
   | 'subscription.plan_changed'
   | 'subscription.updated'
+  | 'subscription.update_payment_method'
   | 'license_key.created'
   | 'payout.not_initiated'
   | 'payout.on_hold'

package/src/resources/webhooks/index.ts

@@ -43,6 +43,7 @@ export {
   type SubscriptionOnHoldWebhookEvent,
   type SubscriptionPlanChangedWebhookEvent,
   type SubscriptionRenewedWebhookEvent,
+  type SubscriptionUpdatePaymentMethodWebhookEvent,
   type SubscriptionUpdatedWebhookEvent,
   type UnsafeUnwrapWebhookEvent,
   type UnwrapWebhookEvent,

package/src/resources/webhooks/webhooks.ts

@@ -1111,6 +1111,28 @@ export interface SubscriptionRenewedWebhookEvent {
   type: 'subscription.renewed';
 }
 
+export interface SubscriptionUpdatePaymentMethodWebhookEvent {
+  /**
+   * The business identifier
+   */
+  business_id: string;
+
+  /**
+   * Response struct representing subscription details
+   */
+  data: SubscriptionsAPI.Subscription;
+
+  /**
+   * The timestamp of when the event occurred
+   */
+  timestamp: string;
+
+  /**
+   * The event type
+   */
+  type: 'subscription.update_payment_method';
+}
+
 export interface SubscriptionUpdatedWebhookEvent {
   /**
    * The business identifier
@@ -2059,6 +2081,28 @@ export interface SubscriptionRenewedWebhookEvent {
   type: 'subscription.renewed';
 }
 
+export interface SubscriptionUpdatePaymentMethodWebhookEvent {
+  /**
+   * The business identifier
+   */
+  business_id: string;
+
+  /**
+   * Response struct representing subscription details
+   */
+  data: SubscriptionsAPI.Subscription;
+
+  /**
+   * The timestamp of when the event occurred
+   */
+  timestamp: string;
+
+  /**
+   * The event type
+   */
+  type: 'subscription.update_payment_method';
+}
+
 export interface SubscriptionUpdatedWebhookEvent {
   /**
    * The business identifier
@@ -2120,6 +2164,7 @@ export type UnsafeUnwrapWebhookEvent =
   | SubscriptionOnHoldWebhookEvent
   | SubscriptionPlanChangedWebhookEvent
   | SubscriptionRenewedWebhookEvent
+  | SubscriptionUpdatePaymentMethodWebhookEvent
   | SubscriptionUpdatedWebhookEvent;
 
 export type UnwrapWebhookEvent =
@@ -2161,6 +2206,7 @@ export type UnwrapWebhookEvent =
   | SubscriptionOnHoldWebhookEvent
   | SubscriptionPlanChangedWebhookEvent
   | SubscriptionRenewedWebhookEvent
+  | SubscriptionUpdatePaymentMethodWebhookEvent
   | SubscriptionUpdatedWebhookEvent;
 
 export interface WebhookListParams extends CursorPagePaginationParams {}
@@ -2283,6 +2329,7 @@ export declare namespace Webhooks {
     type SubscriptionOnHoldWebhookEvent as SubscriptionOnHoldWebhookEvent,
     type SubscriptionPlanChangedWebhookEvent as SubscriptionPlanChangedWebhookEvent,
     type SubscriptionRenewedWebhookEvent as SubscriptionRenewedWebhookEvent,
+    type SubscriptionUpdatePaymentMethodWebhookEvent as SubscriptionUpdatePaymentMethodWebhookEvent,
     type SubscriptionUpdatedWebhookEvent as SubscriptionUpdatedWebhookEvent,
     type UnsafeUnwrapWebhookEvent as UnsafeUnwrapWebhookEvent,
     type UnwrapWebhookEvent as UnwrapWebhookEvent,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '2.42.1'; // 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.1";
+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.1";
+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.1'; // 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.1'; // x-release-please-version
+export const VERSION = '2.43.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map