@depup/stripe 21.0.0-depup.0

package/types/Treasury/OutboundPaymentsResource.d.ts

@@ -0,0 +1,285 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace Treasury {
+      interface OutboundPaymentCreateParams {
+        /**
+         * Amount (in cents) to be transferred.
+         */
+        amount: number;
+
+        /**
+         * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+         */
+        currency: string;
+
+        /**
+         * The FinancialAccount to pull funds from.
+         */
+        financial_account: string;
+
+        /**
+         * ID of the customer to whom the OutboundPayment is sent. Must match the Customer attached to the `destination_payment_method` passed in.
+         */
+        customer?: string;
+
+        /**
+         * An arbitrary string attached to the object. Often useful for displaying to users.
+         */
+        description?: string;
+
+        /**
+         * The PaymentMethod to use as the payment instrument for the OutboundPayment. Exclusive with `destination_payment_method_data`.
+         */
+        destination_payment_method?: string;
+
+        /**
+         * Hash used to generate the PaymentMethod to be used for this OutboundPayment. Exclusive with `destination_payment_method`.
+         */
+        destination_payment_method_data?: OutboundPaymentCreateParams.DestinationPaymentMethodData;
+
+        /**
+         * Payment method-specific configuration for this OutboundPayment.
+         */
+        destination_payment_method_options?: OutboundPaymentCreateParams.DestinationPaymentMethodOptions;
+
+        /**
+         * End user details.
+         */
+        end_user_details?: OutboundPaymentCreateParams.EndUserDetails;
+
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+
+        /**
+         * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+         */
+        metadata?: Stripe.MetadataParam;
+
+        /**
+         * The description that appears on the receiving end for this OutboundPayment (for example, bank statement for external bank transfer). Maximum 10 characters for `ach` payments, 140 characters for `us_domestic_wire` payments, or 500 characters for `stripe` network transfers. Can only include -#.$&*, spaces, and alphanumeric characters. The default value is "payment".
+         */
+        statement_descriptor?: string;
+      }
+
+      namespace OutboundPaymentCreateParams {
+        interface DestinationPaymentMethodData {
+          /**
+           * Billing information associated with the PaymentMethod that may be used or required by particular types of payment methods.
+           */
+          billing_details?: DestinationPaymentMethodData.BillingDetails;
+
+          /**
+           * Required if type is set to `financial_account`. The FinancialAccount ID to send funds to.
+           */
+          financial_account?: string;
+
+          /**
+           * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+           */
+          metadata?: Stripe.MetadataParam;
+
+          /**
+           * The type of the PaymentMethod. An additional hash is included on the PaymentMethod with a name matching this value. It contains additional information specific to the PaymentMethod type.
+           */
+          type: DestinationPaymentMethodData.Type;
+
+          /**
+           * Required hash if type is set to `us_bank_account`.
+           */
+          us_bank_account?: DestinationPaymentMethodData.UsBankAccount;
+        }
+
+        namespace DestinationPaymentMethodData {
+          interface BillingDetails {
+            /**
+             * Billing address.
+             */
+            address?: Stripe.Emptyable<Stripe.AddressParam>;
+
+            /**
+             * Email address.
+             */
+            email?: Stripe.Emptyable<string>;
+
+            /**
+             * Full name.
+             */
+            name?: Stripe.Emptyable<string>;
+
+            /**
+             * Billing phone number (including extension).
+             */
+            phone?: Stripe.Emptyable<string>;
+          }
+
+          type Type = 'financial_account' | 'us_bank_account';
+
+          interface UsBankAccount {
+            /**
+             * Account holder type: individual or company.
+             */
+            account_holder_type?: UsBankAccount.AccountHolderType;
+
+            /**
+             * Account number of the bank account.
+             */
+            account_number?: string;
+
+            /**
+             * Account type: checkings or savings. Defaults to checking if omitted.
+             */
+            account_type?: UsBankAccount.AccountType;
+
+            /**
+             * The ID of a Financial Connections Account to use as a payment method.
+             */
+            financial_connections_account?: string;
+
+            /**
+             * Routing number of the bank account.
+             */
+            routing_number?: string;
+          }
+
+          namespace UsBankAccount {
+            type AccountHolderType = 'company' | 'individual';
+
+            type AccountType = 'checking' | 'savings';
+          }
+        }
+
+        interface DestinationPaymentMethodOptions {
+          /**
+           * Optional fields for `us_bank_account`.
+           */
+          us_bank_account?: Stripe.Emptyable<
+            DestinationPaymentMethodOptions.UsBankAccount
+          >;
+        }
+
+        namespace DestinationPaymentMethodOptions {
+          interface UsBankAccount {
+            /**
+             * Specifies the network rails to be used. If not set, will default to the PaymentMethod's preferred network. See the [docs](https://docs.stripe.com/treasury/money-movement/timelines) to learn more about money movement timelines for each network type.
+             */
+            network?: UsBankAccount.Network;
+          }
+
+          namespace UsBankAccount {
+            type Network = 'ach' | 'us_domestic_wire';
+          }
+        }
+
+        interface EndUserDetails {
+          /**
+           * IP address of the user initiating the OutboundPayment. Must be supplied if `present` is set to `true`.
+           */
+          ip_address?: string;
+
+          /**
+           * `True` if the OutboundPayment creation request is being made on behalf of an end user by a platform. Otherwise, `false`.
+           */
+          present: boolean;
+        }
+      }
+
+      interface OutboundPaymentRetrieveParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      interface OutboundPaymentListParams extends PaginationParams {
+        /**
+         * Returns objects associated with this FinancialAccount.
+         */
+        financial_account: string;
+
+        /**
+         * Only return OutboundPayments that were created during the given date interval.
+         */
+        created?: Stripe.RangeQueryParam | number;
+
+        /**
+         * Only return OutboundPayments sent to this customer.
+         */
+        customer?: string;
+
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+
+        /**
+         * Only return OutboundPayments that have the given status: `processing`, `failed`, `posted`, `returned`, or `canceled`.
+         */
+        status?: OutboundPaymentListParams.Status;
+      }
+
+      namespace OutboundPaymentListParams {
+        type Status =
+          | 'canceled'
+          | 'failed'
+          | 'posted'
+          | 'processing'
+          | 'returned';
+      }
+
+      interface OutboundPaymentCancelParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      class OutboundPaymentsResource {
+        /**
+         * Creates an OutboundPayment.
+         */
+        create(
+          params: OutboundPaymentCreateParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Treasury.OutboundPayment>>;
+
+        /**
+         * Retrieves the details of an existing OutboundPayment by passing the unique OutboundPayment ID from either the OutboundPayment creation request or OutboundPayment list.
+         */
+        retrieve(
+          id: string,
+          params?: OutboundPaymentRetrieveParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Treasury.OutboundPayment>>;
+        retrieve(
+          id: string,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Treasury.OutboundPayment>>;
+
+        /**
+         * Returns a list of OutboundPayments sent from the specified FinancialAccount.
+         */
+        list(
+          params: OutboundPaymentListParams,
+          options?: RequestOptions
+        ): ApiListPromise<Stripe.Treasury.OutboundPayment>;
+
+        /**
+         * Cancel an OutboundPayment.
+         */
+        cancel(
+          id: string,
+          params?: OutboundPaymentCancelParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Treasury.OutboundPayment>>;
+        cancel(
+          id: string,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Treasury.OutboundPayment>>;
+      }
+    }
+  }
+}

package/types/Treasury/OutboundTransfers.d.ts

@@ -0,0 +1,299 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace Treasury {
+      /**
+       * Use [OutboundTransfers](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-transfers) to transfer funds from a [FinancialAccount](https://api.stripe.com#financial_accounts) to a PaymentMethod belonging to the same entity. To send funds to a different party, use [OutboundPayments](https://api.stripe.com#outbound_payments) instead. You can send funds over ACH rails or through a domestic wire transfer to a user's own external bank account.
+       *
+       * Simulate OutboundTransfer state changes with the `/v1/test_helpers/treasury/outbound_transfers` endpoints. These methods can only be called on test mode objects.
+       *
+       * Related guide: [Moving money with Treasury using OutboundTransfer objects](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-transfers)
+       */
+      interface OutboundTransfer {
+        /**
+         * Unique identifier for the object.
+         */
+        id: string;
+
+        /**
+         * String representing the object's type. Objects of the same type share the same value.
+         */
+        object: 'treasury.outbound_transfer';
+
+        /**
+         * Amount (in cents) transferred.
+         */
+        amount: number;
+
+        /**
+         * Returns `true` if the object can be canceled, and `false` otherwise.
+         */
+        cancelable: boolean;
+
+        /**
+         * Time at which the object was created. Measured in seconds since the Unix epoch.
+         */
+        created: number;
+
+        /**
+         * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+         */
+        currency: string;
+
+        /**
+         * An arbitrary string attached to the object. Often useful for displaying to users.
+         */
+        description: string | null;
+
+        /**
+         * The PaymentMethod used as the payment instrument for an OutboundTransfer.
+         */
+        destination_payment_method: string | null;
+
+        destination_payment_method_details: OutboundTransfer.DestinationPaymentMethodDetails;
+
+        /**
+         * The date when funds are expected to arrive in the destination account.
+         */
+        expected_arrival_date: number;
+
+        /**
+         * The FinancialAccount that funds were pulled from.
+         */
+        financial_account: string;
+
+        /**
+         * A [hosted transaction receipt](https://docs.stripe.com/treasury/moving-money/regulatory-receipts) URL that is provided when money movement is considered regulated under Stripe's money transmission licenses.
+         */
+        hosted_regulatory_receipt_url: string | null;
+
+        /**
+         * If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
+         */
+        livemode: boolean;
+
+        /**
+         * Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+         */
+        metadata: Stripe.Metadata;
+
+        /**
+         * Details about a returned OutboundTransfer. Only set when the status is `returned`.
+         */
+        returned_details: OutboundTransfer.ReturnedDetails | null;
+
+        /**
+         * Information about the OutboundTransfer to be sent to the recipient account.
+         */
+        statement_descriptor: string;
+
+        /**
+         * Current status of the OutboundTransfer: `processing`, `failed`, `canceled`, `posted`, `returned`. An OutboundTransfer is `processing` if it has been created and is pending. The status changes to `posted` once the OutboundTransfer has been "confirmed" and funds have left the account, or to `failed` or `canceled`. If an OutboundTransfer fails to arrive at its destination, its status will change to `returned`.
+         */
+        status: OutboundTransfer.Status;
+
+        status_transitions: OutboundTransfer.StatusTransitions;
+
+        /**
+         * Details about network-specific tracking information if available.
+         */
+        tracking_details: OutboundTransfer.TrackingDetails | null;
+
+        /**
+         * The Transaction associated with this object.
+         */
+        transaction: string | Stripe.Treasury.Transaction;
+      }
+
+      namespace OutboundTransfer {
+        interface DestinationPaymentMethodDetails {
+          billing_details: DestinationPaymentMethodDetails.BillingDetails;
+
+          financial_account?: DestinationPaymentMethodDetails.FinancialAccount;
+
+          /**
+           * The type of the payment method used in the OutboundTransfer.
+           */
+          type: DestinationPaymentMethodDetails.Type;
+
+          us_bank_account?: DestinationPaymentMethodDetails.UsBankAccount;
+        }
+
+        namespace DestinationPaymentMethodDetails {
+          interface BillingDetails {
+            address: Stripe.Address;
+
+            /**
+             * Email address.
+             */
+            email: string | null;
+
+            /**
+             * Full name.
+             */
+            name: string | null;
+          }
+
+          interface FinancialAccount {
+            /**
+             * Token of the FinancialAccount.
+             */
+            id: string;
+
+            /**
+             * The rails used to send funds.
+             */
+            network: 'stripe';
+          }
+
+          type Type = 'financial_account' | 'us_bank_account';
+
+          interface UsBankAccount {
+            /**
+             * Account holder type: individual or company.
+             */
+            account_holder_type: UsBankAccount.AccountHolderType | null;
+
+            /**
+             * Account type: checkings or savings. Defaults to checking if omitted.
+             */
+            account_type: UsBankAccount.AccountType | null;
+
+            /**
+             * Name of the bank associated with the bank account.
+             */
+            bank_name: string | null;
+
+            /**
+             * Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same.
+             */
+            fingerprint: string | null;
+
+            /**
+             * Last four digits of the bank account number.
+             */
+            last4: string | null;
+
+            /**
+             * ID of the mandate used to make this payment.
+             */
+            mandate?: string | Stripe.Mandate;
+
+            /**
+             * The network rails used. See the [docs](https://docs.stripe.com/treasury/money-movement/timelines) to learn more about money movement timelines for each network type.
+             */
+            network: UsBankAccount.Network;
+
+            /**
+             * Routing number of the bank account.
+             */
+            routing_number: string | null;
+          }
+
+          namespace UsBankAccount {
+            type AccountHolderType = 'company' | 'individual';
+
+            type AccountType = 'checking' | 'savings';
+
+            type Network = 'ach' | 'us_domestic_wire';
+          }
+        }
+
+        interface ReturnedDetails {
+          /**
+           * Reason for the return.
+           */
+          code: ReturnedDetails.Code;
+
+          /**
+           * The Transaction associated with this object.
+           */
+          transaction: string | Stripe.Treasury.Transaction;
+        }
+
+        namespace ReturnedDetails {
+          type Code =
+            | 'account_closed'
+            | 'account_frozen'
+            | 'bank_account_restricted'
+            | 'bank_ownership_changed'
+            | 'declined'
+            | 'incorrect_account_holder_name'
+            | 'invalid_account_number'
+            | 'invalid_currency'
+            | 'no_account'
+            | 'other';
+        }
+
+        type Status =
+          | 'canceled'
+          | 'failed'
+          | 'posted'
+          | 'processing'
+          | 'returned';
+
+        interface StatusTransitions {
+          /**
+           * Timestamp describing when an OutboundTransfer changed status to `canceled`
+           */
+          canceled_at: number | null;
+
+          /**
+           * Timestamp describing when an OutboundTransfer changed status to `failed`
+           */
+          failed_at: number | null;
+
+          /**
+           * Timestamp describing when an OutboundTransfer changed status to `posted`
+           */
+          posted_at: number | null;
+
+          /**
+           * Timestamp describing when an OutboundTransfer changed status to `returned`
+           */
+          returned_at: number | null;
+        }
+
+        interface TrackingDetails {
+          ach?: TrackingDetails.Ach;
+
+          /**
+           * The US bank account network used to send funds.
+           */
+          type: TrackingDetails.Type;
+
+          us_domestic_wire?: TrackingDetails.UsDomesticWire;
+        }
+
+        namespace TrackingDetails {
+          interface Ach {
+            /**
+             * ACH trace ID of the OutboundTransfer for transfers sent over the `ach` network.
+             */
+            trace_id: string;
+          }
+
+          type Type = 'ach' | 'us_domestic_wire';
+
+          interface UsDomesticWire {
+            /**
+             * CHIPS System Sequence Number (SSN) of the OutboundTransfer for transfers sent over the `us_domestic_wire` network.
+             */
+            chips: string | null;
+
+            /**
+             * IMAD of the OutboundTransfer for transfers sent over the `us_domestic_wire` network.
+             */
+            imad: string | null;
+
+            /**
+             * OMAD of the OutboundTransfer for transfers sent over the `us_domestic_wire` network.
+             */
+            omad: string | null;
+          }
+        }
+      }
+    }
+  }
+}