increase 1.353.0 → 1.355.0

data/rbi/increase/resources/physical_check_batches.rbi

@@ -0,0 +1,66 @@
+# typed: strong
+
+module Increase
+  module Resources
+    class PhysicalCheckBatches
+      # Create a Physical Check Batch
+      sig do
+        params(
+          mailing_address:
+            Increase::PhysicalCheckBatchCreateParams::MailingAddress::OrHash,
+          return_address:
+            Increase::PhysicalCheckBatchCreateParams::ReturnAddress::OrHash,
+          shipping_method:
+            Increase::PhysicalCheckBatchCreateParams::ShippingMethod::OrSymbol,
+          request_options: Increase::RequestOptions::OrHash
+        ).returns(Increase::PhysicalCheckBatch)
+      end
+      def create(
+        # Details for where the parcel will be mailed.
+        mailing_address:,
+        # Details for where the parcel should return if it is unable to be delivered.
+        return_address:,
+        # How to ship the batch.
+        #
+        # Defaults to `usps_first_class`.
+        shipping_method: nil,
+        request_options: {}
+      )
+      end
+
+      # Cancel a pending Physical Check Batch, which cancels all of its related checks.
+      sig do
+        params(
+          physical_check_batch_id: String,
+          request_options: Increase::RequestOptions::OrHash
+        ).returns(Increase::PhysicalCheckBatch)
+      end
+      def cancel(
+        # The identifier of the pending Physical Check Batch to cancel.
+        physical_check_batch_id,
+        request_options: {}
+      )
+      end
+
+      # Completing a Physical Check Batch closes it to new Physical Checks and begins
+      # the process of printing and mailing it.
+      sig do
+        params(
+          physical_check_batch_id: String,
+          request_options: Increase::RequestOptions::OrHash
+        ).returns(Increase::PhysicalCheckBatch)
+      end
+      def complete(
+        # The identifier of the Physical Check Batch to complete.
+        physical_check_batch_id,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Increase::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/increase/resources/real_time_payments_requests_for_payment.rbi

@@ -0,0 +1,127 @@
+# typed: strong
+
+module Increase
+  module Resources
+    class RealTimePaymentsRequestsForPayment
+      # Create a Real-Time Payments Request for Payment
+      sig do
+        params(
+          account_number_id: String,
+          amount: Integer,
+          debtor:
+            Increase::RealTimePaymentsRequestsForPaymentCreateParams::Debtor::OrHash,
+          debtor_account_number: String,
+          debtor_routing_number: String,
+          expires_at: Time,
+          requested_execution_at: Time,
+          unstructured_remittance_information: String,
+          creditor_name: String,
+          request_options: Increase::RequestOptions::OrHash
+        ).returns(Increase::RealTimePaymentsRequestForPayment)
+      end
+      def create(
+        # The identifier of the Account Number where the funds will land.
+        account_number_id:,
+        # The requested amount in USD cents. Must be positive.
+        amount:,
+        # Details of the person being requested to pay.
+        debtor:,
+        # The debtor's account number, which the funds will be requested from.
+        debtor_account_number:,
+        # The debtor's American Bankers' Association (ABA) Routing Transit Number (RTN).
+        debtor_routing_number:,
+        # The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time after which
+        # the request for payment is no longer valid. After this time the debtor's bank
+        # should no longer allow the debtor to pay it. Must not be before
+        # `requested_execution_at`.
+        expires_at:,
+        # The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time by which
+        # you are requesting the payment to be made.
+        requested_execution_at:,
+        # Unstructured information that will show on the recipient's bank statement.
+        unstructured_remittance_information:,
+        # The name of the creditor requesting the payment. If not provided, defaults to
+        # the name of the account's entity.
+        creditor_name: nil,
+        request_options: {}
+      )
+      end
+
+      # Retrieve a Real-Time Payments Request for Payment
+      sig do
+        params(
+          real_time_payments_request_for_payment_id: String,
+          request_options: Increase::RequestOptions::OrHash
+        ).returns(Increase::RealTimePaymentsRequestForPayment)
+      end
+      def retrieve(
+        # The identifier of the Real-Time Payments Request for Payment.
+        real_time_payments_request_for_payment_id,
+        request_options: {}
+      )
+      end
+
+      # List Real-Time Payments Requests for Payment
+      sig do
+        params(
+          account_id: String,
+          created_at:
+            Increase::RealTimePaymentsRequestsForPaymentListParams::CreatedAt::OrHash,
+          cursor: String,
+          idempotency_key: String,
+          limit: Integer,
+          request_options: Increase::RequestOptions::OrHash
+        ).returns(
+          Increase::Internal::Page[Increase::RealTimePaymentsRequestForPayment]
+        )
+      end
+      def list(
+        # Filter Real-Time Payments Requests for Payment to those destined to the
+        # specified Account.
+        account_id: nil,
+        created_at: nil,
+        # Return the page of entries after this one.
+        cursor: nil,
+        # Filter records to the one with the specified `idempotency_key` you chose for
+        # that object. This value is unique across Increase and is used to ensure that a
+        # request is only processed once. Learn more about
+        # [idempotency](https://increase.com/documentation/idempotency-keys).
+        idempotency_key: nil,
+        # Limit the size of the list that is returned. The default (and maximum) is 100
+        # objects.
+        #
+        # Defaults to `100`.
+        limit: nil,
+        request_options: {}
+      )
+      end
+
+      # Cancels a Real-Time Payments Request for Payment that is still awaiting payment.
+      sig do
+        params(
+          real_time_payments_request_for_payment_id: String,
+          additional_information: String,
+          reason:
+            Increase::RealTimePaymentsRequestsForPaymentCancelParams::Reason::OrSymbol,
+          request_options: Increase::RequestOptions::OrHash
+        ).returns(Increase::RealTimePaymentsRequestForPayment)
+      end
+      def cancel(
+        # The identifier of the Real-Time Payments Request for Payment to cancel.
+        real_time_payments_request_for_payment_id,
+        # Additional information about the cancellation to pass on to the recipient bank.
+        additional_information: nil,
+        # The reason the request for payment is being canceled. Defaults to
+        # `requested_by_customer`.
+        reason: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Increase::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/increase/resources/simulations/fednow_transfers.rbi

@@ -0,0 +1,34 @@
+# typed: strong
+
+module Increase
+  module Resources
+    class Simulations
+      class FednowTransfers
+        # Simulates submission of a [FedNow Transfer](#fednow-transfers) and handling the
+        # response from the destination financial institution. This transfer must first
+        # have a `status` of `pending_submitting`.
+        sig do
+          params(
+            fednow_transfer_id: String,
+            rejection:
+              Increase::Simulations::FednowTransferCompleteParams::Rejection::OrHash,
+            request_options: Increase::RequestOptions::OrHash
+          ).returns(Increase::FednowTransfer)
+        end
+        def complete(
+          # The identifier of the FedNow Transfer you wish to complete.
+          fednow_transfer_id,
+          # If set, the simulation will reject the transfer.
+          rejection: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Increase::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/increase/resources/simulations/inbound_check_deposits.rbi

@@ -36,6 +36,22 @@ module Increase
         )
         end
 
+        # Simulates the acceptance of an [Inbound Check Deposit](#inbound-check-deposits),
+        # creating a Transaction as a result. The Inbound Check Deposit must first have a
+        # `status` of `pending`.
+        sig do
+          params(
+            inbound_check_deposit_id: String,
+            request_options: Increase::RequestOptions::OrHash
+          ).returns(Increase::InboundCheckDeposit)
+        end
+        def accept(
+          # The identifier of the Inbound Check Deposit you wish to accept.
+          inbound_check_deposit_id,
+          request_options: {}
+        )
+        end
+
         # Simulates an adjustment on an Inbound Check Deposit. The Inbound Check Deposit
         # must have a `status` of `accepted`.
         sig do

data/rbi/increase/resources/simulations.rbi

@@ -93,6 +93,9 @@ module Increase
       end
       attr_reader :inbound_real_time_payments_transfers
 
+      sig { returns(Increase::Resources::Simulations::FednowTransfers) }
+      attr_reader :fednow_transfers
+
       sig { returns(Increase::Resources::Simulations::InboundFednowTransfers) }
       attr_reader :inbound_fednow_transfers
 

data/sig/increase/client.rbs

@@ -39,6 +39,8 @@ module Increase
 
     attr_reader digital_wallet_tokens: Increase::Resources::DigitalWalletTokens
 
+    attr_reader digital_wallet_token_requests: Increase::Resources::DigitalWalletTokenRequests
+
     attr_reader transactions: Increase::Resources::Transactions
 
     attr_reader pending_transactions: Increase::Resources::PendingTransactions
@@ -67,6 +69,10 @@ module Increase
 
     attr_reader inbound_real_time_payments_transfers: Increase::Resources::InboundRealTimePaymentsTransfers
 
+    attr_reader real_time_payments_requests_for_payment: Increase::Resources::RealTimePaymentsRequestsForPayment
+
+    attr_reader inbound_real_time_payments_requests_for_payment: Increase::Resources::InboundRealTimePaymentsRequestsForPayment
+
     attr_reader fednow_transfers: Increase::Resources::FednowTransfers
 
     attr_reader inbound_fednow_transfers: Increase::Resources::InboundFednowTransfers
@@ -129,6 +135,8 @@ module Increase
 
     attr_reader card_validations: Increase::Resources::CardValidations
 
+    attr_reader physical_check_batches: Increase::Resources::PhysicalCheckBatches
+
     attr_reader simulations: Increase::Resources::Simulations
 
     private def auth_headers: -> ::Hash[String, String]

data/sig/increase/models/ach_transfer.rbs

@@ -191,14 +191,14 @@ module Increase
         type: Increase::Models::ACHTransfer::type_
       }
 
-      type acknowledgement = { acknowledged_at: String }
+      type acknowledgement = { acknowledged_at: Time }
 
       class Acknowledgement < Increase::Internal::Type::BaseModel
-        attr_accessor acknowledged_at: String
+        attr_accessor acknowledged_at: Time
 
-        def initialize: (acknowledged_at: String) -> void
+        def initialize: (acknowledged_at: Time) -> void
 
-        def to_hash: -> { acknowledged_at: String }
+        def to_hash: -> { acknowledged_at: Time }
       end
 
       type addenda =

data/sig/increase/models/beneficial_owner_create_params.rbs

@@ -187,7 +187,7 @@ module Increase
             # A social security number.
             SOCIAL_SECURITY_NUMBER: :social_security_number
 
-            # The last four digits of a social security number.
+            # The last four digits of a social security number. Not all programs can use this method.
             SOCIAL_SECURITY_NUMBER_LAST4: :social_security_number_last4
 
             # An individual taxpayer identification number (ITIN).

data/sig/increase/models/beneficial_owner_update_params.rbs

@@ -180,7 +180,7 @@ module Increase
           # A social security number.
           SOCIAL_SECURITY_NUMBER: :social_security_number
 
-          # The last four digits of a social security number.
+          # The last four digits of a social security number. Not all programs can use this method.
           SOCIAL_SECURITY_NUMBER_LAST4: :social_security_number_last4
 
           # An individual taxpayer identification number (ITIN).

data/sig/increase/models/card_create_details_token_params.rbs

@@ -0,0 +1,23 @@
+module Increase
+  module Models
+    type card_create_details_token_params =
+      { card_id: String } & Increase::Internal::Type::request_parameters
+
+    class CardCreateDetailsTokenParams < Increase::Internal::Type::BaseModel
+      extend Increase::Internal::Type::RequestParameters::Converter
+      include Increase::Internal::Type::RequestParameters
+
+      attr_accessor card_id: String
+
+      def initialize: (
+        card_id: String,
+        ?request_options: Increase::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        card_id: String,
+        request_options: Increase::RequestOptions
+      }
+    end
+  end
+end

data/sig/increase/models/card_details_token.rbs

@@ -0,0 +1,40 @@
+module Increase
+  module Models
+    type card_details_token =
+      {
+        token: String,
+        expires_at: Time,
+        type: Increase::Models::CardDetailsToken::type_
+      }
+
+    class CardDetailsToken < Increase::Internal::Type::BaseModel
+      attr_accessor token: String
+
+      attr_accessor expires_at: Time
+
+      attr_accessor type: Increase::Models::CardDetailsToken::type_
+
+      def initialize: (
+        token: String,
+        expires_at: Time,
+        type: Increase::Models::CardDetailsToken::type_
+      ) -> void
+
+      def to_hash: -> {
+        token: String,
+        expires_at: Time,
+        type: Increase::Models::CardDetailsToken::type_
+      }
+
+      type type_ = :card_details_token
+
+      module Type
+        extend Increase::Internal::Type::Enum
+
+        CARD_DETAILS_TOKEN: :card_details_token
+
+        def self?.values: -> ::Array[Increase::Models::CardDetailsToken::type_]
+      end
+    end
+  end
+end

data/sig/increase/models/card_payment.rbs

@@ -3816,6 +3816,7 @@ module Increase
             | :exceeds_approval_limit
             | :card_temporarily_disabled
             | :suspected_fraud
+            | :additional_customer_authentication_required
             | :other
 
           module RealTimeDecisionReason
@@ -3836,6 +3837,9 @@ module Increase
             # The transaction is suspected to be fraudulent. The merchant may attempt to process the transaction again.
             SUSPECTED_FRAUD: :suspected_fraud
 
+            # Additional customer authentication is required to complete the transaction, such as 3DS.
+            ADDITIONAL_CUSTOMER_AUTHENTICATION_REQUIRED: :additional_customer_authentication_required
+
             # The transaction was declined for another reason. The merchant may attempt to process the transaction again. This should be used sparingly.
             OTHER: :other
 
@@ -6173,6 +6177,7 @@ module Increase
             merchant_name: String,
             merchant_postal_code: String?,
             merchant_state: String?,
+            network: Increase::Models::CardPayment::Element::CardRefund::network,
             network_identifiers: Increase::CardPayment::Element::CardRefund::NetworkIdentifiers,
             presentment_amount: Integer,
             presentment_currency: String,
@@ -6209,6 +6214,8 @@ module Increase
 
           attr_accessor merchant_state: String?
 
+          attr_accessor network: Increase::Models::CardPayment::Element::CardRefund::network
+
           attr_accessor network_identifiers: Increase::CardPayment::Element::CardRefund::NetworkIdentifiers
 
           attr_accessor presentment_amount: Integer
@@ -6237,6 +6244,7 @@ module Increase
             merchant_name: String,
             merchant_postal_code: String?,
             merchant_state: String?,
+            network: Increase::Models::CardPayment::Element::CardRefund::network,
             network_identifiers: Increase::CardPayment::Element::CardRefund::NetworkIdentifiers,
             presentment_amount: Integer,
             presentment_currency: String,
@@ -6260,6 +6268,7 @@ module Increase
             merchant_name: String,
             merchant_postal_code: String?,
             merchant_state: String?,
+            network: Increase::Models::CardPayment::Element::CardRefund::network,
             network_identifiers: Increase::CardPayment::Element::CardRefund::NetworkIdentifiers,
             presentment_amount: Integer,
             presentment_currency: String,
@@ -6351,6 +6360,20 @@ module Increase
             end
           end
 
+          type network = :visa | :pulse
+
+          module Network
+            extend Increase::Internal::Type::Enum
+
+            # Visa
+            VISA: :visa
+
+            # Pulse
+            PULSE: :pulse
+
+            def self?.values: -> ::Array[Increase::Models::CardPayment::Element::CardRefund::network]
+          end
+
           type network_identifiers =
             {
               acquirer_business_id: String,

data/sig/increase/models/declined_transaction.rbs

@@ -1067,6 +1067,7 @@ module Increase
             | :exceeds_approval_limit
             | :card_temporarily_disabled
             | :suspected_fraud
+            | :additional_customer_authentication_required
             | :other
 
           module RealTimeDecisionReason
@@ -1087,6 +1088,9 @@ module Increase
             # The transaction is suspected to be fraudulent. The merchant may attempt to process the transaction again.
             SUSPECTED_FRAUD: :suspected_fraud
 
+            # Additional customer authentication is required to complete the transaction, such as 3DS.
+            ADDITIONAL_CUSTOMER_AUTHENTICATION_REQUIRED: :additional_customer_authentication_required
+
             # The transaction was declined for another reason. The merchant may attempt to process the transaction again. This should be used sparingly.
             OTHER: :other
 

data/sig/increase/models/digital_wallet_token.rbs

@@ -112,6 +112,9 @@ module Increase
           | :webhook_declined
           | :incorrect_card_verification_code
           | :declined_by_token_requestor
+          | :group_locked
+          | :account_closed
+          | :entity_not_active
 
         module Reason
           extend Increase::Internal::Type::Enum
@@ -134,6 +137,15 @@ module Increase
           # The tokenization attempt was declined by the token requestor.
           DECLINED_BY_TOKEN_REQUESTOR: :declined_by_token_requestor
 
+          # The group was locked.
+          GROUP_LOCKED: :group_locked
+
+          # The account has been closed.
+          ACCOUNT_CLOSED: :account_closed
+
+          # The account's entity was not active.
+          ENTITY_NOT_ACTIVE: :entity_not_active
+
           def self?.values: -> ::Array[Increase::Models::DigitalWalletToken::Decline::reason]
         end
       end
@@ -227,7 +239,13 @@ module Increase
         def to_hash: -> { :first6 => String, :last4 => String }
       end
 
-      type status = :active | :inactive | :suspended | :deactivated | :declined
+      type status =
+        :active
+        | :inactive
+        | :suspended
+        | :deactivated
+        | :declined
+        | :pending_transitioning
 
       module Status
         extend Increase::Internal::Type::Enum
@@ -247,10 +265,14 @@ module Increase
         # The digital wallet token was declined during provisioning.
         DECLINED: :declined
 
+        # The digital wallet token is transitioning to a new status and is awaiting confirmation from the card network.
+        PENDING_TRANSITIONING: :pending_transitioning
+
         def self?.values: -> ::Array[Increase::Models::DigitalWalletToken::status]
       end
 
-      type token_requestor = :apple_pay | :google_pay | :samsung_pay | :unknown
+      type token_requestor =
+        :apple_pay | :google_pay | :samsung_pay | :garmin_pay | :unknown
 
       module TokenRequestor
         extend Increase::Internal::Type::Enum
@@ -264,6 +286,9 @@ module Increase
         # Samsung Pay
         SAMSUNG_PAY: :samsung_pay
 
+        # Garmin Pay
+        GARMIN_PAY: :garmin_pay
+
         # Unknown
         UNKNOWN: :unknown
 
@@ -302,7 +327,12 @@ module Increase
         }
 
         type status =
-          :active | :inactive | :suspended | :deactivated | :declined
+          :active
+          | :inactive
+          | :suspended
+          | :deactivated
+          | :declined
+          | :pending_transitioning
 
         module Status
           extend Increase::Internal::Type::Enum
@@ -322,6 +352,9 @@ module Increase
           # The digital wallet token was declined during provisioning.
           DECLINED: :declined
 
+          # The digital wallet token is transitioning to a new status and is awaiting confirmation from the card network.
+          PENDING_TRANSITIONING: :pending_transitioning
+
           def self?.values: -> ::Array[Increase::Models::DigitalWalletToken::Update::status]
         end
       end