dodopayments 2.48.0 → 2.49.0

package/src/resources/blocklist/index.ts

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Blocklist } from './blocklist';
+export {
+  Customers,
+  type BlockByCustomerID,
+  type BlockByEmail,
+  type BlockIdentifier,
+  type BlockedCustomer,
+  type BlockedCustomerSource,
+  type CreateBlockedCustomerRequest,
+  type CustomerListParams,
+  type CustomerCreateParams,
+  type BlockedCustomersDefaultPageNumberPagination,
+} from './customers/index';

package/src/resources/blocklist.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './blocklist/index';

package/src/resources/customers/customers.ts

@@ -192,6 +192,18 @@ export interface Customer {
 
   name: string;
 
+  /**
+   * When the merchant blocked this customer. The dashboard shows the "Blocked" badge
+   * and the unblock action from it. The list route leaves it empty; only the
+   * single-customer route resolves it.
+   */
+  blocked_at?: string | null;
+
+  /**
+   * Blocklist entry behind `blocked_at`, so the dashboard can link to it.
+   */
+  blocklist_entry_id?: string | null;
+
   /**
    * Additional metadata for the customer
    */

package/src/resources/index.ts

@@ -15,6 +15,7 @@ export {
   type BalanceRetrieveLedgerParams,
   type BalanceLedgerEntriesDefaultPageNumberPagination,
 } from './balances';
+export { Blocklist } from './blocklist/blocklist';
 export {
   Brands,
   type Brand,
@@ -154,6 +155,8 @@ export {
   type CustomerLimitedDetails,
   type CustomerRequest,
   type IntentStatus,
+  type ManualRetry,
+  type ManualRetryState,
   type NewCustomer,
   type OneTimeProductCartItem,
   type Payment,
@@ -302,6 +305,7 @@ export {
   type SubscriptionExpiredWebhookEvent,
   type SubscriptionFailedWebhookEvent,
   type SubscriptionOnHoldWebhookEvent,
+  type SubscriptionPastDueWebhookEvent,
   type SubscriptionPausedWebhookEvent,
   type SubscriptionPlanChangedWebhookEvent,
   type SubscriptionRenewedWebhookEvent,

package/src/resources/payments.ts

@@ -67,6 +67,29 @@ export class Payments extends APIResource {
   ): APIPromise<PaymentRetrieveLineItemsResponse> {
     return this._client.get(path`/payments/${paymentID}/line-items`, options);
   }
+
+  /**
+   * @example
+   * ```ts
+   * const manualRetry = await client.payments.retry(
+   *   'payment_id',
+   * );
+   * ```
+   */
+  retry(paymentID: string, options?: RequestOptions): APIPromise<ManualRetry> {
+    return this._client.post(path`/payments/${paymentID}/retry`, options);
+  }
+
+  /**
+   * @example
+   * ```ts
+   * const manualRetryState =
+   *   await client.payments.retrieveRetryState('payment_id');
+   * ```
+   */
+  retrieveRetryState(paymentID: string, options?: RequestOptions): APIPromise<ManualRetryState> {
+    return this._client.get(path`/payments/${paymentID}/retry`, options);
+  }
 }
 
 export type PaymentListResponsesDefaultPageNumberPagination =
@@ -177,6 +200,65 @@ export type IntentStatus =
   | 'partially_captured'
   | 'partially_captured_and_capturable';
 
+export interface ManualRetry {
+  /**
+   * The invoice the send charged.
+   */
+  invoice_id: string;
+
+  /**
+   * Always true on this route. Tells the row apart from an automatic attempt.
+   */
+  is_manual_retry: boolean;
+
+  /**
+   * The payment row this send created.
+   */
+  payment_id: string;
+
+  /**
+   * Which attempt this send is, counting manual sends on the invoice.
+   */
+  retry_attempt: number;
+
+  sends_allowed: number;
+
+  /**
+   * Manual sends spent on this invoice, including this one.
+   */
+  sends_used: number;
+
+  /**
+   * When the next send becomes available. Null when no send is left.
+   */
+  retry_available_at?: string | null;
+
+  /**
+   * Outcome of the charge. `processing` means the processor has not settled it yet,
+   * and the payment webhooks report the result.
+   */
+  status?: IntentStatus | null;
+}
+
+export interface ManualRetryState {
+  can_retry: boolean;
+
+  sends_allowed: number;
+
+  sends_used: number;
+
+  /**
+   * The code `POST` would fail with. Null when `can_retry` is true.
+   */
+  reason?: string | null;
+
+  /**
+   * When the next send becomes available. Null when no send is left, or when the
+   * block has nothing to do with the cooldown.
+   */
+  retry_available_at?: string | null;
+}
+
 export interface NewCustomer {
   /**
    * Email is required for creating a new customer
@@ -1065,6 +1147,8 @@ export declare namespace Payments {
     type CustomerLimitedDetails as CustomerLimitedDetails,
     type CustomerRequest as CustomerRequest,
     type IntentStatus as IntentStatus,
+    type ManualRetry as ManualRetry,
+    type ManualRetryState as ManualRetryState,
     type NewCustomer as NewCustomer,
     type OneTimeProductCartItem as OneTimeProductCartItem,
     type Payment as Payment,

package/src/resources/subscriptions.ts

@@ -695,7 +695,8 @@ export type SubscriptionStatus =
   | 'paused'
   | 'cancelled'
   | 'failed'
-  | 'expired';
+  | 'expired'
+  | 'past_due';
 
 /**
  * Unit of a duration count (e.g. license-key validity period).
@@ -1392,7 +1393,7 @@ export interface SubscriptionListParams extends DefaultPageNumberPaginationParam
   /**
    * Filter by status
    */
-  status?: 'pending' | 'active' | 'on_hold' | 'paused' | 'cancelled' | 'failed' | 'expired';
+  status?: 'pending' | 'active' | 'on_hold' | 'paused' | 'cancelled' | 'failed' | 'expired' | 'past_due';
 }
 
 export interface SubscriptionCreateParams {
@@ -1548,6 +1549,7 @@ export interface SubscriptionUpdateParams {
     | 'cancelled_by_customer'
     | 'cancelled_by_merchant'
     | 'cancelled_by_merchant_send_dunning'
+    | 'cancelled_by_merchant_grace_period_expired'
     | 'dodo_team'
     | null;
 

package/src/resources/webhook-events.ts

@@ -32,6 +32,7 @@ export type WebhookEventType =
   | 'subscription.active'
   | 'subscription.renewed'
   | 'subscription.on_hold'
+  | 'subscription.past_due'
   | 'subscription.paused'
   | 'subscription.unpaused'
   | 'subscription.cancelled'
@@ -105,6 +106,17 @@ export namespace WebhookPayload {
    */
   export interface Subscription extends SubscriptionsAPI.Subscription {
     payload_type: 'Subscription';
+
+    /**
+     * Time when the grace period ends. The subscription moves to `on_hold` or to
+     * `cancelled` at this time.
+     *
+     * Read in the same query as the rest of the payload, so it always comes from the
+     * row snapshot that produced `status`. It is set whenever the subscription sits in
+     * a window at that moment. A delayed event of another type therefore carries the
+     * deadline too, next to a `past_due` status.
+     */
+    past_due_ends_at?: string | null;
   }
 
   export interface Refund extends RefundsAPI.Refund {
@@ -270,7 +282,7 @@ export namespace WebhookPayload {
 
     subscription_id: string;
 
-    trigger_state: 'on_hold' | 'cancelled';
+    trigger_state: 'on_hold' | 'cancelled' | 'past_due';
 
     payment_id?: string | null;
   }

package/src/resources/webhooks/index.ts

@@ -46,6 +46,7 @@ export {
   type SubscriptionExpiredWebhookEvent,
   type SubscriptionFailedWebhookEvent,
   type SubscriptionOnHoldWebhookEvent,
+  type SubscriptionPastDueWebhookEvent,
   type SubscriptionPausedWebhookEvent,
   type SubscriptionPlanChangedWebhookEvent,
   type SubscriptionRenewedWebhookEvent,