dodopayments 2.42.2 → 2.44.0

package/src/resources/payments.ts

@@ -354,7 +354,9 @@ export interface Payment {
   error_code?: string | null;
 
   /**
-   * An error message if the payment failed
+   * An error message if the payment failed. When `error_code` is a recognised
+   * unified code, this is the merchant-facing headline + recommended action (Payment
+   * Details copy) rather than the raw connector text.
    */
   error_message?: string | null;
 
@@ -519,7 +521,6 @@ export type PaymentMethodTypes =
   | 'sepa'
   | 'sepa_bank_transfer'
   | 'sofort'
-  | 'sunbit'
   | 'swish'
   | 'touch_n_go'
   | 'trustly'
@@ -758,6 +759,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/resources/webhook-events.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../core/resource';
 import * as DisputesAPI from './disputes';
 import * as LicenseKeysAPI from './license-keys';
+import * as MiscAPI from './misc';
 import * as PaymentsAPI from './payments';
 import * as RefundsAPI from './refunds';
 import * as SubscriptionsAPI from './subscriptions';
@@ -39,7 +40,7 @@ export type WebhookEventType =
   | 'subscription.updated'
   | 'subscription.update_payment_method'
   | 'license_key.created'
-  | 'payout.not_initiated'
+  | 'payout.created'
   | 'payout.on_hold'
   | 'payout.in_progress'
   | 'payout.failed'
@@ -74,6 +75,7 @@ export interface WebhookPayload {
     | WebhookPayload.Refund
     | WebhookPayload.Dispute
     | WebhookPayload.LicenseKey
+    | WebhookPayload.Payout
     | WebhookPayload.CreditLedgerEntry
     | WebhookPayload.CreditBalanceLow
     | WebhookPayload.AbandonedCheckout
@@ -116,6 +118,88 @@ export namespace WebhookPayload {
     payload_type: 'LicenseKey';
   }
 
+  export interface Payout {
+    /**
+     * The total amount of the payout.
+     */
+    amount: number;
+
+    /**
+     * The unique identifier of the business associated with the payout.
+     */
+    business_id: string;
+
+    /**
+     * @deprecated Use the v3 payout breakup endpoints instead. Will be removed in a
+     * future release.
+     */
+    chargebacks: number;
+
+    /**
+     * The timestamp when the payout was created, in UTC.
+     */
+    created_at: string;
+
+    /**
+     * The currency of the payout, represented as an ISO 4217 currency code.
+     */
+    currency: MiscAPI.Currency;
+
+    /**
+     * The fee charged for processing the payout.
+     */
+    fee: number;
+
+    payload_type: 'Payout';
+
+    /**
+     * The payment method used for the payout (e.g., bank transfer, card, etc.).
+     */
+    payment_method: string;
+
+    /**
+     * The unique identifier of the payout.
+     */
+    payout_id: string;
+
+    /**
+     * @deprecated Use the v3 payout breakup endpoints instead. Will be removed in a
+     * future release.
+     */
+    refunds: number;
+
+    /**
+     * The current status of the payout.
+     */
+    status: 'not_initiated' | 'in_progress' | 'on_hold' | 'failed' | 'success';
+
+    /**
+     * @deprecated Use the v3 payout breakup endpoints instead. Will be removed in a
+     * future release.
+     */
+    tax: number;
+
+    /**
+     * The timestamp when the payout was last updated, in UTC.
+     */
+    updated_at: string;
+
+    /**
+     * The name of the payout recipient or purpose.
+     */
+    name?: string | null;
+
+    /**
+     * The URL of the document associated with the payout.
+     */
+    payout_document_url?: string | null;
+
+    /**
+     * Any additional remarks or notes associated with the payout.
+     */
+    remarks?: string | null;
+  }
+
   /**
    * Response for a ledger entry
    */

package/src/resources/webhooks/index.ts

@@ -34,6 +34,11 @@ export {
   type PaymentFailedWebhookEvent,
   type PaymentProcessingWebhookEvent,
   type PaymentSucceededWebhookEvent,
+  type PayoutCreatedWebhookEvent,
+  type PayoutFailedWebhookEvent,
+  type PayoutInProgressWebhookEvent,
+  type PayoutOnHoldWebhookEvent,
+  type PayoutSuccessWebhookEvent,
   type RefundFailedWebhookEvent,
   type RefundSucceededWebhookEvent,
   type SubscriptionActiveWebhookEvent,