@augustusbank/typescript-sdk 0.21.0 → 0.22.1

package/src/resources/webhooks.ts

@@ -18,7 +18,7 @@ export class Webhooks extends APIResource {
   }
 }
 
-export interface PayoutCreatedWebhookEvent {
+export interface PayoutInitiatedWebhookEvent {
   /**
    * Unique identifier for the event. Stable across retries.
    */
@@ -37,15 +37,15 @@ export interface PayoutCreatedWebhookEvent {
   /**
    * Full resource snapshot at the time of the event.
    */
-  payload: PayoutCreatedWebhookEvent.Payload;
+  payload: PayoutInitiatedWebhookEvent.Payload;
 
   /**
    * Event type in resource.action format.
    */
-  type: 'payout.created';
+  type: 'payout.initiated';
 }
 
-export namespace PayoutCreatedWebhookEvent {
+export namespace PayoutInitiatedWebhookEvent {
   /**
    * Full resource snapshot at the time of the event.
    */
@@ -55,34 +55,35 @@ export namespace PayoutCreatedWebhookEvent {
      */
     id: string;
 
+    /**
+     * ID of the account that was debited.
+     */
+    account_id: string;
+
     /**
      * Amount as a string decimal (e.g. "100.50").
      */
     amount: string;
 
     /**
-     * ISO 8601 UTC timestamp when the payout was created.
+     * ID of the counterparty that receives the money.
      */
-    created_at: string;
+    counterparty_id: string;
 
     /**
-     * Currency code (ISO 4217 currency code or crypto currency code).
+     * Currency code (ISO 4217 or crypto).
      */
     currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
     /**
-     * Bank account or crypto wallet the payout was sent to.
+     * Failure details when status is failed, otherwise null.
      */
-    destination:
-      | Payload.IbanFinancialAddress
-      | Payload.SortCodeFinancialAddress
-      | Payload.AbaFinancialAddress
-      | Payload.CryptoWalletFinancialAddress;
+    failure: Payload.Failure | null;
 
     /**
-     * Failure details when status is failed, otherwise null.
+     * ISO 8601 UTC timestamp when the payout was initiated.
      */
-    failure: Payload.Failure | null;
+    initiated_at: string;
 
     /**
      * Key-value pairs stored with the payout.
@@ -90,19 +91,48 @@ export namespace PayoutCreatedWebhookEvent {
     metadata: { [key: string]: string };
 
     /**
-     * Payment reference.
+     * Payment scheme or blockchain used for the payout, or null when unknown.
      */
-    reference: string;
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
 
     /**
-     * ID of the account that was debited.
+     * ISO 8601 UTC timestamp when the payout was sent.
      */
-    source_account_id: string;
+    sent_at: string | null;
 
     /**
      * Current status of the payout.
      */
-    status: 'pending' | 'paid' | 'failed' | 'returned';
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
+
+    /**
+     * Reference used to track the payment across the payment network, such as the UETR
+     * for SWIFT payments.
+     */
+    tracking_reference: string | null;
+
+    /**
+     * Transaction hash for crypto payouts, or null when not known. Only blockchain
+     * rails support this field.
+     */
+    tx_hash: string | null;
 
     /**
      * Resource type discriminator.
@@ -110,103 +140,13 @@ export namespace PayoutCreatedWebhookEvent {
     type: 'payout';
 
     /**
-     * ISO 8601 UTC timestamp when the payout was last updated.
+     * Unstructured remittance information attached to the transfer. Not all rails
+     * support this field.
      */
-    updated_at: string;
+    unstructured_remittance_information: string | null;
   }
 
   export namespace Payload {
-    export interface IbanFinancialAddress {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank Identifier Code, or null if not provided.
-       */
-      bic: string | null;
-
-      /**
-       * International Bank Account Number.
-       */
-      iban: string;
-
-      /**
-       * Discriminator for IBAN financial address.
-       */
-      type: 'iban';
-    }
-
-    export interface SortCodeFinancialAddress {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * UK account number (8 digits).
-       */
-      account_number: string;
-
-      /**
-       * UK sort code (6 digits).
-       */
-      sort_code: string;
-
-      /**
-       * Discriminator for UK sort code financial address.
-       */
-      type: 'sort_code';
-    }
-
-    export interface AbaFinancialAddress {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank account number.
-       */
-      account_number: string;
-
-      /**
-       * ABA routing number (9 digits).
-       */
-      routing_number: string;
-
-      /**
-       * Discriminator for ABA wire financial address.
-       */
-      type: 'aba';
-    }
-
-    export interface CryptoWalletFinancialAddress {
-      /**
-       * Wallet address on the specified blockchain.
-       */
-      address: string;
-
-      /**
-       * Blockchain network for the crypto wallet.
-       */
-      blockchain:
-        | 'bitcoin'
-        | 'ethereum'
-        | 'solana'
-        | 'polygon'
-        | 'bitcoin_testnet4'
-        | 'ethereum_sepolia'
-        | 'solana_devnet'
-        | 'polygon_amoy';
-
-      /**
-       * Discriminator for crypto wallet financial address.
-       */
-      type: 'crypto_wallet';
-    }
-
     /**
      * Failure details when status is failed, otherwise null.
      */
@@ -219,6 +159,7 @@ export namespace PayoutCreatedWebhookEvent {
         | 'account_blocked'
         | 'insufficient_funds'
         | 'invalid_account_format'
+        | 'invalid_routing_number'
         | 'invalid_instruction'
         | 'invalid_amount'
         | 'invalid_time'
@@ -243,7 +184,7 @@ export namespace PayoutCreatedWebhookEvent {
   }
 }
 
-export interface PayoutInitiatedWebhookEvent {
+export interface PayoutSubmittedWebhookEvent {
   /**
    * Unique identifier for the event. Stable across retries.
    */
@@ -262,15 +203,15 @@ export interface PayoutInitiatedWebhookEvent {
   /**
    * Full resource snapshot at the time of the event.
    */
-  payload: PayoutInitiatedWebhookEvent.Payload;
+  payload: PayoutSubmittedWebhookEvent.Payload;
 
   /**
    * Event type in resource.action format.
    */
-  type: 'payout.initiated';
+  type: 'payout.submitted';
 }
 
-export namespace PayoutInitiatedWebhookEvent {
+export namespace PayoutSubmittedWebhookEvent {
   /**
    * Full resource snapshot at the time of the event.
    */
@@ -280,34 +221,35 @@ export namespace PayoutInitiatedWebhookEvent {
      */
     id: string;
 
+    /**
+     * ID of the account that was debited.
+     */
+    account_id: string;
+
     /**
      * Amount as a string decimal (e.g. "100.50").
      */
     amount: string;
 
     /**
-     * ISO 8601 UTC timestamp when the payout was created.
+     * ID of the counterparty that receives the money.
      */
-    created_at: string;
+    counterparty_id: string;
 
     /**
-     * Currency code (ISO 4217 currency code or crypto currency code).
+     * Currency code (ISO 4217 or crypto).
      */
     currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
     /**
-     * Bank account or crypto wallet the payout was sent to.
+     * Failure details when status is failed, otherwise null.
      */
-    destination:
-      | Payload.IbanFinancialAddress
-      | Payload.SortCodeFinancialAddress
-      | Payload.AbaFinancialAddress
-      | Payload.CryptoWalletFinancialAddress;
+    failure: Payload.Failure | null;
 
     /**
-     * Failure details when status is failed, otherwise null.
+     * ISO 8601 UTC timestamp when the payout was initiated.
      */
-    failure: Payload.Failure | null;
+    initiated_at: string;
 
     /**
      * Key-value pairs stored with the payout.
@@ -315,19 +257,48 @@ export namespace PayoutInitiatedWebhookEvent {
     metadata: { [key: string]: string };
 
     /**
-     * Payment reference.
+     * Payment scheme or blockchain used for the payout, or null when unknown.
      */
-    reference: string;
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
 
     /**
-     * ID of the account that was debited.
+     * ISO 8601 UTC timestamp when the payout was sent.
      */
-    source_account_id: string;
+    sent_at: string | null;
 
     /**
      * Current status of the payout.
      */
-    status: 'pending' | 'paid' | 'failed' | 'returned';
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
+
+    /**
+     * Reference used to track the payment across the payment network, such as the UETR
+     * for SWIFT payments.
+     */
+    tracking_reference: string | null;
+
+    /**
+     * Transaction hash for crypto payouts, or null when not known. Only blockchain
+     * rails support this field.
+     */
+    tx_hash: string | null;
 
     /**
      * Resource type discriminator.
@@ -335,103 +306,13 @@ export namespace PayoutInitiatedWebhookEvent {
     type: 'payout';
 
     /**
-     * ISO 8601 UTC timestamp when the payout was last updated.
+     * Unstructured remittance information attached to the transfer. Not all rails
+     * support this field.
      */
-    updated_at: string;
+    unstructured_remittance_information: string | null;
   }
 
   export namespace Payload {
-    export interface IbanFinancialAddress {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank Identifier Code, or null if not provided.
-       */
-      bic: string | null;
-
-      /**
-       * International Bank Account Number.
-       */
-      iban: string;
-
-      /**
-       * Discriminator for IBAN financial address.
-       */
-      type: 'iban';
-    }
-
-    export interface SortCodeFinancialAddress {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * UK account number (8 digits).
-       */
-      account_number: string;
-
-      /**
-       * UK sort code (6 digits).
-       */
-      sort_code: string;
-
-      /**
-       * Discriminator for UK sort code financial address.
-       */
-      type: 'sort_code';
-    }
-
-    export interface AbaFinancialAddress {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank account number.
-       */
-      account_number: string;
-
-      /**
-       * ABA routing number (9 digits).
-       */
-      routing_number: string;
-
-      /**
-       * Discriminator for ABA wire financial address.
-       */
-      type: 'aba';
-    }
-
-    export interface CryptoWalletFinancialAddress {
-      /**
-       * Wallet address on the specified blockchain.
-       */
-      address: string;
-
-      /**
-       * Blockchain network for the crypto wallet.
-       */
-      blockchain:
-        | 'bitcoin'
-        | 'ethereum'
-        | 'solana'
-        | 'polygon'
-        | 'bitcoin_testnet4'
-        | 'ethereum_sepolia'
-        | 'solana_devnet'
-        | 'polygon_amoy';
-
-      /**
-       * Discriminator for crypto wallet financial address.
-       */
-      type: 'crypto_wallet';
-    }
-
     /**
      * Failure details when status is failed, otherwise null.
      */
@@ -444,6 +325,7 @@ export namespace PayoutInitiatedWebhookEvent {
         | 'account_blocked'
         | 'insufficient_funds'
         | 'invalid_account_format'
+        | 'invalid_routing_number'
         | 'invalid_instruction'
         | 'invalid_amount'
         | 'invalid_time'
@@ -468,7 +350,7 @@ export namespace PayoutInitiatedWebhookEvent {
   }
 }
 
-export interface PayoutPaidWebhookEvent {
+export interface PayoutSentWebhookEvent {
   /**
    * Unique identifier for the event. Stable across retries.
    */
@@ -487,15 +369,15 @@ export interface PayoutPaidWebhookEvent {
   /**
    * Full resource snapshot at the time of the event.
    */
-  payload: PayoutPaidWebhookEvent.Payload;
+  payload: PayoutSentWebhookEvent.Payload;
 
   /**
    * Event type in resource.action format.
    */
-  type: 'payout.paid';
+  type: 'payout.sent';
 }
 
-export namespace PayoutPaidWebhookEvent {
+export namespace PayoutSentWebhookEvent {
   /**
    * Full resource snapshot at the time of the event.
    */
@@ -505,34 +387,35 @@ export namespace PayoutPaidWebhookEvent {
      */
     id: string;
 
+    /**
+     * ID of the account that was debited.
+     */
+    account_id: string;
+
     /**
      * Amount as a string decimal (e.g. "100.50").
      */
     amount: string;
 
     /**
-     * ISO 8601 UTC timestamp when the payout was created.
+     * ID of the counterparty that receives the money.
      */
-    created_at: string;
+    counterparty_id: string;
 
     /**
-     * Currency code (ISO 4217 currency code or crypto currency code).
+     * Currency code (ISO 4217 or crypto).
      */
     currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
     /**
-     * Bank account or crypto wallet the payout was sent to.
+     * Failure details when status is failed, otherwise null.
      */
-    destination:
-      | Payload.IbanFinancialAddress
-      | Payload.SortCodeFinancialAddress
-      | Payload.AbaFinancialAddress
-      | Payload.CryptoWalletFinancialAddress;
+    failure: Payload.Failure | null;
 
     /**
-     * Failure details when status is failed, otherwise null.
+     * ISO 8601 UTC timestamp when the payout was initiated.
      */
-    failure: Payload.Failure | null;
+    initiated_at: string;
 
     /**
      * Key-value pairs stored with the payout.
@@ -540,19 +423,48 @@ export namespace PayoutPaidWebhookEvent {
     metadata: { [key: string]: string };
 
     /**
-     * Payment reference.
+     * Payment scheme or blockchain used for the payout, or null when unknown.
      */
-    reference: string;
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
 
     /**
-     * ID of the account that was debited.
+     * ISO 8601 UTC timestamp when the payout was sent.
      */
-    source_account_id: string;
+    sent_at: string | null;
 
     /**
      * Current status of the payout.
      */
-    status: 'pending' | 'paid' | 'failed' | 'returned';
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
+
+    /**
+     * Reference used to track the payment across the payment network, such as the UETR
+     * for SWIFT payments.
+     */
+    tracking_reference: string | null;
+
+    /**
+     * Transaction hash for crypto payouts, or null when not known. Only blockchain
+     * rails support this field.
+     */
+    tx_hash: string | null;
 
     /**
      * Resource type discriminator.
@@ -560,103 +472,13 @@ export namespace PayoutPaidWebhookEvent {
     type: 'payout';
 
     /**
-     * ISO 8601 UTC timestamp when the payout was last updated.
+     * Unstructured remittance information attached to the transfer. Not all rails
+     * support this field.
      */
-    updated_at: string;
+    unstructured_remittance_information: string | null;
   }
 
   export namespace Payload {
-    export interface IbanFinancialAddress {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank Identifier Code, or null if not provided.
-       */
-      bic: string | null;
-
-      /**
-       * International Bank Account Number.
-       */
-      iban: string;
-
-      /**
-       * Discriminator for IBAN financial address.
-       */
-      type: 'iban';
-    }
-
-    export interface SortCodeFinancialAddress {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * UK account number (8 digits).
-       */
-      account_number: string;
-
-      /**
-       * UK sort code (6 digits).
-       */
-      sort_code: string;
-
-      /**
-       * Discriminator for UK sort code financial address.
-       */
-      type: 'sort_code';
-    }
-
-    export interface AbaFinancialAddress {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank account number.
-       */
-      account_number: string;
-
-      /**
-       * ABA routing number (9 digits).
-       */
-      routing_number: string;
-
-      /**
-       * Discriminator for ABA wire financial address.
-       */
-      type: 'aba';
-    }
-
-    export interface CryptoWalletFinancialAddress {
-      /**
-       * Wallet address on the specified blockchain.
-       */
-      address: string;
-
-      /**
-       * Blockchain network for the crypto wallet.
-       */
-      blockchain:
-        | 'bitcoin'
-        | 'ethereum'
-        | 'solana'
-        | 'polygon'
-        | 'bitcoin_testnet4'
-        | 'ethereum_sepolia'
-        | 'solana_devnet'
-        | 'polygon_amoy';
-
-      /**
-       * Discriminator for crypto wallet financial address.
-       */
-      type: 'crypto_wallet';
-    }
-
     /**
      * Failure details when status is failed, otherwise null.
      */
@@ -669,6 +491,7 @@ export namespace PayoutPaidWebhookEvent {
         | 'account_blocked'
         | 'insufficient_funds'
         | 'invalid_account_format'
+        | 'invalid_routing_number'
         | 'invalid_instruction'
         | 'invalid_amount'
         | 'invalid_time'
@@ -731,28 +554,24 @@ export namespace PayoutFailedWebhookEvent {
     id: string;
 
     /**
-     * Amount as a string decimal (e.g. "100.50").
+     * ID of the account that was debited.
      */
-    amount: string;
+    account_id: string;
 
     /**
-     * ISO 8601 UTC timestamp when the payout was created.
+     * Amount as a string decimal (e.g. "100.50").
      */
-    created_at: string;
+    amount: string;
 
     /**
-     * Currency code (ISO 4217 currency code or crypto currency code).
+     * ID of the counterparty that receives the money.
      */
-    currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
+    counterparty_id: string;
 
     /**
-     * Bank account or crypto wallet the payout was sent to.
+     * Currency code (ISO 4217 or crypto).
      */
-    destination:
-      | Payload.IbanFinancialAddress
-      | Payload.SortCodeFinancialAddress
-      | Payload.AbaFinancialAddress
-      | Payload.CryptoWalletFinancialAddress;
+    currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
     /**
      * Failure details when status is failed, otherwise null.
@@ -760,24 +579,58 @@ export namespace PayoutFailedWebhookEvent {
     failure: Payload.Failure | null;
 
     /**
-     * Key-value pairs stored with the payout.
-     */
-    metadata: { [key: string]: string };
-
-    /**
-     * Payment reference.
+     * ISO 8601 UTC timestamp when the payout was initiated.
      */
-    reference: string;
+    initiated_at: string;
 
     /**
-     * ID of the account that was debited.
+     * Key-value pairs stored with the payout.
      */
-    source_account_id: string;
+    metadata: { [key: string]: string };
 
     /**
-     * Current status of the payout.
+     * Payment scheme or blockchain used for the payout, or null when unknown.
      */
-    status: 'pending' | 'paid' | 'failed' | 'returned';
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
+
+    /**
+     * ISO 8601 UTC timestamp when the payout was sent.
+     */
+    sent_at: string | null;
+
+    /**
+     * Current status of the payout.
+     */
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
+
+    /**
+     * Reference used to track the payment across the payment network, such as the UETR
+     * for SWIFT payments.
+     */
+    tracking_reference: string | null;
+
+    /**
+     * Transaction hash for crypto payouts, or null when not known. Only blockchain
+     * rails support this field.
+     */
+    tx_hash: string | null;
 
     /**
      * Resource type discriminator.
@@ -785,103 +638,179 @@ export namespace PayoutFailedWebhookEvent {
     type: 'payout';
 
     /**
-     * ISO 8601 UTC timestamp when the payout was last updated.
+     * Unstructured remittance information attached to the transfer. Not all rails
+     * support this field.
      */
-    updated_at: string;
+    unstructured_remittance_information: string | null;
   }
 
   export namespace Payload {
-    export interface IbanFinancialAddress {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
+    /**
+     * Failure details when status is failed, otherwise null.
+     */
+    export interface Failure {
       /**
-       * Bank Identifier Code, or null if not provided.
+       * Failure code.
        */
-      bic: string | null;
+      code:
+        | 'account_closed'
+        | 'account_blocked'
+        | 'insufficient_funds'
+        | 'invalid_account_format'
+        | 'invalid_routing_number'
+        | 'invalid_instruction'
+        | 'invalid_amount'
+        | 'invalid_time'
+        | 'duplicate_transaction'
+        | 'payee_verification_failed'
+        | 'system_error'
+        | 'provider_system_error'
+        | 'rejected_by_correspondent_bank'
+        | 'blocked_by_review'
+        | 'unknown';
 
       /**
-       * International Bank Account Number.
+       * Human-readable description of the failure.
        */
-      iban: string;
+      message: string;
 
       /**
-       * Discriminator for IBAN financial address.
+       * Whether the payout can be retried.
        */
-      type: 'iban';
+      retry: boolean;
     }
+  }
+}
 
-    export interface SortCodeFinancialAddress {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
+export interface PayoutReturnedWebhookEvent {
+  /**
+   * Unique identifier for the event. Stable across retries.
+   */
+  id: string;
 
-      /**
-       * UK account number (8 digits).
-       */
-      account_number: string;
+  /**
+   * API version the payload was rendered at. Stable across retries and redeliveries.
+   */
+  api_version: string;
 
-      /**
-       * UK sort code (6 digits).
-       */
-      sort_code: string;
+  /**
+   * ISO 8601 UTC timestamp when the event was created.
+   */
+  date: string;
 
-      /**
-       * Discriminator for UK sort code financial address.
-       */
-      type: 'sort_code';
-    }
+  /**
+   * Full resource snapshot at the time of the event.
+   */
+  payload: PayoutReturnedWebhookEvent.Payload;
 
-    export interface AbaFinancialAddress {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
+  /**
+   * Event type in resource.action format.
+   */
+  type: 'payout.returned';
+}
 
-      /**
-       * Bank account number.
-       */
-      account_number: string;
+export namespace PayoutReturnedWebhookEvent {
+  /**
+   * Full resource snapshot at the time of the event.
+   */
+  export interface Payload {
+    /**
+     * Unique identifier of the payout.
+     */
+    id: string;
 
-      /**
-       * ABA routing number (9 digits).
-       */
-      routing_number: string;
+    /**
+     * ID of the account that was debited.
+     */
+    account_id: string;
 
-      /**
-       * Discriminator for ABA wire financial address.
-       */
-      type: 'aba';
-    }
+    /**
+     * Amount as a string decimal (e.g. "100.50").
+     */
+    amount: string;
 
-    export interface CryptoWalletFinancialAddress {
-      /**
-       * Wallet address on the specified blockchain.
-       */
-      address: string;
+    /**
+     * ID of the counterparty that receives the money.
+     */
+    counterparty_id: string;
 
-      /**
-       * Blockchain network for the crypto wallet.
-       */
-      blockchain:
-        | 'bitcoin'
-        | 'ethereum'
-        | 'solana'
-        | 'polygon'
-        | 'bitcoin_testnet4'
-        | 'ethereum_sepolia'
-        | 'solana_devnet'
-        | 'polygon_amoy';
+    /**
+     * Currency code (ISO 4217 or crypto).
+     */
+    currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
-      /**
-       * Discriminator for crypto wallet financial address.
-       */
-      type: 'crypto_wallet';
-    }
+    /**
+     * Failure details when status is failed, otherwise null.
+     */
+    failure: Payload.Failure | null;
+
+    /**
+     * ISO 8601 UTC timestamp when the payout was initiated.
+     */
+    initiated_at: string;
+
+    /**
+     * Key-value pairs stored with the payout.
+     */
+    metadata: { [key: string]: string };
+
+    /**
+     * Payment scheme or blockchain used for the payout, or null when unknown.
+     */
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
 
+    /**
+     * ISO 8601 UTC timestamp when the payout was sent.
+     */
+    sent_at: string | null;
+
+    /**
+     * Current status of the payout.
+     */
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
+
+    /**
+     * Reference used to track the payment across the payment network, such as the UETR
+     * for SWIFT payments.
+     */
+    tracking_reference: string | null;
+
+    /**
+     * Transaction hash for crypto payouts, or null when not known. Only blockchain
+     * rails support this field.
+     */
+    tx_hash: string | null;
+
+    /**
+     * Resource type discriminator.
+     */
+    type: 'payout';
+
+    /**
+     * Unstructured remittance information attached to the transfer. Not all rails
+     * support this field.
+     */
+    unstructured_remittance_information: string | null;
+  }
+
+  export namespace Payload {
     /**
      * Failure details when status is failed, otherwise null.
      */
@@ -894,6 +823,7 @@ export namespace PayoutFailedWebhookEvent {
         | 'account_blocked'
         | 'insufficient_funds'
         | 'invalid_account_format'
+        | 'invalid_routing_number'
         | 'invalid_instruction'
         | 'invalid_amount'
         | 'invalid_time'
@@ -961,12 +891,151 @@ export namespace ReturnInitiatedWebhookEvent {
     amount: string;
 
     /**
-     * ISO 8601 UTC timestamp when the return was created.
+     * Currency code (ISO 4217 or crypto).
      */
-    created_at: string;
+    currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
+
+    /**
+     * ID of the parent deposit.
+     */
+    deposit_id: string;
+
+    /**
+     * Failure details when status is failed, otherwise null.
+     */
+    failure: Payload.Failure | null;
+
+    /**
+     * ISO 8601 UTC timestamp when the return was initiated.
+     */
+    initiated_at: string;
+
+    /**
+     * Payment scheme or blockchain used for the return, or null when unknown.
+     */
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
+
+    /**
+     * ISO 8601 UTC timestamp when the return was sent.
+     */
+    sent_at: string | null;
+
+    /**
+     * Current status of the return.
+     */
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
+
+    /**
+     * Transaction hash for crypto returns, or null when not known. Only blockchain
+     * rails support this field.
+     */
+    tx_hash: string | null;
+
+    /**
+     * Resource type discriminator.
+     */
+    type: 'return';
+  }
 
+  export namespace Payload {
     /**
-     * Currency code (ISO 4217 currency code or crypto currency code).
+     * Failure details when status is failed, otherwise null.
+     */
+    export interface Failure {
+      /**
+       * Failure code.
+       */
+      code:
+        | 'account_closed'
+        | 'account_blocked'
+        | 'insufficient_funds'
+        | 'invalid_account_format'
+        | 'invalid_routing_number'
+        | 'invalid_instruction'
+        | 'invalid_amount'
+        | 'invalid_time'
+        | 'duplicate_transaction'
+        | 'payee_verification_failed'
+        | 'system_error'
+        | 'provider_system_error'
+        | 'rejected_by_correspondent_bank'
+        | 'blocked_by_review'
+        | 'unknown';
+
+      /**
+       * Human-readable description of the failure.
+       */
+      message: string;
+
+      /**
+       * Whether the return can be retried.
+       */
+      retry: boolean;
+    }
+  }
+}
+
+export interface ReturnSubmittedWebhookEvent {
+  /**
+   * Unique identifier for the event. Stable across retries.
+   */
+  id: string;
+
+  /**
+   * API version the payload was rendered at. Stable across retries and redeliveries.
+   */
+  api_version: string;
+
+  /**
+   * ISO 8601 UTC timestamp when the event was created.
+   */
+  date: string;
+
+  /**
+   * Full resource snapshot at the time of the event.
+   */
+  payload: ReturnSubmittedWebhookEvent.Payload;
+
+  /**
+   * Event type in resource.action format.
+   */
+  type: 'return.submitted';
+}
+
+export namespace ReturnSubmittedWebhookEvent {
+  /**
+   * Full resource snapshot at the time of the event.
+   */
+  export interface Payload {
+    /**
+     * Unique identifier of the return.
+     */
+    id: string;
+
+    /**
+     * Amount as a string decimal (e.g. "100.50").
+     */
+    amount: string;
+
+    /**
+     * Currency code (ISO 4217 or crypto).
      */
     currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
@@ -976,24 +1045,57 @@ export namespace ReturnInitiatedWebhookEvent {
     deposit_id: string;
 
     /**
-     * Failure details when status is failed, otherwise null.
+     * Failure details when status is failed, otherwise null.
+     */
+    failure: Payload.Failure | null;
+
+    /**
+     * ISO 8601 UTC timestamp when the return was initiated.
+     */
+    initiated_at: string;
+
+    /**
+     * Payment scheme or blockchain used for the return, or null when unknown.
+     */
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
+
+    /**
+     * ISO 8601 UTC timestamp when the return was sent.
      */
-    failure: Payload.Failure | null;
+    sent_at: string | null;
 
     /**
      * Current status of the return.
      */
-    status: 'pending' | 'paid' | 'failed' | 'returned';
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
 
     /**
-     * Type of the resource.
+     * Transaction hash for crypto returns, or null when not known. Only blockchain
+     * rails support this field.
      */
-    type: 'return';
+    tx_hash: string | null;
 
     /**
-     * ISO 8601 UTC timestamp when the return was last updated.
+     * Resource type discriminator.
      */
-    updated_at: string;
+    type: 'return';
   }
 
   export namespace Payload {
@@ -1009,6 +1111,7 @@ export namespace ReturnInitiatedWebhookEvent {
         | 'account_blocked'
         | 'insufficient_funds'
         | 'invalid_account_format'
+        | 'invalid_routing_number'
         | 'invalid_instruction'
         | 'invalid_amount'
         | 'invalid_time'
@@ -1033,7 +1136,7 @@ export namespace ReturnInitiatedWebhookEvent {
   }
 }
 
-export interface ReturnPaidWebhookEvent {
+export interface ReturnSentWebhookEvent {
   /**
    * Unique identifier for the event. Stable across retries.
    */
@@ -1052,15 +1155,15 @@ export interface ReturnPaidWebhookEvent {
   /**
    * Full resource snapshot at the time of the event.
    */
-  payload: ReturnPaidWebhookEvent.Payload;
+  payload: ReturnSentWebhookEvent.Payload;
 
   /**
    * Event type in resource.action format.
    */
-  type: 'return.paid';
+  type: 'return.sent';
 }
 
-export namespace ReturnPaidWebhookEvent {
+export namespace ReturnSentWebhookEvent {
   /**
    * Full resource snapshot at the time of the event.
    */
@@ -1076,12 +1179,7 @@ export namespace ReturnPaidWebhookEvent {
     amount: string;
 
     /**
-     * ISO 8601 UTC timestamp when the return was created.
-     */
-    created_at: string;
-
-    /**
-     * Currency code (ISO 4217 currency code or crypto currency code).
+     * Currency code (ISO 4217 or crypto).
      */
     currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
@@ -1095,20 +1193,53 @@ export namespace ReturnPaidWebhookEvent {
      */
     failure: Payload.Failure | null;
 
+    /**
+     * ISO 8601 UTC timestamp when the return was initiated.
+     */
+    initiated_at: string;
+
+    /**
+     * Payment scheme or blockchain used for the return, or null when unknown.
+     */
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
+
+    /**
+     * ISO 8601 UTC timestamp when the return was sent.
+     */
+    sent_at: string | null;
+
     /**
      * Current status of the return.
      */
-    status: 'pending' | 'paid' | 'failed' | 'returned';
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
 
     /**
-     * Type of the resource.
+     * Transaction hash for crypto returns, or null when not known. Only blockchain
+     * rails support this field.
      */
-    type: 'return';
+    tx_hash: string | null;
 
     /**
-     * ISO 8601 UTC timestamp when the return was last updated.
+     * Resource type discriminator.
      */
-    updated_at: string;
+    type: 'return';
   }
 
   export namespace Payload {
@@ -1124,6 +1255,7 @@ export namespace ReturnPaidWebhookEvent {
         | 'account_blocked'
         | 'insufficient_funds'
         | 'invalid_account_format'
+        | 'invalid_routing_number'
         | 'invalid_instruction'
         | 'invalid_amount'
         | 'invalid_time'
@@ -1191,12 +1323,7 @@ export namespace ReturnFailedWebhookEvent {
     amount: string;
 
     /**
-     * ISO 8601 UTC timestamp when the return was created.
-     */
-    created_at: string;
-
-    /**
-     * Currency code (ISO 4217 currency code or crypto currency code).
+     * Currency code (ISO 4217 or crypto).
      */
     currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
@@ -1210,20 +1337,53 @@ export namespace ReturnFailedWebhookEvent {
      */
     failure: Payload.Failure | null;
 
+    /**
+     * ISO 8601 UTC timestamp when the return was initiated.
+     */
+    initiated_at: string;
+
+    /**
+     * Payment scheme or blockchain used for the return, or null when unknown.
+     */
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
+
+    /**
+     * ISO 8601 UTC timestamp when the return was sent.
+     */
+    sent_at: string | null;
+
     /**
      * Current status of the return.
      */
-    status: 'pending' | 'paid' | 'failed' | 'returned';
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
 
     /**
-     * Type of the resource.
+     * Transaction hash for crypto returns, or null when not known. Only blockchain
+     * rails support this field.
      */
-    type: 'return';
+    tx_hash: string | null;
 
     /**
-     * ISO 8601 UTC timestamp when the return was last updated.
+     * Resource type discriminator.
      */
-    updated_at: string;
+    type: 'return';
   }
 
   export namespace Payload {
@@ -1239,6 +1399,7 @@ export namespace ReturnFailedWebhookEvent {
         | 'account_blocked'
         | 'insufficient_funds'
         | 'invalid_account_format'
+        | 'invalid_routing_number'
         | 'invalid_instruction'
         | 'invalid_amount'
         | 'invalid_time'
@@ -1306,12 +1467,7 @@ export namespace ReturnReturnedWebhookEvent {
     amount: string;
 
     /**
-     * ISO 8601 UTC timestamp when the return was created.
-     */
-    created_at: string;
-
-    /**
-     * Currency code (ISO 4217 currency code or crypto currency code).
+     * Currency code (ISO 4217 or crypto).
      */
     currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
@@ -1325,20 +1481,53 @@ export namespace ReturnReturnedWebhookEvent {
      */
     failure: Payload.Failure | null;
 
+    /**
+     * ISO 8601 UTC timestamp when the return was initiated.
+     */
+    initiated_at: string;
+
+    /**
+     * Payment scheme or blockchain used for the return, or null when unknown.
+     */
+    rail:
+      | 'sepa'
+      | 'sepa_instant'
+      | 'faster_payments'
+      | 'swift'
+      | 'internal'
+      | 'target'
+      | 'ach'
+      | 'fedwire'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
+      | null;
+
+    /**
+     * ISO 8601 UTC timestamp when the return was sent.
+     */
+    sent_at: string | null;
+
     /**
      * Current status of the return.
      */
-    status: 'pending' | 'paid' | 'failed' | 'returned';
+    status: 'initiated' | 'submitted' | 'sent' | 'failed' | 'returned';
 
     /**
-     * Type of the resource.
+     * Transaction hash for crypto returns, or null when not known. Only blockchain
+     * rails support this field.
      */
-    type: 'return';
+    tx_hash: string | null;
 
     /**
-     * ISO 8601 UTC timestamp when the return was last updated.
+     * Resource type discriminator.
      */
-    updated_at: string;
+    type: 'return';
   }
 
   export namespace Payload {
@@ -1354,6 +1543,7 @@ export namespace ReturnReturnedWebhookEvent {
         | 'account_blocked'
         | 'insufficient_funds'
         | 'invalid_account_format'
+        | 'invalid_routing_number'
         | 'invalid_instruction'
         | 'invalid_amount'
         | 'invalid_time'
@@ -1378,7 +1568,7 @@ export namespace ReturnReturnedWebhookEvent {
   }
 }
 
-export interface DepositReceivedWebhookEvent {
+export interface DepositSettledWebhookEvent {
   /**
    * Unique identifier for the event. Stable across retries.
    */
@@ -1397,15 +1587,15 @@ export interface DepositReceivedWebhookEvent {
   /**
    * Full resource snapshot at the time of the event.
    */
-  payload: DepositReceivedWebhookEvent.Payload;
+  payload: DepositSettledWebhookEvent.Payload;
 
   /**
    * Event type in resource.action format.
    */
-  type: 'deposit.received';
+  type: 'deposit.settled';
 }
 
-export namespace DepositReceivedWebhookEvent {
+export namespace DepositSettledWebhookEvent {
   /**
    * Full resource snapshot at the time of the event.
    */
@@ -1416,55 +1606,45 @@ export namespace DepositReceivedWebhookEvent {
     id: string;
 
     /**
-     * Amount as a string decimal (e.g. "100.50").
+     * ID of the account that was credited with the deposit.
      */
-    amount: string;
+    account_id: string;
 
     /**
-     * Reference visible on the bank statement, or null when not applicable.
+     * Amount as a string decimal (e.g. "100.50").
      */
-    bank_statement_reference: string | null;
+    amount: string;
 
     /**
-     * ISO 8601 UTC timestamp when the deposit was created.
+     * ID of the counterparty that sent the money, or null when not known.
      */
-    created_at: string;
+    counterparty_id: string | null;
 
     /**
-     * Supported fiat or crypto currency code for the deposit amount.
+     * Currency code (ISO 4217 or crypto).
      */
     currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
 
     /**
-     * ID of the merchant account that received the deposit.
-     */
-    destination_account_id: string;
-
-    /**
-     * Payment rail or blockchain used for the deposit, or null when unknown.
+     * Payment scheme or blockchain used for the deposit, or null when unknown.
      */
     rail:
+      | 'sepa'
       | 'sepa_instant'
       | 'faster_payments'
-      | 'sepa'
-      | 'elixir'
-      | 'express_elixir'
-      | 'sek_account_to_account'
-      | 'sumclearing'
-      | 'straksclearing'
       | 'swift'
       | 'internal'
       | 'target'
       | 'ach'
       | 'fedwire'
-      | 'btc'
-      | 'btc_testnet4'
-      | 'eth'
-      | 'eth_sepolia'
-      | 'sol'
-      | 'sol_devnet'
-      | 'matic'
-      | 'matic_amoy'
+      | 'bitcoin'
+      | 'bitcoin_testnet4'
+      | 'ethereum'
+      | 'ethereum_sepolia'
+      | 'solana'
+      | 'solana_devnet'
+      | 'polygon'
+      | 'polygon_amoy'
       | null;
 
     /**
@@ -1473,17 +1653,24 @@ export namespace DepositReceivedWebhookEvent {
     returns: Array<string>;
 
     /**
-     * Counterparty bank account or crypto wallet that sent the funds.
+     * ISO 8601 UTC timestamp when the deposit was settled.
      */
-    source: Payload.Iban | Payload.UkSortCode | Payload.Aba | Payload.Wallet;
+    settled_at: string;
 
     /**
      * Current status of the deposit.
      */
-    status: 'received' | 'in_return' | 'returned' | 'return_failed' | 'return_returned';
+    status: 'settled';
+
+    /**
+     * Reference used to track the payment across the payment network, such as the UETR
+     * for SWIFT payments.
+     */
+    tracking_reference: string | null;
 
     /**
-     * Transaction hash for crypto deposits, or null when not known.
+     * Transaction hash for crypto deposits, or null when not known. Only blockchain
+     * rails support this field.
      */
     tx_hash: string | null;
 
@@ -1493,102 +1680,10 @@ export namespace DepositReceivedWebhookEvent {
     type: 'deposit';
 
     /**
-     * ISO 8601 UTC timestamp when the deposit was last updated.
+     * Unstructured remittance information attached to the transfer. Not all rails
+     * support this field.
      */
-    updated_at: string;
-  }
-
-  export namespace Payload {
-    export interface Iban {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank Identifier Code, or null if not provided.
-       */
-      bic: string | null;
-
-      /**
-       * International Bank Account Number.
-       */
-      iban: string;
-
-      /**
-       * Discriminator for IBAN source.
-       */
-      type: 'iban';
-    }
-
-    export interface UkSortCode {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * UK account number (8 digits).
-       */
-      account_number: string;
-
-      /**
-       * UK sort code (6 digits).
-       */
-      sort_code: string;
-
-      /**
-       * Discriminator for UK sort code source.
-       */
-      type: 'sort_code';
-    }
-
-    export interface Aba {
-      /**
-       * Name of the account holder.
-       */
-      account_holder_name: string;
-
-      /**
-       * Bank account number.
-       */
-      account_number: string;
-
-      /**
-       * ABA routing number (9 digits).
-       */
-      routing_number: string;
-
-      /**
-       * Discriminator for ABA wire source.
-       */
-      type: 'aba';
-    }
-
-    export interface Wallet {
-      /**
-       * Wallet address on the specified blockchain.
-       */
-      address: string;
-
-      /**
-       * Blockchain network for the crypto wallet.
-       */
-      blockchain:
-        | 'bitcoin'
-        | 'ethereum'
-        | 'solana'
-        | 'polygon'
-        | 'bitcoin_testnet4'
-        | 'ethereum_sepolia'
-        | 'solana_devnet'
-        | 'polygon_amoy';
-
-      /**
-       * Discriminator for crypto wallet source.
-       */
-      type: 'crypto_wallet';
-    }
+    unstructured_remittance_information: string | null;
   }
 }
 
@@ -1639,36 +1734,21 @@ export namespace ConversionCreatedWebhookEvent {
      */
     created_at: string;
 
-    /**
-     * Failure details when status is failed, otherwise null.
-     */
-    failure: Payload.Failure | null;
-
     /**
      * Key-value pairs stored with the conversion.
      */
     metadata: { [key: string]: string };
 
-    /**
-     * ID of the associated quote, or null.
-     */
-    quote_id: string | null;
-
     /**
      * ID of the source account, or null.
      */
     source_account_id: string | null;
 
     /**
-     * Source amount as a string decimal.
+     * Amount as a string decimal (e.g. "100.50").
      */
     source_amount: string;
 
-    /**
-     * Source currency code.
-     */
-    source_currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
-
     /**
      * Current status of the conversion.
      */
@@ -1680,9 +1760,9 @@ export namespace ConversionCreatedWebhookEvent {
     target_account_id: string | null;
 
     /**
-     * Target currency code.
+     * Amount as a string decimal (e.g. "100.50").
      */
-    target_currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
+    target_amount: string;
 
     /**
      * Resource type discriminator.
@@ -1694,18 +1774,6 @@ export namespace ConversionCreatedWebhookEvent {
      */
     updated_at: string;
   }
-
-  export namespace Payload {
-    /**
-     * Failure details when status is failed, otherwise null.
-     */
-    export interface Failure {
-      /**
-       * Human-readable description of the failure.
-       */
-      message: string;
-    }
-  }
 }
 
 export interface ConversionCompletedWebhookEvent {
@@ -1755,36 +1823,21 @@ export namespace ConversionCompletedWebhookEvent {
      */
     created_at: string;
 
-    /**
-     * Failure details when status is failed, otherwise null.
-     */
-    failure: Payload.Failure | null;
-
     /**
      * Key-value pairs stored with the conversion.
      */
     metadata: { [key: string]: string };
 
-    /**
-     * ID of the associated quote, or null.
-     */
-    quote_id: string | null;
-
     /**
      * ID of the source account, or null.
      */
     source_account_id: string | null;
 
     /**
-     * Source amount as a string decimal.
+     * Amount as a string decimal (e.g. "100.50").
      */
     source_amount: string;
 
-    /**
-     * Source currency code.
-     */
-    source_currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
-
     /**
      * Current status of the conversion.
      */
@@ -1796,9 +1849,9 @@ export namespace ConversionCompletedWebhookEvent {
     target_account_id: string | null;
 
     /**
-     * Target currency code.
+     * Amount as a string decimal (e.g. "100.50").
      */
-    target_currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
+    target_amount: string;
 
     /**
      * Resource type discriminator.
@@ -1810,18 +1863,6 @@ export namespace ConversionCompletedWebhookEvent {
      */
     updated_at: string;
   }
-
-  export namespace Payload {
-    /**
-     * Failure details when status is failed, otherwise null.
-     */
-    export interface Failure {
-      /**
-       * Human-readable description of the failure.
-       */
-      message: string;
-    }
-  }
 }
 
 export interface ConversionFailedWebhookEvent {
@@ -1871,36 +1912,21 @@ export namespace ConversionFailedWebhookEvent {
      */
     created_at: string;
 
-    /**
-     * Failure details when status is failed, otherwise null.
-     */
-    failure: Payload.Failure | null;
-
     /**
      * Key-value pairs stored with the conversion.
      */
     metadata: { [key: string]: string };
 
-    /**
-     * ID of the associated quote, or null.
-     */
-    quote_id: string | null;
-
     /**
      * ID of the source account, or null.
      */
     source_account_id: string | null;
 
     /**
-     * Source amount as a string decimal.
+     * Amount as a string decimal (e.g. "100.50").
      */
     source_amount: string;
 
-    /**
-     * Source currency code.
-     */
-    source_currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
-
     /**
      * Current status of the conversion.
      */
@@ -1912,9 +1938,9 @@ export namespace ConversionFailedWebhookEvent {
     target_account_id: string | null;
 
     /**
-     * Target currency code.
+     * Amount as a string decimal (e.g. "100.50").
      */
-    target_currency: 'EUR' | 'GBP' | 'USD' | 'USDC';
+    target_amount: string;
 
     /**
      * Resource type discriminator.
@@ -1926,18 +1952,6 @@ export namespace ConversionFailedWebhookEvent {
      */
     updated_at: string;
   }
-
-  export namespace Payload {
-    /**
-     * Failure details when status is failed, otherwise null.
-     */
-    export interface Failure {
-      /**
-       * Human-readable description of the failure.
-       */
-      message: string;
-    }
-  }
 }
 
 export interface AccountHolderActiveWebhookEvent {
@@ -1978,12 +1992,15 @@ export namespace AccountHolderActiveWebhookEvent {
     id: string;
 
     /**
-     * Beneficiary details used to create this account holder.
+     * Beneficiary details used to create this account holder. Which shape is returned
+     * follows `country_of_citizenship`: **US individual** when it is `US`, **Non-US
+     * individual** for any other country, **Business** when `holder_type` is
+     * `business`.
      */
     beneficiary_data:
-      | Payload.UsBeneficiaryDataResponse
-      | Payload.NonUsBeneficiaryDataResponse
-      | Payload.BusinessBeneficiaryDataResponse;
+      | Payload.V1UsBeneficiaryDataResponse
+      | Payload.V1NonUsBeneficiaryDataResponse
+      | Payload.V1BusinessBeneficiaryDataResponse;
 
     /**
      * ISO 8601 UTC timestamp when the account holder was created.
@@ -2007,7 +2024,7 @@ export namespace AccountHolderActiveWebhookEvent {
   }
 
   export namespace Payload {
-    export interface UsBeneficiaryDataResponse {
+    export interface V1UsBeneficiaryDataResponse {
       /**
        * ISO 3166-1 alpha-2 country code of citizenship.
        */
@@ -2023,8 +2040,8 @@ export namespace AccountHolderActiveWebhookEvent {
        * format ###-##-####) or "itin" (Individual Taxpayer ID, format 9##-##-####).
        */
       identification:
-        | UsBeneficiaryDataResponse.SsnIdentification
-        | UsBeneficiaryDataResponse.ItinIdentification;
+        | V1UsBeneficiaryDataResponse.V1SsnIdentification
+        | V1UsBeneficiaryDataResponse.V1ItinIdentification;
 
       /**
        * Full legal name of the account holder.
@@ -2032,68 +2049,70 @@ export namespace AccountHolderActiveWebhookEvent {
       legal_name: string;
 
       /**
-       * Residential address of the account holder.
+       * Residential address of the account holder. **US address** requires
+       * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+       * other country and allows `state` to be null.
        */
       residential_address:
-        | UsBeneficiaryDataResponse.UsResidentialAddressResponse
-        | UsBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+        | V1UsBeneficiaryDataResponse.V1UsResidentialAddress
+        | V1UsBeneficiaryDataResponse.V1NonUsResidentialAddress;
     }
 
-    export namespace UsBeneficiaryDataResponse {
-      export interface SsnIdentification {
+    export namespace V1UsBeneficiaryDataResponse {
+      export interface V1SsnIdentification {
         type: 'ssn';
 
         value: string;
       }
 
-      export interface ItinIdentification {
+      export interface V1ItinIdentification {
         type: 'itin';
 
         value: string;
       }
 
-      export interface UsResidentialAddressResponse {
+      export interface V1UsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country: 'US';
+        country_code: 'US';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Two-letter state code.
+         * Secondary street address, or null if not recorded.
          */
-        state: string;
+        line_2: string | null;
 
         /**
-         * Primary street address.
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region.
          */
-        street_line_2: string | null;
+        state: string;
       }
 
-      export interface NonUsResidentialAddressResponse {
+      export interface V1NonUsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country:
+        country_code:
           | 'AF'
           | 'AL'
           | 'DZ'
@@ -2345,23 +2364,28 @@ export namespace AccountHolderActiveWebhookEvent {
           | 'XK';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Primary street address.
+         * Secondary street address, or null if not recorded.
          */
-        street_line_1: string;
+        line_2: string | null;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * Postal or ZIP code.
+         */
+        postal_code: string;
+
+        /**
+         * State, province, or region, or null if not recorded.
          */
-        street_line_2: string | null;
+        state: string | null;
       }
     }
 
-    export interface NonUsBeneficiaryDataResponse {
+    export interface V1NonUsBeneficiaryDataResponse {
       /**
        * ISO 3166-1 alpha-2 country code of citizenship.
        */
@@ -2624,7 +2648,7 @@ export namespace AccountHolderActiveWebhookEvent {
       /**
        * Government-issued identification with type: "id" (generic government-issued ID).
        */
-      identification: NonUsBeneficiaryDataResponse.Identification;
+      identification: V1NonUsBeneficiaryDataResponse.Identification;
 
       /**
        * Full legal name of the account holder.
@@ -2632,14 +2656,16 @@ export namespace AccountHolderActiveWebhookEvent {
       legal_name: string;
 
       /**
-       * Residential address of the account holder.
+       * Residential address of the account holder. **US address** requires
+       * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+       * other country and allows `state` to be null.
        */
       residential_address:
-        | NonUsBeneficiaryDataResponse.UsResidentialAddressResponse
-        | NonUsBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+        | V1NonUsBeneficiaryDataResponse.V1UsResidentialAddress
+        | V1NonUsBeneficiaryDataResponse.V1NonUsResidentialAddress;
     }
 
-    export namespace NonUsBeneficiaryDataResponse {
+    export namespace V1NonUsBeneficiaryDataResponse {
       /**
        * Government-issued identification with type: "id" (generic government-issued ID).
        */
@@ -2649,48 +2675,48 @@ export namespace AccountHolderActiveWebhookEvent {
         value: string;
       }
 
-      export interface UsResidentialAddressResponse {
+      export interface V1UsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country: 'US';
+        country_code: 'US';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Two-letter state code.
+         * Secondary street address, or null if not recorded.
          */
-        state: string;
+        line_2: string | null;
 
         /**
-         * Primary street address.
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region.
          */
-        street_line_2: string | null;
+        state: string;
       }
 
-      export interface NonUsResidentialAddressResponse {
+      export interface V1NonUsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country:
+        country_code:
           | 'AF'
           | 'AL'
           | 'DZ'
@@ -2942,38 +2968,44 @@ export namespace AccountHolderActiveWebhookEvent {
           | 'XK';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Primary street address.
+         * Secondary street address, or null if not recorded.
+         */
+        line_2: string | null;
+
+        /**
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region, or null if not recorded.
          */
-        street_line_2: string | null;
+        state: string | null;
       }
     }
 
-    export interface BusinessBeneficiaryDataResponse {
+    export interface V1BusinessBeneficiaryDataResponse {
       /**
        * Beneficial owners of the business. At least one required.
        */
       beneficial_owners: Array<
-        | BusinessBeneficiaryDataResponse.UsBeneficiaryDataResponse
-        | BusinessBeneficiaryDataResponse.NonUsBeneficiaryDataResponse
+        | V1BusinessBeneficiaryDataResponse.V1UsBeneficiaryDataResponse
+        | V1BusinessBeneficiaryDataResponse.V1NonUsBeneficiaryDataResponse
       >;
 
       /**
        * Individual with primary responsibility for controlling, managing, or directing
-       * the business.
+       * the business. Follows the same US / non-US split as `beneficiary_data`, based on
+       * the control person's own `country_of_citizenship`.
        */
       control_person:
-        | BusinessBeneficiaryDataResponse.UnionMember0
-        | BusinessBeneficiaryDataResponse.UnionMember1;
+        | V1BusinessBeneficiaryDataResponse.UnionMember0
+        | V1BusinessBeneficiaryDataResponse.UnionMember1;
 
       /**
        * ISO 3166-1 alpha-2 country code where the business is incorporated.
@@ -3241,26 +3273,30 @@ export namespace AccountHolderActiveWebhookEvent {
       legal_business_name: string;
 
       /**
-       * Physical operating address of the business.
+       * Physical operating address of the business. **US address** requires
+       * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+       * other country and allows `state` to be null.
        */
       physical_address:
-        | BusinessBeneficiaryDataResponse.UsResidentialAddressResponse
-        | BusinessBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+        | V1BusinessBeneficiaryDataResponse.V1UsResidentialAddress
+        | V1BusinessBeneficiaryDataResponse.V1NonUsResidentialAddress;
 
       /**
-       * Registered legal address of the business.
+       * Registered legal address of the business. **US address** requires
+       * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+       * other country and allows `state` to be null.
        */
       registered_address:
-        | BusinessBeneficiaryDataResponse.UsResidentialAddressResponse
-        | BusinessBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+        | V1BusinessBeneficiaryDataResponse.V1UsResidentialAddress
+        | V1BusinessBeneficiaryDataResponse.V1NonUsResidentialAddress;
 
       /**
        * Business registration number: type "ein" (Employer Identification Number, format
        * ##-#######) or "ssn" (Social Security Number, format ###-##-####).
        */
       registration_number:
-        | BusinessBeneficiaryDataResponse.EinIdentification
-        | BusinessBeneficiaryDataResponse.SsnIdentification;
+        | V1BusinessBeneficiaryDataResponse.V1EinIdentification
+        | V1BusinessBeneficiaryDataResponse.V1SsnIdentification;
 
       /**
        * State or subdivision where the business is incorporated.
@@ -3273,8 +3309,8 @@ export namespace AccountHolderActiveWebhookEvent {
       year_of_incorporation: number;
     }
 
-    export namespace BusinessBeneficiaryDataResponse {
-      export interface UsBeneficiaryDataResponse {
+    export namespace V1BusinessBeneficiaryDataResponse {
+      export interface V1UsBeneficiaryDataResponse {
         /**
          * ISO 3166-1 alpha-2 country code of citizenship.
          */
@@ -3290,8 +3326,8 @@ export namespace AccountHolderActiveWebhookEvent {
          * format ###-##-####) or "itin" (Individual Taxpayer ID, format 9##-##-####).
          */
         identification:
-          | UsBeneficiaryDataResponse.SsnIdentification
-          | UsBeneficiaryDataResponse.ItinIdentification;
+          | V1UsBeneficiaryDataResponse.V1SsnIdentification
+          | V1UsBeneficiaryDataResponse.V1ItinIdentification;
 
         /**
          * Full legal name of the account holder.
@@ -3299,68 +3335,70 @@ export namespace AccountHolderActiveWebhookEvent {
         legal_name: string;
 
         /**
-         * Residential address of the account holder.
+         * Residential address of the account holder. **US address** requires
+         * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+         * other country and allows `state` to be null.
          */
         residential_address:
-          | UsBeneficiaryDataResponse.UsResidentialAddressResponse
-          | UsBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+          | V1UsBeneficiaryDataResponse.V1UsResidentialAddress
+          | V1UsBeneficiaryDataResponse.V1NonUsResidentialAddress;
       }
 
-      export namespace UsBeneficiaryDataResponse {
-        export interface SsnIdentification {
+      export namespace V1UsBeneficiaryDataResponse {
+        export interface V1SsnIdentification {
           type: 'ssn';
 
           value: string;
         }
 
-        export interface ItinIdentification {
+        export interface V1ItinIdentification {
           type: 'itin';
 
           value: string;
         }
 
-        export interface UsResidentialAddressResponse {
+        export interface V1UsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country: 'US';
+          country_code: 'US';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Two-letter state code.
+           * Secondary street address, or null if not recorded.
            */
-          state: string;
+          line_2: string | null;
 
           /**
-           * Primary street address.
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region.
            */
-          street_line_2: string | null;
+          state: string;
         }
 
-        export interface NonUsResidentialAddressResponse {
+        export interface V1NonUsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country:
+          country_code:
             | 'AF'
             | 'AL'
             | 'DZ'
@@ -3612,23 +3650,28 @@ export namespace AccountHolderActiveWebhookEvent {
             | 'XK';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Primary street address.
+           * Secondary street address, or null if not recorded.
+           */
+          line_2: string | null;
+
+          /**
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region, or null if not recorded.
            */
-          street_line_2: string | null;
+          state: string | null;
         }
       }
 
-      export interface NonUsBeneficiaryDataResponse {
+      export interface V1NonUsBeneficiaryDataResponse {
         /**
          * ISO 3166-1 alpha-2 country code of citizenship.
          */
@@ -3891,7 +3934,7 @@ export namespace AccountHolderActiveWebhookEvent {
         /**
          * Government-issued identification with type: "id" (generic government-issued ID).
          */
-        identification: NonUsBeneficiaryDataResponse.Identification;
+        identification: V1NonUsBeneficiaryDataResponse.Identification;
 
         /**
          * Full legal name of the account holder.
@@ -3899,14 +3942,16 @@ export namespace AccountHolderActiveWebhookEvent {
         legal_name: string;
 
         /**
-         * Residential address of the account holder.
+         * Residential address of the account holder. **US address** requires
+         * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+         * other country and allows `state` to be null.
          */
         residential_address:
-          | NonUsBeneficiaryDataResponse.UsResidentialAddressResponse
-          | NonUsBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+          | V1NonUsBeneficiaryDataResponse.V1UsResidentialAddress
+          | V1NonUsBeneficiaryDataResponse.V1NonUsResidentialAddress;
       }
 
-      export namespace NonUsBeneficiaryDataResponse {
+      export namespace V1NonUsBeneficiaryDataResponse {
         /**
          * Government-issued identification with type: "id" (generic government-issued ID).
          */
@@ -3916,48 +3961,48 @@ export namespace AccountHolderActiveWebhookEvent {
           value: string;
         }
 
-        export interface UsResidentialAddressResponse {
+        export interface V1UsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country: 'US';
+          country_code: 'US';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Two-letter state code.
+           * Secondary street address, or null if not recorded.
            */
-          state: string;
+          line_2: string | null;
 
           /**
-           * Primary street address.
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region.
            */
-          street_line_2: string | null;
+          state: string;
         }
 
-        export interface NonUsResidentialAddressResponse {
+        export interface V1NonUsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country:
+          country_code:
             | 'AF'
             | 'AL'
             | 'DZ'
@@ -4209,19 +4254,24 @@ export namespace AccountHolderActiveWebhookEvent {
             | 'XK';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Primary street address.
+           * Secondary street address, or null if not recorded.
+           */
+          line_2: string | null;
+
+          /**
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region, or null if not recorded.
            */
-          street_line_2: string | null;
+          state: string | null;
         }
       }
 
@@ -4240,7 +4290,7 @@ export namespace AccountHolderActiveWebhookEvent {
          * Government-issued identification with type: "ssn" (Social Security Number,
          * format ###-##-####) or "itin" (Individual Taxpayer ID, format 9##-##-####).
          */
-        identification: UnionMember0.SsnIdentification | UnionMember0.ItinIdentification;
+        identification: UnionMember0.V1SsnIdentification | UnionMember0.V1ItinIdentification;
 
         /**
          * Full legal name of the account holder.
@@ -4248,11 +4298,11 @@ export namespace AccountHolderActiveWebhookEvent {
         legal_name: string;
 
         /**
-         * Residential address of the account holder.
+         * Residential address of the account holder. **US address** requires
+         * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+         * other country and allows `state` to be null.
          */
-        residential_address:
-          | UnionMember0.UsResidentialAddressResponse
-          | UnionMember0.NonUsResidentialAddressResponse;
+        residential_address: UnionMember0.V1UsResidentialAddress | UnionMember0.V1NonUsResidentialAddress;
 
         /**
          * Role of the control person at the business (e.g., "CEO", "President", "Managing
@@ -4262,60 +4312,60 @@ export namespace AccountHolderActiveWebhookEvent {
       }
 
       export namespace UnionMember0 {
-        export interface SsnIdentification {
+        export interface V1SsnIdentification {
           type: 'ssn';
 
           value: string;
         }
 
-        export interface ItinIdentification {
+        export interface V1ItinIdentification {
           type: 'itin';
 
           value: string;
         }
 
-        export interface UsResidentialAddressResponse {
+        export interface V1UsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country: 'US';
+          country_code: 'US';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Two-letter state code.
+           * Secondary street address, or null if not recorded.
            */
-          state: string;
+          line_2: string | null;
 
           /**
-           * Primary street address.
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region.
            */
-          street_line_2: string | null;
+          state: string;
         }
 
-        export interface NonUsResidentialAddressResponse {
+        export interface V1NonUsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country:
+          country_code:
             | 'AF'
             | 'AL'
             | 'DZ'
@@ -4567,19 +4617,24 @@ export namespace AccountHolderActiveWebhookEvent {
             | 'XK';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Primary street address.
+           * Secondary street address, or null if not recorded.
+           */
+          line_2: string | null;
+
+          /**
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region, or null if not recorded.
            */
-          street_line_2: string | null;
+          state: string | null;
         }
       }
 
@@ -4854,11 +4909,11 @@ export namespace AccountHolderActiveWebhookEvent {
         legal_name: string;
 
         /**
-         * Residential address of the account holder.
+         * Residential address of the account holder. **US address** requires
+         * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+         * other country and allows `state` to be null.
          */
-        residential_address:
-          | UnionMember1.UsResidentialAddressResponse
-          | UnionMember1.NonUsResidentialAddressResponse;
+        residential_address: UnionMember1.V1UsResidentialAddress | UnionMember1.V1NonUsResidentialAddress;
 
         /**
          * Role of the control person at the business (e.g., "CEO", "President", "Managing
@@ -4877,48 +4932,48 @@ export namespace AccountHolderActiveWebhookEvent {
           value: string;
         }
 
-        export interface UsResidentialAddressResponse {
+        export interface V1UsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country: 'US';
+          country_code: 'US';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Two-letter state code.
+           * Secondary street address, or null if not recorded.
            */
-          state: string;
+          line_2: string | null;
 
           /**
-           * Primary street address.
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region.
            */
-          street_line_2: string | null;
+          state: string;
         }
 
-        export interface NonUsResidentialAddressResponse {
+        export interface V1NonUsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country:
+          country_code:
             | 'AF'
             | 'AL'
             | 'DZ'
@@ -5170,64 +5225,69 @@ export namespace AccountHolderActiveWebhookEvent {
             | 'XK';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Primary street address.
+           * Secondary street address, or null if not recorded.
+           */
+          line_2: string | null;
+
+          /**
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region, or null if not recorded.
            */
-          street_line_2: string | null;
+          state: string | null;
         }
       }
 
-      export interface UsResidentialAddressResponse {
+      export interface V1UsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country: 'US';
+        country_code: 'US';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Two-letter state code.
+         * Secondary street address, or null if not recorded.
          */
-        state: string;
+        line_2: string | null;
 
         /**
-         * Primary street address.
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region.
          */
-        street_line_2: string | null;
+        state: string;
       }
 
-      export interface NonUsResidentialAddressResponse {
+      export interface V1NonUsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country:
+        country_code:
           | 'AF'
           | 'AL'
           | 'DZ'
@@ -5479,63 +5539,68 @@ export namespace AccountHolderActiveWebhookEvent {
           | 'XK';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Primary street address.
+         * Secondary street address, or null if not recorded.
          */
-        street_line_1: string;
+        line_2: string | null;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * Postal or ZIP code.
+         */
+        postal_code: string;
+
+        /**
+         * State, province, or region, or null if not recorded.
          */
-        street_line_2: string | null;
+        state: string | null;
       }
 
-      export interface UsResidentialAddressResponse {
+      export interface V1UsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country: 'US';
+        country_code: 'US';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Two-letter state code.
+         * Secondary street address, or null if not recorded.
          */
-        state: string;
+        line_2: string | null;
 
         /**
-         * Primary street address.
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region.
          */
-        street_line_2: string | null;
+        state: string;
       }
 
-      export interface NonUsResidentialAddressResponse {
+      export interface V1NonUsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country:
+        country_code:
           | 'AF'
           | 'AL'
           | 'DZ'
@@ -5787,28 +5852,33 @@ export namespace AccountHolderActiveWebhookEvent {
           | 'XK';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Primary street address.
+         * Secondary street address, or null if not recorded.
+         */
+        line_2: string | null;
+
+        /**
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region, or null if not recorded.
          */
-        street_line_2: string | null;
+        state: string | null;
       }
 
-      export interface EinIdentification {
+      export interface V1EinIdentification {
         type: 'ein';
 
         value: string;
       }
 
-      export interface SsnIdentification {
+      export interface V1SsnIdentification {
         type: 'ssn';
 
         value: string;
@@ -5855,12 +5925,15 @@ export namespace AccountHolderClosedWebhookEvent {
     id: string;
 
     /**
-     * Beneficiary details used to create this account holder.
+     * Beneficiary details used to create this account holder. Which shape is returned
+     * follows `country_of_citizenship`: **US individual** when it is `US`, **Non-US
+     * individual** for any other country, **Business** when `holder_type` is
+     * `business`.
      */
     beneficiary_data:
-      | Payload.UsBeneficiaryDataResponse
-      | Payload.NonUsBeneficiaryDataResponse
-      | Payload.BusinessBeneficiaryDataResponse;
+      | Payload.V1UsBeneficiaryDataResponse
+      | Payload.V1NonUsBeneficiaryDataResponse
+      | Payload.V1BusinessBeneficiaryDataResponse;
 
     /**
      * ISO 8601 UTC timestamp when the account holder was created.
@@ -5884,7 +5957,7 @@ export namespace AccountHolderClosedWebhookEvent {
   }
 
   export namespace Payload {
-    export interface UsBeneficiaryDataResponse {
+    export interface V1UsBeneficiaryDataResponse {
       /**
        * ISO 3166-1 alpha-2 country code of citizenship.
        */
@@ -5900,8 +5973,8 @@ export namespace AccountHolderClosedWebhookEvent {
        * format ###-##-####) or "itin" (Individual Taxpayer ID, format 9##-##-####).
        */
       identification:
-        | UsBeneficiaryDataResponse.SsnIdentification
-        | UsBeneficiaryDataResponse.ItinIdentification;
+        | V1UsBeneficiaryDataResponse.V1SsnIdentification
+        | V1UsBeneficiaryDataResponse.V1ItinIdentification;
 
       /**
        * Full legal name of the account holder.
@@ -5909,68 +5982,70 @@ export namespace AccountHolderClosedWebhookEvent {
       legal_name: string;
 
       /**
-       * Residential address of the account holder.
+       * Residential address of the account holder. **US address** requires
+       * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+       * other country and allows `state` to be null.
        */
       residential_address:
-        | UsBeneficiaryDataResponse.UsResidentialAddressResponse
-        | UsBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+        | V1UsBeneficiaryDataResponse.V1UsResidentialAddress
+        | V1UsBeneficiaryDataResponse.V1NonUsResidentialAddress;
     }
 
-    export namespace UsBeneficiaryDataResponse {
-      export interface SsnIdentification {
+    export namespace V1UsBeneficiaryDataResponse {
+      export interface V1SsnIdentification {
         type: 'ssn';
 
         value: string;
       }
 
-      export interface ItinIdentification {
+      export interface V1ItinIdentification {
         type: 'itin';
 
         value: string;
       }
 
-      export interface UsResidentialAddressResponse {
+      export interface V1UsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country: 'US';
+        country_code: 'US';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Two-letter state code.
+         * Secondary street address, or null if not recorded.
          */
-        state: string;
+        line_2: string | null;
 
         /**
-         * Primary street address.
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region.
          */
-        street_line_2: string | null;
+        state: string;
       }
 
-      export interface NonUsResidentialAddressResponse {
+      export interface V1NonUsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country:
+        country_code:
           | 'AF'
           | 'AL'
           | 'DZ'
@@ -6222,23 +6297,28 @@ export namespace AccountHolderClosedWebhookEvent {
           | 'XK';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Primary street address.
+         * Secondary street address, or null if not recorded.
+         */
+        line_2: string | null;
+
+        /**
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region, or null if not recorded.
          */
-        street_line_2: string | null;
+        state: string | null;
       }
     }
 
-    export interface NonUsBeneficiaryDataResponse {
+    export interface V1NonUsBeneficiaryDataResponse {
       /**
        * ISO 3166-1 alpha-2 country code of citizenship.
        */
@@ -6501,7 +6581,7 @@ export namespace AccountHolderClosedWebhookEvent {
       /**
        * Government-issued identification with type: "id" (generic government-issued ID).
        */
-      identification: NonUsBeneficiaryDataResponse.Identification;
+      identification: V1NonUsBeneficiaryDataResponse.Identification;
 
       /**
        * Full legal name of the account holder.
@@ -6509,14 +6589,16 @@ export namespace AccountHolderClosedWebhookEvent {
       legal_name: string;
 
       /**
-       * Residential address of the account holder.
+       * Residential address of the account holder. **US address** requires
+       * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+       * other country and allows `state` to be null.
        */
       residential_address:
-        | NonUsBeneficiaryDataResponse.UsResidentialAddressResponse
-        | NonUsBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+        | V1NonUsBeneficiaryDataResponse.V1UsResidentialAddress
+        | V1NonUsBeneficiaryDataResponse.V1NonUsResidentialAddress;
     }
 
-    export namespace NonUsBeneficiaryDataResponse {
+    export namespace V1NonUsBeneficiaryDataResponse {
       /**
        * Government-issued identification with type: "id" (generic government-issued ID).
        */
@@ -6526,48 +6608,48 @@ export namespace AccountHolderClosedWebhookEvent {
         value: string;
       }
 
-      export interface UsResidentialAddressResponse {
+      export interface V1UsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country: 'US';
+        country_code: 'US';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Two-letter state code.
+         * Secondary street address, or null if not recorded.
          */
-        state: string;
+        line_2: string | null;
 
         /**
-         * Primary street address.
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region.
          */
-        street_line_2: string | null;
+        state: string;
       }
 
-      export interface NonUsResidentialAddressResponse {
+      export interface V1NonUsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country:
+        country_code:
           | 'AF'
           | 'AL'
           | 'DZ'
@@ -6819,38 +6901,44 @@ export namespace AccountHolderClosedWebhookEvent {
           | 'XK';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Primary street address.
+         * Secondary street address, or null if not recorded.
+         */
+        line_2: string | null;
+
+        /**
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region, or null if not recorded.
          */
-        street_line_2: string | null;
+        state: string | null;
       }
     }
 
-    export interface BusinessBeneficiaryDataResponse {
+    export interface V1BusinessBeneficiaryDataResponse {
       /**
        * Beneficial owners of the business. At least one required.
        */
       beneficial_owners: Array<
-        | BusinessBeneficiaryDataResponse.UsBeneficiaryDataResponse
-        | BusinessBeneficiaryDataResponse.NonUsBeneficiaryDataResponse
+        | V1BusinessBeneficiaryDataResponse.V1UsBeneficiaryDataResponse
+        | V1BusinessBeneficiaryDataResponse.V1NonUsBeneficiaryDataResponse
       >;
 
       /**
        * Individual with primary responsibility for controlling, managing, or directing
-       * the business.
+       * the business. Follows the same US / non-US split as `beneficiary_data`, based on
+       * the control person's own `country_of_citizenship`.
        */
       control_person:
-        | BusinessBeneficiaryDataResponse.UnionMember0
-        | BusinessBeneficiaryDataResponse.UnionMember1;
+        | V1BusinessBeneficiaryDataResponse.UnionMember0
+        | V1BusinessBeneficiaryDataResponse.UnionMember1;
 
       /**
        * ISO 3166-1 alpha-2 country code where the business is incorporated.
@@ -7118,26 +7206,30 @@ export namespace AccountHolderClosedWebhookEvent {
       legal_business_name: string;
 
       /**
-       * Physical operating address of the business.
+       * Physical operating address of the business. **US address** requires
+       * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+       * other country and allows `state` to be null.
        */
       physical_address:
-        | BusinessBeneficiaryDataResponse.UsResidentialAddressResponse
-        | BusinessBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+        | V1BusinessBeneficiaryDataResponse.V1UsResidentialAddress
+        | V1BusinessBeneficiaryDataResponse.V1NonUsResidentialAddress;
 
       /**
-       * Registered legal address of the business.
+       * Registered legal address of the business. **US address** requires
+       * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+       * other country and allows `state` to be null.
        */
       registered_address:
-        | BusinessBeneficiaryDataResponse.UsResidentialAddressResponse
-        | BusinessBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+        | V1BusinessBeneficiaryDataResponse.V1UsResidentialAddress
+        | V1BusinessBeneficiaryDataResponse.V1NonUsResidentialAddress;
 
       /**
        * Business registration number: type "ein" (Employer Identification Number, format
        * ##-#######) or "ssn" (Social Security Number, format ###-##-####).
        */
       registration_number:
-        | BusinessBeneficiaryDataResponse.EinIdentification
-        | BusinessBeneficiaryDataResponse.SsnIdentification;
+        | V1BusinessBeneficiaryDataResponse.V1EinIdentification
+        | V1BusinessBeneficiaryDataResponse.V1SsnIdentification;
 
       /**
        * State or subdivision where the business is incorporated.
@@ -7150,8 +7242,8 @@ export namespace AccountHolderClosedWebhookEvent {
       year_of_incorporation: number;
     }
 
-    export namespace BusinessBeneficiaryDataResponse {
-      export interface UsBeneficiaryDataResponse {
+    export namespace V1BusinessBeneficiaryDataResponse {
+      export interface V1UsBeneficiaryDataResponse {
         /**
          * ISO 3166-1 alpha-2 country code of citizenship.
          */
@@ -7167,8 +7259,8 @@ export namespace AccountHolderClosedWebhookEvent {
          * format ###-##-####) or "itin" (Individual Taxpayer ID, format 9##-##-####).
          */
         identification:
-          | UsBeneficiaryDataResponse.SsnIdentification
-          | UsBeneficiaryDataResponse.ItinIdentification;
+          | V1UsBeneficiaryDataResponse.V1SsnIdentification
+          | V1UsBeneficiaryDataResponse.V1ItinIdentification;
 
         /**
          * Full legal name of the account holder.
@@ -7176,68 +7268,70 @@ export namespace AccountHolderClosedWebhookEvent {
         legal_name: string;
 
         /**
-         * Residential address of the account holder.
+         * Residential address of the account holder. **US address** requires
+         * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+         * other country and allows `state` to be null.
          */
         residential_address:
-          | UsBeneficiaryDataResponse.UsResidentialAddressResponse
-          | UsBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+          | V1UsBeneficiaryDataResponse.V1UsResidentialAddress
+          | V1UsBeneficiaryDataResponse.V1NonUsResidentialAddress;
       }
 
-      export namespace UsBeneficiaryDataResponse {
-        export interface SsnIdentification {
+      export namespace V1UsBeneficiaryDataResponse {
+        export interface V1SsnIdentification {
           type: 'ssn';
 
           value: string;
         }
 
-        export interface ItinIdentification {
+        export interface V1ItinIdentification {
           type: 'itin';
 
           value: string;
         }
 
-        export interface UsResidentialAddressResponse {
+        export interface V1UsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country: 'US';
+          country_code: 'US';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Two-letter state code.
+           * Secondary street address, or null if not recorded.
            */
-          state: string;
+          line_2: string | null;
 
           /**
-           * Primary street address.
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region.
            */
-          street_line_2: string | null;
+          state: string;
         }
 
-        export interface NonUsResidentialAddressResponse {
+        export interface V1NonUsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country:
+          country_code:
             | 'AF'
             | 'AL'
             | 'DZ'
@@ -7489,23 +7583,28 @@ export namespace AccountHolderClosedWebhookEvent {
             | 'XK';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Primary street address.
+           * Secondary street address, or null if not recorded.
+           */
+          line_2: string | null;
+
+          /**
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region, or null if not recorded.
            */
-          street_line_2: string | null;
+          state: string | null;
         }
       }
 
-      export interface NonUsBeneficiaryDataResponse {
+      export interface V1NonUsBeneficiaryDataResponse {
         /**
          * ISO 3166-1 alpha-2 country code of citizenship.
          */
@@ -7768,7 +7867,7 @@ export namespace AccountHolderClosedWebhookEvent {
         /**
          * Government-issued identification with type: "id" (generic government-issued ID).
          */
-        identification: NonUsBeneficiaryDataResponse.Identification;
+        identification: V1NonUsBeneficiaryDataResponse.Identification;
 
         /**
          * Full legal name of the account holder.
@@ -7776,14 +7875,16 @@ export namespace AccountHolderClosedWebhookEvent {
         legal_name: string;
 
         /**
-         * Residential address of the account holder.
+         * Residential address of the account holder. **US address** requires
+         * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+         * other country and allows `state` to be null.
          */
         residential_address:
-          | NonUsBeneficiaryDataResponse.UsResidentialAddressResponse
-          | NonUsBeneficiaryDataResponse.NonUsResidentialAddressResponse;
+          | V1NonUsBeneficiaryDataResponse.V1UsResidentialAddress
+          | V1NonUsBeneficiaryDataResponse.V1NonUsResidentialAddress;
       }
 
-      export namespace NonUsBeneficiaryDataResponse {
+      export namespace V1NonUsBeneficiaryDataResponse {
         /**
          * Government-issued identification with type: "id" (generic government-issued ID).
          */
@@ -7793,48 +7894,48 @@ export namespace AccountHolderClosedWebhookEvent {
           value: string;
         }
 
-        export interface UsResidentialAddressResponse {
+        export interface V1UsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country: 'US';
+          country_code: 'US';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Two-letter state code.
+           * Secondary street address, or null if not recorded.
            */
-          state: string;
+          line_2: string | null;
 
           /**
-           * Primary street address.
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region.
            */
-          street_line_2: string | null;
+          state: string;
         }
 
-        export interface NonUsResidentialAddressResponse {
+        export interface V1NonUsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country:
+          country_code:
             | 'AF'
             | 'AL'
             | 'DZ'
@@ -8086,19 +8187,24 @@ export namespace AccountHolderClosedWebhookEvent {
             | 'XK';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Primary street address.
+           * Secondary street address, or null if not recorded.
+           */
+          line_2: string | null;
+
+          /**
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region, or null if not recorded.
            */
-          street_line_2: string | null;
+          state: string | null;
         }
       }
 
@@ -8117,7 +8223,7 @@ export namespace AccountHolderClosedWebhookEvent {
          * Government-issued identification with type: "ssn" (Social Security Number,
          * format ###-##-####) or "itin" (Individual Taxpayer ID, format 9##-##-####).
          */
-        identification: UnionMember0.SsnIdentification | UnionMember0.ItinIdentification;
+        identification: UnionMember0.V1SsnIdentification | UnionMember0.V1ItinIdentification;
 
         /**
          * Full legal name of the account holder.
@@ -8125,11 +8231,11 @@ export namespace AccountHolderClosedWebhookEvent {
         legal_name: string;
 
         /**
-         * Residential address of the account holder.
+         * Residential address of the account holder. **US address** requires
+         * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+         * other country and allows `state` to be null.
          */
-        residential_address:
-          | UnionMember0.UsResidentialAddressResponse
-          | UnionMember0.NonUsResidentialAddressResponse;
+        residential_address: UnionMember0.V1UsResidentialAddress | UnionMember0.V1NonUsResidentialAddress;
 
         /**
          * Role of the control person at the business (e.g., "CEO", "President", "Managing
@@ -8139,60 +8245,60 @@ export namespace AccountHolderClosedWebhookEvent {
       }
 
       export namespace UnionMember0 {
-        export interface SsnIdentification {
+        export interface V1SsnIdentification {
           type: 'ssn';
 
           value: string;
         }
 
-        export interface ItinIdentification {
+        export interface V1ItinIdentification {
           type: 'itin';
 
           value: string;
         }
 
-        export interface UsResidentialAddressResponse {
+        export interface V1UsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country: 'US';
+          country_code: 'US';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Two-letter state code.
+           * Secondary street address, or null if not recorded.
            */
-          state: string;
+          line_2: string | null;
 
           /**
-           * Primary street address.
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region.
            */
-          street_line_2: string | null;
+          state: string;
         }
 
-        export interface NonUsResidentialAddressResponse {
+        export interface V1NonUsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country:
+          country_code:
             | 'AF'
             | 'AL'
             | 'DZ'
@@ -8444,19 +8550,24 @@ export namespace AccountHolderClosedWebhookEvent {
             | 'XK';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Primary street address.
+           * Secondary street address, or null if not recorded.
+           */
+          line_2: string | null;
+
+          /**
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region, or null if not recorded.
            */
-          street_line_2: string | null;
+          state: string | null;
         }
       }
 
@@ -8731,11 +8842,11 @@ export namespace AccountHolderClosedWebhookEvent {
         legal_name: string;
 
         /**
-         * Residential address of the account holder.
+         * Residential address of the account holder. **US address** requires
+         * `country_code: US` and a two-letter `state`. **Non-US address** accepts any
+         * other country and allows `state` to be null.
          */
-        residential_address:
-          | UnionMember1.UsResidentialAddressResponse
-          | UnionMember1.NonUsResidentialAddressResponse;
+        residential_address: UnionMember1.V1UsResidentialAddress | UnionMember1.V1NonUsResidentialAddress;
 
         /**
          * Role of the control person at the business (e.g., "CEO", "President", "Managing
@@ -8754,48 +8865,48 @@ export namespace AccountHolderClosedWebhookEvent {
           value: string;
         }
 
-        export interface UsResidentialAddressResponse {
+        export interface V1UsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country: 'US';
+          country_code: 'US';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Two-letter state code.
+           * Secondary street address, or null if not recorded.
            */
-          state: string;
+          line_2: string | null;
 
           /**
-           * Primary street address.
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region.
            */
-          street_line_2: string | null;
+          state: string;
         }
 
-        export interface NonUsResidentialAddressResponse {
+        export interface V1NonUsResidentialAddress {
           /**
-           * City name.
+           * City or locality.
            */
           city: string;
 
           /**
            * ISO 3166-1 alpha-2 country code.
            */
-          country:
+          country_code:
             | 'AF'
             | 'AL'
             | 'DZ'
@@ -9047,64 +9158,69 @@ export namespace AccountHolderClosedWebhookEvent {
             | 'XK';
 
           /**
-           * Postal or ZIP code.
+           * Primary street address.
            */
-          postal_code: string;
+          line_1: string;
 
           /**
-           * Primary street address.
+           * Secondary street address, or null if not recorded.
+           */
+          line_2: string | null;
+
+          /**
+           * Postal or ZIP code.
            */
-          street_line_1: string;
+          postal_code: string;
 
           /**
-           * Secondary street address (apartment, suite, etc.).
+           * State, province, or region, or null if not recorded.
            */
-          street_line_2: string | null;
+          state: string | null;
         }
       }
 
-      export interface UsResidentialAddressResponse {
+      export interface V1UsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country: 'US';
+        country_code: 'US';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Two-letter state code.
+         * Secondary street address, or null if not recorded.
          */
-        state: string;
+        line_2: string | null;
 
         /**
-         * Primary street address.
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region.
          */
-        street_line_2: string | null;
+        state: string;
       }
 
-      export interface NonUsResidentialAddressResponse {
+      export interface V1NonUsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country:
+        country_code:
           | 'AF'
           | 'AL'
           | 'DZ'
@@ -9356,63 +9472,68 @@ export namespace AccountHolderClosedWebhookEvent {
           | 'XK';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Primary street address.
+         * Secondary street address, or null if not recorded.
+         */
+        line_2: string | null;
+
+        /**
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region, or null if not recorded.
          */
-        street_line_2: string | null;
+        state: string | null;
       }
 
-      export interface UsResidentialAddressResponse {
+      export interface V1UsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country: 'US';
+        country_code: 'US';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Two-letter state code.
+         * Secondary street address, or null if not recorded.
          */
-        state: string;
+        line_2: string | null;
 
         /**
-         * Primary street address.
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region.
          */
-        street_line_2: string | null;
+        state: string;
       }
 
-      export interface NonUsResidentialAddressResponse {
+      export interface V1NonUsResidentialAddress {
         /**
-         * City name.
+         * City or locality.
          */
         city: string;
 
         /**
          * ISO 3166-1 alpha-2 country code.
          */
-        country:
+        country_code:
           | 'AF'
           | 'AL'
           | 'DZ'
@@ -9664,28 +9785,33 @@ export namespace AccountHolderClosedWebhookEvent {
           | 'XK';
 
         /**
-         * Postal or ZIP code.
+         * Primary street address.
          */
-        postal_code: string;
+        line_1: string;
 
         /**
-         * Primary street address.
+         * Secondary street address, or null if not recorded.
+         */
+        line_2: string | null;
+
+        /**
+         * Postal or ZIP code.
          */
-        street_line_1: string;
+        postal_code: string;
 
         /**
-         * Secondary street address (apartment, suite, etc.).
+         * State, province, or region, or null if not recorded.
          */
-        street_line_2: string | null;
+        state: string | null;
       }
 
-      export interface EinIdentification {
+      export interface V1EinIdentification {
         type: 'ein';
 
         value: string;
       }
 
-      export interface SsnIdentification {
+      export interface V1SsnIdentification {
         type: 'ssn';
 
         value: string;
@@ -9755,15 +9881,17 @@ export namespace PingTestWebhookEvent {
 }
 
 export type UnwrapWebhookEvent =
-  | PayoutCreatedWebhookEvent
   | PayoutInitiatedWebhookEvent
-  | PayoutPaidWebhookEvent
+  | PayoutSubmittedWebhookEvent
+  | PayoutSentWebhookEvent
   | PayoutFailedWebhookEvent
+  | PayoutReturnedWebhookEvent
   | ReturnInitiatedWebhookEvent
-  | ReturnPaidWebhookEvent
+  | ReturnSubmittedWebhookEvent
+  | ReturnSentWebhookEvent
   | ReturnFailedWebhookEvent
   | ReturnReturnedWebhookEvent
-  | DepositReceivedWebhookEvent
+  | DepositSettledWebhookEvent
   | ConversionCreatedWebhookEvent
   | ConversionCompletedWebhookEvent
   | ConversionFailedWebhookEvent
@@ -9773,15 +9901,17 @@ export type UnwrapWebhookEvent =
 
 export declare namespace Webhooks {
   export {
-    type PayoutCreatedWebhookEvent as PayoutCreatedWebhookEvent,
     type PayoutInitiatedWebhookEvent as PayoutInitiatedWebhookEvent,
-    type PayoutPaidWebhookEvent as PayoutPaidWebhookEvent,
+    type PayoutSubmittedWebhookEvent as PayoutSubmittedWebhookEvent,
+    type PayoutSentWebhookEvent as PayoutSentWebhookEvent,
     type PayoutFailedWebhookEvent as PayoutFailedWebhookEvent,
+    type PayoutReturnedWebhookEvent as PayoutReturnedWebhookEvent,
     type ReturnInitiatedWebhookEvent as ReturnInitiatedWebhookEvent,
-    type ReturnPaidWebhookEvent as ReturnPaidWebhookEvent,
+    type ReturnSubmittedWebhookEvent as ReturnSubmittedWebhookEvent,
+    type ReturnSentWebhookEvent as ReturnSentWebhookEvent,
     type ReturnFailedWebhookEvent as ReturnFailedWebhookEvent,
     type ReturnReturnedWebhookEvent as ReturnReturnedWebhookEvent,
-    type DepositReceivedWebhookEvent as DepositReceivedWebhookEvent,
+    type DepositSettledWebhookEvent as DepositSettledWebhookEvent,
     type ConversionCreatedWebhookEvent as ConversionCreatedWebhookEvent,
     type ConversionCompletedWebhookEvent as ConversionCompletedWebhookEvent,
     type ConversionFailedWebhookEvent as ConversionFailedWebhookEvent,