dodopayments 2.35.0 → 2.37.0

package/src/resources/payments.ts

@@ -232,6 +232,13 @@ export interface Payment {
    */
   payment_id: string;
 
+  /**
+   * Which processor handled this payment. `stripe` / `adyen` for BYOP routes (the
+   * merchant's own Hyperswitch connector); `dodo` for everything Dodo processed
+   * itself.
+   */
+  payment_provider: 'stripe' | 'adyen' | 'dodo';
+
   /**
    * List of refunds issued for this payment
    */
@@ -259,8 +266,9 @@ export interface Payment {
   settlement_currency: MiscAPI.Currency;
 
   /**
-   * Total amount charged to the customer including tax, in smallest currency unit
-   * (e.g. cents)
+   * Total amount charged to the customer including tax, in the currency's smallest
+   * unit (e.g. cents for USD, yen for JPY, fils for KWD — see the currency's decimal
+   * places)
    */
   total_amount: number;
 
@@ -374,7 +382,8 @@ export interface Payment {
   subscription_id?: string | null;
 
   /**
-   * Amount of tax collected in smallest currency unit (e.g. cents)
+   * Amount of tax collected in the currency's smallest unit (e.g. cents for USD, yen
+   * for JPY, fils for KWD)
    */
   tax?: number | null;
 
@@ -576,7 +585,8 @@ export interface PaymentCreateResponse {
   payment_id: string;
 
   /**
-   * Total amount of the payment in smallest currency unit (e.g. cents)
+   * Total amount of the payment in the currency's smallest unit (cents for USD, yen
+   * for JPY, fils for KWD)
    */
   total_amount: number;
 
@@ -623,8 +633,25 @@ export interface PaymentListResponse {
 
   payment_id: string;
 
+  /**
+   * Which processor handled this payment. `stripe` / `adyen` for BYOP routes (the
+   * merchant's own Hyperswitch connector); `dodo` for everything Dodo processed
+   * itself.
+   */
+  payment_provider: 'stripe' | 'adyen' | 'dodo';
+
   total_amount: number;
 
+  /**
+   * The last four digits of the card
+   */
+  card_last_four?: string | null;
+
+  /**
+   * Card network like VISA, MASTERCARD etc.
+   */
+  card_network?: string | null;
+
   /**
    * The most recent dispute status for this payment. None if no disputes exist.
    */

package/src/resources/payouts/breakup/breakup.ts

@@ -40,8 +40,8 @@ export namespace BreakupRetrieveResponse {
     event_type: string;
 
     /**
-     * Total amount for this event type in the payout's currency (in smallest currency
-     * unit, e.g., cents).
+     * Total amount for this event type in the payout's currency, in that currency's
+     * smallest unit (cents for USD, yen for JPY, fils for KWD).
      */
     total: number;
   }

package/src/resources/payouts/breakup/details.ts

@@ -68,8 +68,8 @@ export interface DetailListResponse {
   event_type: string;
 
   /**
-   * Original amount in the original currency (in smallest currency unit, e.g.,
-   * cents).
+   * Original amount in the original currency, in that currency's smallest unit
+   * (cents for USD, yen for JPY, fils for KWD).
    */
   original_amount: number;
 
@@ -79,8 +79,9 @@ export interface DetailListResponse {
   original_currency: string;
 
   /**
-   * Amount in the payout's currency (in smallest currency unit). Uses cumulative
-   * rounding to ensure sum matches payout total exactly.
+   * Amount in the payout's currency, in that currency's smallest unit (cents for
+   * USD, yen for JPY, fils for KWD). Uses cumulative rounding to ensure sum matches
+   * payout total exactly.
    */
   payout_currency_amount: number;
 

package/src/resources/products/products.ts

@@ -673,6 +673,12 @@ export interface Product {
    */
   name?: string | null;
 
+  /**
+   * Pricing mode for localized pricing. NULL means base-only (no localized rules
+   * apply).
+   */
+  pricing_mode?: 'by_currency' | 'by_country' | null;
+
   /**
    * The product collection ID this product belongs to, if any
    */
@@ -845,7 +851,7 @@ export interface ProductCreateParams {
   brand_id?: string | null;
 
   /**
-   * Optional credit entitlements to attach (max 3)
+   * Optional credit entitlements to attach (max 5)
    */
   credit_entitlements?: Array<AttachCreditEntitlement> | null;
 
@@ -862,7 +868,7 @@ export interface ProductCreateParams {
   digital_product_delivery?: ProductCreateParams.DigitalProductDelivery | null;
 
   /**
-   * Optional entitlements to attach to this product (max 20)
+   * Optional entitlements to attach to this product (max 50)
    */
   entitlements?: Array<AttachProductEntitlement> | null;
 
@@ -898,6 +904,13 @@ export interface ProductCreateParams {
    * Additional metadata for the product
    */
   metadata?: { [key: string]: string };
+
+  /**
+   * Pricing mode for localized pricing. When set, rules from
+   * /products/{id}/localized-prices apply at checkout. NULL means base-only
+   * (existing behavior).
+   */
+  pricing_mode?: 'by_currency' | 'by_country' | null;
 }
 
 export namespace ProductCreateParams {
@@ -999,6 +1012,13 @@ export interface ProductUpdateParams {
    */
   price?: Price | null;
 
+  /**
+   * Update the pricing mode. Omit to leave unchanged; set to null to clear (which
+   * archives all active localized rules for this product). Changing to a different
+   * non-null mode also archives any rules whose mode doesn't match the new mode.
+   */
+  pricing_mode?: 'by_currency' | 'by_country' | null;
+
   /**
    * Tax category of the product.
    */

package/src/resources/refunds.ts

@@ -34,6 +34,11 @@ export class Refunds extends APIResource {
 }
 
 export interface Refund {
+  /**
+   * Brand id this refund belongs to
+   */
+  brand_id: string;
+
   /**
    * The unique identifier of the business issuing the refund.
    */

package/src/resources/subscriptions.ts

@@ -396,6 +396,11 @@ export interface Subscription {
    */
   billing: PaymentsAPI.BillingAddress;
 
+  /**
+   * Brand id this subscription belongs to
+   */
+  brand_id: string;
+
   /**
    * Indicates if the subscription will cancel at the next billing date
    */
@@ -473,8 +478,8 @@ export interface Subscription {
   quantity: number;
 
   /**
-   * Amount charged before tax for each recurring payment in smallest currency unit
-   * (e.g. cents)
+   * Amount charged before tax for each recurring payment in the currency's smallest
+   * unit (cents for USD, yen for JPY, fils for KWD)
    */
   recurring_pre_tax_amount: number;
 
@@ -793,8 +798,8 @@ export interface SubscriptionListResponse {
   quantity: number;
 
   /**
-   * Amount charged before tax for each recurring payment in smallest currency unit
-   * (e.g. cents)
+   * Amount charged before tax for each recurring payment in the currency's smallest
+   * unit (cents for USD, yen for JPY, fils for KWD)
    */
   recurring_pre_tax_amount: number;
 
@@ -1001,6 +1006,13 @@ export namespace SubscriptionPreviewChangePlanResponse {
     export interface Summary {
       currency: MiscAPI.Currency;
 
+      /**
+       * Net credit movement in the smallest currency unit (e.g. cents). **Negative** –
+       * credits were deducted from the customer's balance to offset the charge (typical
+       * on upgrades). **Positive** – credits were added to the customer's balance,
+       * either from a downgrade proration refund or from topping-up the wallet to meet a
+       * gateway minimum-charge threshold. **Zero** – no credit movement occurred.
+       */
       customer_credits: number;
 
       settlement_amount: number;
@@ -1130,7 +1142,8 @@ export namespace SubscriptionRetrieveUsageHistoryResponse {
     price_per_unit: string;
 
     /**
-     * Total price charged for this meter in smallest currency unit (cents)
+     * Total price charged for this meter in the currency's smallest unit (cents for
+     * USD, yen for JPY, fils for KWD)
      */
     total_price: number;
   }
@@ -1553,6 +1566,16 @@ export namespace SubscriptionUpdatePaymentMethodParams {
   export interface New {
     type: 'new';
 
+    /**
+     * List of payment methods allowed during checkout.
+     *
+     * Customers will **never** see payment methods that are **not** in this list.
+     * However, adding a method here **does not guarantee** customers will see it.
+     * Availability still depends on other factors (e.g., customer location, merchant
+     * settings).
+     */
+    allowed_payment_method_types?: Array<PaymentsAPI.PaymentMethodTypes> | null;
+
     return_url?: string | null;
   }
 

package/src/resources/webhook-events.ts

@@ -125,6 +125,11 @@ export namespace WebhookPayload {
   export interface CreditBalanceLow {
     available_balance: string;
 
+    /**
+     * Brand id this credit entitlement belongs to
+     */
+    brand_id: string;
+
     credit_entitlement_id: string;
 
     credit_entitlement_name: string;
@@ -147,6 +152,11 @@ export namespace WebhookPayload {
 
     abandonment_reason: 'payment_failed' | 'checkout_incomplete';
 
+    /**
+     * Brand id this abandoned checkout belongs to
+     */
+    brand_id: string;
+
     customer_id: string;
 
     payload_type: 'AbandonedCheckout';
@@ -159,6 +169,11 @@ export namespace WebhookPayload {
   }
 
   export interface DunningAttempt {
+    /**
+     * Brand id this dunning attempt belongs to
+     */
+    brand_id: string;
+
     created_at: string;
 
     customer_id: string;

package/src/resources/webhooks/webhooks.ts

@@ -177,6 +177,11 @@ export namespace AbandonedCheckoutDetectedWebhookEvent {
 
     abandonment_reason: 'payment_failed' | 'checkout_incomplete';
 
+    /**
+     * Brand id this abandoned checkout belongs to
+     */
+    brand_id: string;
+
     customer_id: string;
 
     payment_id: string;
@@ -220,6 +225,11 @@ export namespace AbandonedCheckoutRecoveredWebhookEvent {
 
     abandonment_reason: 'payment_failed' | 'checkout_incomplete';
 
+    /**
+     * Brand id this abandoned checkout belongs to
+     */
+    brand_id: string;
+
     customer_id: string;
 
     payment_id: string;
@@ -281,6 +291,11 @@ export namespace CreditBalanceLowWebhookEvent {
   export interface Data {
     available_balance: string;
 
+    /**
+     * Brand id this credit entitlement belongs to
+     */
+    brand_id: string;
+
     credit_entitlement_id: string;
 
     credit_entitlement_name: string;
@@ -611,6 +626,11 @@ export namespace DunningRecoveredWebhookEvent {
    * Webhook payload for dunning.started and dunning.recovered events
    */
   export interface Data {
+    /**
+     * Brand id this dunning attempt belongs to
+     */
+    brand_id: string;
+
     created_at: string;
 
     customer_id: string;
@@ -652,6 +672,11 @@ export namespace DunningStartedWebhookEvent {
    * Webhook payload for dunning.started and dunning.recovered events
    */
   export interface Data {
+    /**
+     * Brand id this dunning attempt belongs to
+     */
+    brand_id: string;
+
     created_at: string;
 
     customer_id: string;
@@ -1100,6 +1125,11 @@ export namespace AbandonedCheckoutDetectedWebhookEvent {
 
     abandonment_reason: 'payment_failed' | 'checkout_incomplete';
 
+    /**
+     * Brand id this abandoned checkout belongs to
+     */
+    brand_id: string;
+
     customer_id: string;
 
     payment_id: string;
@@ -1143,6 +1173,11 @@ export namespace AbandonedCheckoutRecoveredWebhookEvent {
 
     abandonment_reason: 'payment_failed' | 'checkout_incomplete';
 
+    /**
+     * Brand id this abandoned checkout belongs to
+     */
+    brand_id: string;
+
     customer_id: string;
 
     payment_id: string;
@@ -1204,6 +1239,11 @@ export namespace CreditBalanceLowWebhookEvent {
   export interface Data {
     available_balance: string;
 
+    /**
+     * Brand id this credit entitlement belongs to
+     */
+    brand_id: string;
+
     credit_entitlement_id: string;
 
     credit_entitlement_name: string;
@@ -1534,6 +1574,11 @@ export namespace DunningRecoveredWebhookEvent {
    * Webhook payload for dunning.started and dunning.recovered events
    */
   export interface Data {
+    /**
+     * Brand id this dunning attempt belongs to
+     */
+    brand_id: string;
+
     created_at: string;
 
     customer_id: string;
@@ -1575,6 +1620,11 @@ export namespace DunningStartedWebhookEvent {
    * Webhook payload for dunning.started and dunning.recovered events
    */
   export interface Data {
+    /**
+     * Brand id this dunning attempt belongs to
+     */
+    brand_id: string;
+
     created_at: string;
 
     customer_id: string;

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '2.35.0'; // x-release-please-version
+export const VERSION = '2.37.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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