increase 1.361.0 → 1.362.0

data/lib/increase/resources/ach_transfers.rb

@@ -3,16 +3,27 @@
 module Increase
   module Resources
     class ACHTransfers
-      # Create an ACH Transfer
+      # An ACH Transfer has two primary descriptive fields:
+      # [`company_name`](/documentation/api/ach-transfers#create-an-ach-transfer.company_name)
+      # and
+      # [`individual_name`](/documentation/api/ach-transfers#create-an-ach-transfer.individual_name).
+      # You should set both of these, in addition to the required amount and account
+      # fields.
       #
       # @overload create(account_id:, amount:, statement_descriptor:, account_number: nil, addenda: nil, company_descriptive_date: nil, company_discretionary_data: nil, company_entry_description: nil, company_name: nil, destination_account_holder: nil, external_account_id: nil, funding: nil, individual_id: nil, individual_name: nil, preferred_effective_date: nil, require_approval: nil, routing_number: nil, standard_entry_class_code: nil, request_options: {})
       #
-      # @param account_id [String] The Increase identifier for the account that will send the transfer.
+      # @param account_id [String]
+      #   The Increase identifier for the account that will originate the transfer. For
+      #   credit transfers (transfers with a positive `amount`), this is the account that
+      #   funds will be sent from. For debit transfers (transfers with a negative
+      #   `amount`), this is the account that funds will be pulled into.
       #
       # @param amount [Integer]
       #   The transfer amount in USD cents. A positive amount originates a credit transfer
-      #   pushing funds to the receiving account. A negative amount originates a debit
-      #   transfer pulling funds from the receiving account.
+      #   pushing funds from Increase to the account at the other bank. A negative amount
+      #   originates a debit transfer pulling funds from the account at the other bank
+      #   into Increase. Debit transfers
+      #   [might result in a hold before funds are available](/documentation/sending-ach-debit-transfers).
       #
       # @param statement_descriptor [String]
       #   A description you choose to give the transfer. This will be saved with the
@@ -23,9 +34,10 @@ module Increase
       #   `individual_name` and `company_name` instead of relying on this fallback.
       #
       # @param account_number [String]
-      #   The receiver's account number. For credit transfers (positive `amount`) this is
-      #   the account that funds will be sent to. For debit transfers (negative `amount`)
-      #   this is the account that funds will be pulled from.
+      #   The receiver's account number. For credit transfers (transfers with a positive
+      #   `amount`), this is the account that funds will be sent to. For debit transfers
+      #   (transfers with a negative `amount`), this is the account that funds will be
+      #   pulled from.
       #
       # @param addenda [Increase::Models::ACHTransferCreateParams::Addenda]
       #   Additional information passed through to the receiving bank with the transfer.
@@ -39,21 +51,26 @@ module Increase
       #   settlement timing, or returns. Only set this if your recipient has asked for it.
       #
       # @param company_discretionary_data [String]
-      #   Custom data sent in the company batch header. This value is informational and
-      #   does not affect funds movement, settlement timing, or returns. Most ACH
-      #   transfers do not need this. Only set this if your recipient has asked for it.
+      #   Custom data sent in the company batch header, meant as metadata for the
+      #   originator. This value is informational and does not affect funds movement,
+      #   settlement timing, or returns. Most ACH transfers do not need this; we recommend
+      #   storing metadata in your own application instead.
       #
       # @param company_entry_description [String]
-      #   A short description sent in the company batch header. Most receivers do not
-      #   surface this. Only set this if your recipient has asked for a specific value or
-      #   if Nacha mandates one for your Standard Entry Class (SEC) code and use case. For
-      #   example, Prearranged Payment and Deposit (PPD) payroll credits must use
-      #   `PAYROLL`, and reversals must use `REVERSAL`.
+      #   A short description sent in the company batch header, meant to provide the
+      #   receiver with a reason for the transfer. Many receivers do not surface this data
+      #   on the receiver's bank statement. Only set this if your recipient has asked for
+      #   a specific value or if Nacha mandates one for your Standard Entry Class (SEC)
+      #   code and use case. For example, some use cases require constants like
+      #   `ACCTVERIFY`, `PURCHASE`, `PAYROLL`, or `REVERSAL`.
       #
       # @param company_name [String]
-      #   The name by which the recipient knows you, sent in the company batch header. We
-      #   recommend setting this on every transfer; if you do not, we fall back to the
-      #   `statement_descriptor`.
+      #   The name by which the recipient knows the counterparty of this transaction. If
+      #   you're processing payments on behalf of another party, use their name, not your
+      #   own, so that it's more likely the recipient understands the context of the
+      #   payment. This value is usually displayed to the recipient on their bank
+      #   statement. We recommend setting this on every transfer; if you do not, we fall
+      #   back to the `statement_descriptor`.
       #
       # @param destination_account_holder [Symbol, Increase::Models::ACHTransferCreateParams::DestinationAccountHolder]
       #   The type of entity that owns the receiver's account.
@@ -68,12 +85,16 @@ module Increase
       #   Defaults to `checking`.
       #
       # @param individual_id [String]
-      #   Your internal identifier for the transfer recipient. This value is informational
-      #   and not verified by the recipient's bank. Most callers can leave this unset.
+      #   Your internal identifier for the recipient. This value is informational and
+      #   generally not verified by the recipient's bank. Most callers can leave this
+      #   unset. For the specific case of person-to-person credits with the WEB standard
+      #   entry class code, this must include the name of the payer.
       #
       # @param individual_name [String]
-      #   The name of the transfer recipient. This value is informational and not verified
-      #   by the recipient's bank.
+      #   The name of the transfer recipient. This value is informational and generally
+      #   not verified by the recipient's bank. This value is usually displayed to the
+      #   recipient on their bank statement. We recommend setting this on every transfer;
+      #   if you do not, we fall back to the `statement_descriptor`.
       #
       # @param preferred_effective_date [Increase::Models::ACHTransferCreateParams::PreferredEffectiveDate]
       #   Configuration for how the effective date of the transfer will be set. This

data/lib/increase/resources/simulations/wire_drawdown_requests.rb

@@ -6,21 +6,31 @@ module Increase
       class WireDrawdownRequests
         # Simulates a Wire Drawdown Request being refused by the debtor.
         #
-        # @overload refuse(wire_drawdown_request_id, request_options: {})
+        # @overload refuse(wire_drawdown_request_id, refusal_reason_additional_information: nil, refusal_reason_code: nil, request_options: {})
         #
         # @param wire_drawdown_request_id [String] The identifier of the Wire Drawdown Request you wish to refuse.
         #
+        # @param refusal_reason_additional_information [String]
+        #   Additional information about the refusal that the simulated refusal will have.
+        #
+        # @param refusal_reason_code [Symbol, Increase::Models::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode]
+        #   The reason code that the simulated refusal will have.
+        #
+        #   Defaults to `other`.
+        #
         # @param request_options [Increase::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [Increase::Models::WireDrawdownRequest]
         #
         # @see Increase::Models::Simulations::WireDrawdownRequestRefuseParams
         def refuse(wire_drawdown_request_id, params = {})
+          parsed, options = Increase::Simulations::WireDrawdownRequestRefuseParams.dump_request(params)
           @client.request(
             method: :post,
             path: ["simulations/wire_drawdown_requests/%1$s/refuse", wire_drawdown_request_id],
+            body: parsed,
             model: Increase::WireDrawdownRequest,
-            options: params[:request_options]
+            options: options
           )
         end
 

data/lib/increase/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Increase
-  VERSION = "1.361.0"
+  VERSION = "1.362.0"
 end

data/rbi/increase/internal/util.rbi

@@ -363,7 +363,9 @@ module Increase
         #
         # https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.1.md#special-considerations-for-multipart-content
         sig do
-          params(body: T.anything).returns([String, T::Enumerable[String]])
+          params(body: T.anything).returns(
+            [String, T.proc.returns(T::Enumerable[String])]
+          )
         end
         private def encode_multipart_streaming(body)
         end

data/rbi/increase/models/ach_transfer_create_params.rbi

@@ -11,13 +11,18 @@ module Increase
           T.any(Increase::ACHTransferCreateParams, Increase::Internal::AnyHash)
         end
 
-      # The Increase identifier for the account that will send the transfer.
+      # The Increase identifier for the account that will originate the transfer. For
+      # credit transfers (transfers with a positive `amount`), this is the account that
+      # funds will be sent from. For debit transfers (transfers with a negative
+      # `amount`), this is the account that funds will be pulled into.
       sig { returns(String) }
       attr_accessor :account_id
 
       # The transfer amount in USD cents. A positive amount originates a credit transfer
-      # pushing funds to the receiving account. A negative amount originates a debit
-      # transfer pulling funds from the receiving account.
+      # pushing funds from Increase to the account at the other bank. A negative amount
+      # originates a debit transfer pulling funds from the account at the other bank
+      # into Increase. Debit transfers
+      # [might result in a hold before funds are available](/documentation/sending-ach-debit-transfers).
       sig { returns(Integer) }
       attr_accessor :amount
 
@@ -30,9 +35,10 @@ module Increase
       sig { returns(String) }
       attr_accessor :statement_descriptor
 
-      # The receiver's account number. For credit transfers (positive `amount`) this is
-      # the account that funds will be sent to. For debit transfers (negative `amount`)
-      # this is the account that funds will be pulled from.
+      # The receiver's account number. For credit transfers (transfers with a positive
+      # `amount`), this is the account that funds will be sent to. For debit transfers
+      # (transfers with a negative `amount`), this is the account that funds will be
+      # pulled from.
       sig { returns(T.nilable(String)) }
       attr_reader :account_number
 
@@ -60,29 +66,34 @@ module Increase
       sig { params(company_descriptive_date: String).void }
       attr_writer :company_descriptive_date
 
-      # Custom data sent in the company batch header. This value is informational and
-      # does not affect funds movement, settlement timing, or returns. Most ACH
-      # transfers do not need this. Only set this if your recipient has asked for it.
+      # Custom data sent in the company batch header, meant as metadata for the
+      # originator. This value is informational and does not affect funds movement,
+      # settlement timing, or returns. Most ACH transfers do not need this; we recommend
+      # storing metadata in your own application instead.
       sig { returns(T.nilable(String)) }
       attr_reader :company_discretionary_data
 
       sig { params(company_discretionary_data: String).void }
       attr_writer :company_discretionary_data
 
-      # A short description sent in the company batch header. Most receivers do not
-      # surface this. Only set this if your recipient has asked for a specific value or
-      # if Nacha mandates one for your Standard Entry Class (SEC) code and use case. For
-      # example, Prearranged Payment and Deposit (PPD) payroll credits must use
-      # `PAYROLL`, and reversals must use `REVERSAL`.
+      # A short description sent in the company batch header, meant to provide the
+      # receiver with a reason for the transfer. Many receivers do not surface this data
+      # on the receiver's bank statement. Only set this if your recipient has asked for
+      # a specific value or if Nacha mandates one for your Standard Entry Class (SEC)
+      # code and use case. For example, some use cases require constants like
+      # `ACCTVERIFY`, `PURCHASE`, `PAYROLL`, or `REVERSAL`.
       sig { returns(T.nilable(String)) }
       attr_reader :company_entry_description
 
       sig { params(company_entry_description: String).void }
       attr_writer :company_entry_description
 
-      # The name by which the recipient knows you, sent in the company batch header. We
-      # recommend setting this on every transfer; if you do not, we fall back to the
-      # `statement_descriptor`.
+      # The name by which the recipient knows the counterparty of this transaction. If
+      # you're processing payments on behalf of another party, use their name, not your
+      # own, so that it's more likely the recipient understands the context of the
+      # payment. This value is usually displayed to the recipient on their bank
+      # statement. We recommend setting this on every transfer; if you do not, we fall
+      # back to the `statement_descriptor`.
       sig { returns(T.nilable(String)) }
       attr_reader :company_name
 
@@ -130,16 +141,20 @@ module Increase
       end
       attr_writer :funding
 
-      # Your internal identifier for the transfer recipient. This value is informational
-      # and not verified by the recipient's bank. Most callers can leave this unset.
+      # Your internal identifier for the recipient. This value is informational and
+      # generally not verified by the recipient's bank. Most callers can leave this
+      # unset. For the specific case of person-to-person credits with the WEB standard
+      # entry class code, this must include the name of the payer.
       sig { returns(T.nilable(String)) }
       attr_reader :individual_id
 
       sig { params(individual_id: String).void }
       attr_writer :individual_id
 
-      # The name of the transfer recipient. This value is informational and not verified
-      # by the recipient's bank.
+      # The name of the transfer recipient. This value is informational and generally
+      # not verified by the recipient's bank. This value is usually displayed to the
+      # recipient on their bank statement. We recommend setting this on every transfer;
+      # if you do not, we fall back to the `statement_descriptor`.
       sig { returns(T.nilable(String)) }
       attr_reader :individual_name
 
@@ -228,11 +243,16 @@ module Increase
         ).returns(T.attached_class)
       end
       def self.new(
-        # The Increase identifier for the account that will send the transfer.
+        # The Increase identifier for the account that will originate the transfer. For
+        # credit transfers (transfers with a positive `amount`), this is the account that
+        # funds will be sent from. For debit transfers (transfers with a negative
+        # `amount`), this is the account that funds will be pulled into.
         account_id:,
         # The transfer amount in USD cents. A positive amount originates a credit transfer
-        # pushing funds to the receiving account. A negative amount originates a debit
-        # transfer pulling funds from the receiving account.
+        # pushing funds from Increase to the account at the other bank. A negative amount
+        # originates a debit transfer pulling funds from the account at the other bank
+        # into Increase. Debit transfers
+        # [might result in a hold before funds are available](/documentation/sending-ach-debit-transfers).
         amount:,
         # A description you choose to give the transfer. This will be saved with the
         # transfer details, displayed in the dashboard, and returned by the API. If
@@ -241,9 +261,10 @@ module Increase
         # help the customer recognize the transfer. You are highly encouraged to pass
         # `individual_name` and `company_name` instead of relying on this fallback.
         statement_descriptor:,
-        # The receiver's account number. For credit transfers (positive `amount`) this is
-        # the account that funds will be sent to. For debit transfers (negative `amount`)
-        # this is the account that funds will be pulled from.
+        # The receiver's account number. For credit transfers (transfers with a positive
+        # `amount`), this is the account that funds will be sent to. For debit transfers
+        # (transfers with a negative `amount`), this is the account that funds will be
+        # pulled from.
         account_number: nil,
         # Additional information passed through to the receiving bank with the transfer.
         # Most ACH transfers do not need this. Only set this if your recipient has asked
@@ -254,19 +275,24 @@ module Increase
         # batch header. This value is informational and does not affect funds movement,
         # settlement timing, or returns. Only set this if your recipient has asked for it.
         company_descriptive_date: nil,
-        # Custom data sent in the company batch header. This value is informational and
-        # does not affect funds movement, settlement timing, or returns. Most ACH
-        # transfers do not need this. Only set this if your recipient has asked for it.
+        # Custom data sent in the company batch header, meant as metadata for the
+        # originator. This value is informational and does not affect funds movement,
+        # settlement timing, or returns. Most ACH transfers do not need this; we recommend
+        # storing metadata in your own application instead.
         company_discretionary_data: nil,
-        # A short description sent in the company batch header. Most receivers do not
-        # surface this. Only set this if your recipient has asked for a specific value or
-        # if Nacha mandates one for your Standard Entry Class (SEC) code and use case. For
-        # example, Prearranged Payment and Deposit (PPD) payroll credits must use
-        # `PAYROLL`, and reversals must use `REVERSAL`.
+        # A short description sent in the company batch header, meant to provide the
+        # receiver with a reason for the transfer. Many receivers do not surface this data
+        # on the receiver's bank statement. Only set this if your recipient has asked for
+        # a specific value or if Nacha mandates one for your Standard Entry Class (SEC)
+        # code and use case. For example, some use cases require constants like
+        # `ACCTVERIFY`, `PURCHASE`, `PAYROLL`, or `REVERSAL`.
         company_entry_description: nil,
-        # The name by which the recipient knows you, sent in the company batch header. We
-        # recommend setting this on every transfer; if you do not, we fall back to the
-        # `statement_descriptor`.
+        # The name by which the recipient knows the counterparty of this transaction. If
+        # you're processing payments on behalf of another party, use their name, not your
+        # own, so that it's more likely the recipient understands the context of the
+        # payment. This value is usually displayed to the recipient on their bank
+        # statement. We recommend setting this on every transfer; if you do not, we fall
+        # back to the `statement_descriptor`.
         company_name: nil,
         # The type of entity that owns the receiver's account.
         destination_account_holder: nil,
@@ -277,11 +303,15 @@ module Increase
         #
         # Defaults to `checking`.
         funding: nil,
-        # Your internal identifier for the transfer recipient. This value is informational
-        # and not verified by the recipient's bank. Most callers can leave this unset.
+        # Your internal identifier for the recipient. This value is informational and
+        # generally not verified by the recipient's bank. Most callers can leave this
+        # unset. For the specific case of person-to-person credits with the WEB standard
+        # entry class code, this must include the name of the payer.
         individual_id: nil,
-        # The name of the transfer recipient. This value is informational and not verified
-        # by the recipient's bank.
+        # The name of the transfer recipient. This value is informational and generally
+        # not verified by the recipient's bank. This value is usually displayed to the
+        # recipient on their bank statement. We recommend setting this on every transfer;
+        # if you do not, we fall back to the `statement_descriptor`.
         individual_name: nil,
         # Configuration for how the effective date of the transfer will be set. This
         # determines same-day vs future-dated settlement timing. If not set, defaults to a

data/rbi/increase/models/simulations/card_dispute_action_params.rbi

@@ -149,6 +149,25 @@ module Increase
           end
           attr_writer :accept_chargeback
 
+          # The parameters for accepting the user prearbitration. Required if and only if
+          # `action` is `accept_user_prearbitration`.
+          sig do
+            returns(
+              T.nilable(
+                Increase::Simulations::CardDisputeActionParams::Visa::AcceptUserPrearbitration
+              )
+            )
+          end
+          attr_reader :accept_user_prearbitration
+
+          sig do
+            params(
+              accept_user_prearbitration:
+                Increase::Simulations::CardDisputeActionParams::Visa::AcceptUserPrearbitration::OrHash
+            ).void
+          end
+          attr_writer :accept_user_prearbitration
+
           # The parameters for accepting the user submission. Required if and only if
           # `action` is `accept_user_submission`.
           sig do
@@ -347,6 +366,8 @@ module Increase
                 Increase::Simulations::CardDisputeActionParams::Visa::Action::OrSymbol,
               accept_chargeback:
                 Increase::Simulations::CardDisputeActionParams::Visa::AcceptChargeback::OrHash,
+              accept_user_prearbitration:
+                Increase::Simulations::CardDisputeActionParams::Visa::AcceptUserPrearbitration::OrHash,
               accept_user_submission:
                 Increase::Simulations::CardDisputeActionParams::Visa::AcceptUserSubmission::OrHash,
               decline_user_prearbitration:
@@ -376,6 +397,9 @@ module Increase
             # The parameters for accepting the chargeback. Required if and only if `action` is
             # `accept_chargeback`.
             accept_chargeback: nil,
+            # The parameters for accepting the user prearbitration. Required if and only if
+            # `action` is `accept_user_prearbitration`.
+            accept_user_prearbitration: nil,
             # The parameters for accepting the user submission. Required if and only if
             # `action` is `accept_user_submission`.
             accept_user_submission: nil,
@@ -416,6 +440,8 @@ module Increase
                   Increase::Simulations::CardDisputeActionParams::Visa::Action::OrSymbol,
                 accept_chargeback:
                   Increase::Simulations::CardDisputeActionParams::Visa::AcceptChargeback,
+                accept_user_prearbitration:
+                  Increase::Simulations::CardDisputeActionParams::Visa::AcceptUserPrearbitration,
                 accept_user_submission:
                   Increase::Simulations::CardDisputeActionParams::Visa::AcceptUserSubmission,
                 decline_user_prearbitration:
@@ -463,6 +489,13 @@ module Increase
                 Increase::Simulations::CardDisputeActionParams::Visa::Action::TaggedSymbol
               )
 
+            # Simulate the merchant accepting the user's pre-arbitration. This will move the dispute to a `won` state.
+            ACCEPT_USER_PREARBITRATION =
+              T.let(
+                :accept_user_prearbitration,
+                Increase::Simulations::CardDisputeActionParams::Visa::Action::TaggedSymbol
+              )
+
             # Accept the user's submission and transmit it to the network. This will move the dispute to a `pending_response` state.
             ACCEPT_USER_SUBMISSION =
               T.let(
@@ -477,7 +510,7 @@ module Increase
                 Increase::Simulations::CardDisputeActionParams::Visa::Action::TaggedSymbol
               )
 
-            # Simulate the merchant issuing pre-arbitration. This will move the dispute to a `user_submission_required` state.
+            # Simulate the merchant issuing pre-arbitration. Only available for disputes in the fraud or authorization category. This will move the dispute to a `user_submission_required` state.
             RECEIVE_MERCHANT_PREARBITRATION =
               T.let(
                 :receive_merchant_prearbitration,
@@ -491,7 +524,7 @@ module Increase
                 Increase::Simulations::CardDisputeActionParams::Visa::Action::TaggedSymbol
               )
 
-            # Simulate the merchant re-presenting the dispute. This will move the dispute to a `user_submission_required` state.
+            # Simulate the merchant re-presenting the dispute. Only available for disputes in a consumer or processing error category. This will move the dispute to a `user_submission_required` state.
             REPRESENT =
               T.let(
                 :represent,
@@ -526,7 +559,7 @@ module Increase
                 Increase::Simulations::CardDisputeActionParams::Visa::Action::TaggedSymbol
               )
 
-            # Simulate the merchant timing out responding to a user pre-arbitration. This will move the dispute to a `win` state.
+            # Simulate the merchant timing out responding to a user pre-arbitration. This will move the dispute to a `won` state.
             TIME_OUT_USER_PREARBITRATION =
               T.let(
                 :time_out_user_prearbitration,
@@ -564,6 +597,26 @@ module Increase
             end
           end
 
+          class AcceptUserPrearbitration < Increase::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Increase::Simulations::CardDisputeActionParams::Visa::AcceptUserPrearbitration,
+                  Increase::Internal::AnyHash
+                )
+              end
+
+            # The parameters for accepting the user prearbitration. Required if and only if
+            # `action` is `accept_user_prearbitration`.
+            sig { returns(T.attached_class) }
+            def self.new
+            end
+
+            sig { override.returns({}) }
+            def to_hash
+            end
+          end
+
           class AcceptUserSubmission < Increase::Internal::Type::BaseModel
             OrHash =
               T.type_alias do

data/rbi/increase/models/simulations/wire_drawdown_request_refuse_params.rbi

@@ -19,15 +19,51 @@ module Increase
         sig { returns(String) }
         attr_accessor :wire_drawdown_request_id
 
+        # Additional information about the refusal that the simulated refusal will have.
+        sig { returns(T.nilable(String)) }
+        attr_reader :refusal_reason_additional_information
+
+        sig { params(refusal_reason_additional_information: String).void }
+        attr_writer :refusal_reason_additional_information
+
+        # The reason code that the simulated refusal will have.
+        #
+        # Defaults to `other`.
+        sig do
+          returns(
+            T.nilable(
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::OrSymbol
+            )
+          )
+        end
+        attr_reader :refusal_reason_code
+
+        sig do
+          params(
+            refusal_reason_code:
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::OrSymbol
+          ).void
+        end
+        attr_writer :refusal_reason_code
+
         sig do
           params(
             wire_drawdown_request_id: String,
+            refusal_reason_additional_information: String,
+            refusal_reason_code:
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::OrSymbol,
             request_options: Increase::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
           # The identifier of the Wire Drawdown Request you wish to refuse.
           wire_drawdown_request_id:,
+          # Additional information about the refusal that the simulated refusal will have.
+          refusal_reason_additional_information: nil,
+          # The reason code that the simulated refusal will have.
+          #
+          # Defaults to `other`.
+          refusal_reason_code: nil,
           request_options: {}
         )
         end
@@ -36,12 +72,83 @@ module Increase
           override.returns(
             {
               wire_drawdown_request_id: String,
+              refusal_reason_additional_information: String,
+              refusal_reason_code:
+                Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::OrSymbol,
               request_options: Increase::RequestOptions
             }
           )
         end
         def to_hash
         end
+
+        # The reason code that the simulated refusal will have.
+        #
+        # Defaults to `other`.
+        module RefusalReasonCode
+          extend Increase::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          # The debtor's account number is invalid or missing. Corresponds to the Fedwire reason code `AC02`.
+          INVALID_DEBTOR_ACCOUNT_NUMBER =
+            T.let(
+              :invalid_debtor_account_number,
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::TaggedSymbol
+            )
+
+          # The debtor account does not allow drawdown requests. Corresponds to the Fedwire reason code `AG01`.
+          TRANSACTION_FORBIDDEN =
+            T.let(
+              :transaction_forbidden,
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::TaggedSymbol
+            )
+
+          # The debtor account cannot be debited for a generic reason. Corresponds to the Fedwire reason code `AG07`.
+          UNSUCCESSFUL_DIRECT_DEBIT =
+            T.let(
+              :unsuccessful_direct_debit,
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::TaggedSymbol
+            )
+
+          # The debtor's identification is inconsistent with the debtor account number. Corresponds to the Fedwire reason code `BE01`.
+          INCONSISTENT_WITH_END_CUSTOMER =
+            T.let(
+              :inconsistent_with_end_customer,
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::TaggedSymbol
+            )
+
+          # The reason is provided as narrative information in the additional information field. Corresponds to the Fedwire reason code `NARR`.
+          NARRATIVE =
+            T.let(
+              :narrative,
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::TaggedSymbol
+            )
+
+          # Some other error or issue has occurred.
+          OTHER =
+            T.let(
+              :other,
+              Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Increase::Simulations::WireDrawdownRequestRefuseParams::RefusalReasonCode::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end