increase 1.240.0 → 1.242.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d636be2ae0ca907dfb7c5ea637c4b9d366ba2149304b3879fbd71d6ce9f95d75
-  data.tar.gz: 2cead5d28ba7fe959d744fee56679e4d79082980f2084c34b40c1508c62f3792
+  metadata.gz: fce3493743b7f1e3f2193de6a7e044d9e7b987320e8eaec2715c6c19b26e87e6
+  data.tar.gz: 8a9a9b0689feff56ecd5005669356613b69a33f67e44e545ae1170d79dfa62e3
 SHA512:
-  metadata.gz: 3167a3a6c4f824e12a57ea5bf8c49564706a3e230ff2187439689b28c6a54f4308c2d09db8ce6160c6c79f55b26c17494bad9bf12b0fc41cfe706e6ce7baaef0
-  data.tar.gz: f2d6d8f6fab0196864a69ac6ce5d7dbccaffdd9e220fd395e446204f71de43456cc4113b89b942f4696930a2edb6f10f8324aff6b62558eb2c85017c7c195b00
+  metadata.gz: 9f299a870b76d3fb04e30499ba66af6bf54dbd225d061846d4e519746ea6399e121302149124382ab46ca93cb6286820056949f5ed46c801cb1847e4d648d0bc
+  data.tar.gz: 02b939d5884249325b3f4d1a54d78603d421b26189c34fec5f0624e3aa017694933585c5b2dd053b9df1033d2108a1f90b745b7bb12a66f91c012393eb890be2

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.242.0 (2026-03-11)
+
+Full Changelog: [v1.241.0...v1.242.0](https://github.com/Increase/increase-ruby/compare/v1.241.0...v1.242.0)
+
+### Features
+
+* **client:** add webhook support ([227d6ab](https://github.com/Increase/increase-ruby/commit/227d6ab8bec444b348c61ae7b85969cd38dcd764))
+
+## 1.241.0 (2026-03-11)
+
+Full Changelog: [v1.240.0...v1.241.0](https://github.com/Increase/increase-ruby/compare/v1.240.0...v1.241.0)
+
+### Features
+
+* **api:** api update ([bb3ea5f](https://github.com/Increase/increase-ruby/commit/bb3ea5f6f2b649f19a38ba32b5f5ffd75e7cc9b0))
+
 ## 1.240.0 (2026-03-10)
 
 Full Changelog: [v1.239.0...v1.240.0](https://github.com/Increase/increase-ruby/compare/v1.239.0...v1.240.0)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "increase", "~> 1.240.0"
+gem "increase", "~> 1.242.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/increase/client.rb

@@ -23,6 +23,9 @@ module Increase
     # @return [String]
     attr_reader :api_key
 
+    # @return [String, nil]
+    attr_reader :webhook_secret
+
     # @return [Increase::Resources::Accounts]
     attr_reader :accounts
 
@@ -210,6 +213,8 @@ module Increase
     #
     # @param api_key [String, nil] Defaults to `ENV["INCREASE_API_KEY"]`
     #
+    # @param webhook_secret [String, nil] Defaults to `ENV["INCREASE_WEBHOOK_SECRET"]`
+    #
     # @param environment [:production, :sandbox, nil] Specifies the environment to use for the API.
     #
     # Each environment maps to a different base URL:
@@ -231,6 +236,7 @@ module Increase
     # @param idempotency_header [String]
     def initialize(
       api_key: ENV["INCREASE_API_KEY"],
+      webhook_secret: ENV["INCREASE_WEBHOOK_SECRET"],
       environment: nil,
       base_url: ENV["INCREASE_BASE_URL"],
       max_retries: self.class::DEFAULT_MAX_RETRIES,
@@ -249,6 +255,7 @@ module Increase
       end
 
       @api_key = api_key.to_s
+      @webhook_secret = webhook_secret&.to_s
 
       super(
         base_url: base_url,

data/lib/increase/models/card_payment.rb

@@ -685,6 +685,12 @@ module Increase
             #   @return [String]
             required :one_time_code, String
 
+            # @!attribute real_time_decision_id
+            #   The identifier of the Real-Time Decision used to deliver this challenge.
+            #
+            #   @return [String, nil]
+            required :real_time_decision_id, String, nil?: true
+
             # @!attribute verification_method
             #   The method used to verify the Card Authentication Challenge.
             #
@@ -699,7 +705,7 @@ module Increase
             #   @return [String, nil]
             required :verification_value, String, nil?: true
 
-            # @!method initialize(attempts:, created_at:, one_time_code:, verification_method:, verification_value:)
+            # @!method initialize(attempts:, created_at:, one_time_code:, real_time_decision_id:, verification_method:, verification_value:)
             #   Some parameter documentations has been truncated, see
             #   {Increase::Models::CardPayment::Element::CardAuthentication::Challenge} for more
             #   details.
@@ -712,6 +718,8 @@ module Increase
             #
             #   @param one_time_code [String] The one-time code used for the Card Authentication Challenge.
             #
+            #   @param real_time_decision_id [String, nil] The identifier of the Real-Time Decision used to deliver this challenge.
+            #
             #   @param verification_method [Symbol, Increase::Models::CardPayment::Element::CardAuthentication::Challenge::VerificationMethod] The method used to verify the Card Authentication Challenge.
             #
             #   @param verification_value [String, nil] E.g., the email address or phone number used for the Card Authentication Challen

data/lib/increase/resources/events.rb

@@ -60,8 +60,18 @@ module Increase
 
       # @param payload [String] The raw webhook payload as a string
       #
+      # @param headers [Hash{String=>String}] The raw HTTP headers that came with the payload
+      #
+      # @param key [String, nil] The webhook signing key
+      #
       # @return [Increase::Models::UnwrapWebhookEvent]
-      def unwrap(payload)
+      def unwrap(payload, headers:, key: @client.webhook_secret)
+        if key.nil?
+          raise ArgumentError.new("Cannot verify a webhook without a key on either the client's webhook_secret or passed in as an argument")
+        end
+
+        ::StandardWebhooks::Webhook.new(Base64.strict_encode64(key)).verify(payload, headers)
+
         parsed = JSON.parse(payload, symbolize_names: true)
         Increase::Internal::Type::Converter.coerce(Increase::Models::UnwrapWebhookEvent, parsed)
       end

data/lib/increase/version.rb

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

data/lib/increase.rb

@@ -30,6 +30,7 @@ end
 
 # Gems.
 require "connection_pool"
+require "standardwebhooks"
 
 # Package files.
 require_relative "increase/version"

data/rbi/increase/client.rbi

@@ -22,6 +22,9 @@ module Increase
     sig { returns(String) }
     attr_reader :api_key
 
+    sig { returns(T.nilable(String)) }
+    attr_reader :webhook_secret
+
     sig { returns(Increase::Resources::Accounts) }
     attr_reader :accounts
 
@@ -205,6 +208,7 @@ module Increase
     sig do
       params(
         api_key: T.nilable(String),
+        webhook_secret: T.nilable(String),
         environment: T.nilable(T.any(Symbol, String)),
         base_url: T.nilable(String),
         max_retries: Integer,
@@ -217,6 +221,8 @@ module Increase
     def self.new(
       # Defaults to `ENV["INCREASE_API_KEY"]`
       api_key: ENV["INCREASE_API_KEY"],
+      # Defaults to `ENV["INCREASE_WEBHOOK_SECRET"]`
+      webhook_secret: ENV["INCREASE_WEBHOOK_SECRET"],
       # Specifies the environment to use for the API.
       #
       # Each environment maps to a different base URL:

data/rbi/increase/models/card_payment.rbi

@@ -1114,6 +1114,10 @@ module Increase
             sig { returns(String) }
             attr_accessor :one_time_code
 
+            # The identifier of the Real-Time Decision used to deliver this challenge.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :real_time_decision_id
+
             # The method used to verify the Card Authentication Challenge.
             sig do
               returns(
@@ -1136,6 +1140,7 @@ module Increase
                   ],
                 created_at: Time,
                 one_time_code: String,
+                real_time_decision_id: T.nilable(String),
                 verification_method:
                   Increase::CardPayment::Element::CardAuthentication::Challenge::VerificationMethod::OrSymbol,
                 verification_value: T.nilable(String)
@@ -1149,6 +1154,8 @@ module Increase
               created_at:,
               # The one-time code used for the Card Authentication Challenge.
               one_time_code:,
+              # The identifier of the Real-Time Decision used to deliver this challenge.
+              real_time_decision_id:,
               # The method used to verify the Card Authentication Challenge.
               verification_method:,
               # E.g., the email address or phone number used for the Card Authentication
@@ -1166,6 +1173,7 @@ module Increase
                     ],
                   created_at: Time,
                   one_time_code: String,
+                  real_time_decision_id: T.nilable(String),
                   verification_method:
                     Increase::CardPayment::Element::CardAuthentication::Challenge::VerificationMethod::TaggedSymbol,
                   verification_value: T.nilable(String)

data/rbi/increase/resources/events.rbi

@@ -42,10 +42,20 @@ module Increase
       )
       end
 
-      sig { params(payload: String).returns(Increase::UnwrapWebhookEvent) }
+      sig do
+        params(
+          payload: String,
+          headers: T::Hash[String, String],
+          key: T.nilable(String)
+        ).returns(Increase::UnwrapWebhookEvent)
+      end
       def unwrap(
         # The raw webhook payload as a string
-        payload
+        payload,
+        # The raw HTTP headers that came with the payload
+        headers:,
+        # The webhook signing key
+        key: @client.webhook_secret
       )
       end
 

data/sig/increase/client.rbs

@@ -15,6 +15,8 @@ module Increase
 
     attr_reader api_key: String
 
+    attr_reader webhook_secret: String?
+
     attr_reader accounts: Increase::Resources::Accounts
 
     attr_reader account_numbers: Increase::Resources::AccountNumbers
@@ -135,6 +137,7 @@ module Increase
 
     def initialize: (
       ?api_key: String?,
+      ?webhook_secret: String?,
       ?environment: :production | :sandbox | nil,
       ?base_url: String?,
       ?max_retries: Integer,

data/sig/increase/models/card_payment.rbs

@@ -418,6 +418,7 @@ module Increase
               attempts: ::Array[Increase::CardPayment::Element::CardAuthentication::Challenge::Attempt],
               created_at: Time,
               one_time_code: String,
+              real_time_decision_id: String?,
               verification_method: Increase::Models::CardPayment::Element::CardAuthentication::Challenge::verification_method,
               verification_value: String?
             }
@@ -429,6 +430,8 @@ module Increase
 
             attr_accessor one_time_code: String
 
+            attr_accessor real_time_decision_id: String?
+
             attr_accessor verification_method: Increase::Models::CardPayment::Element::CardAuthentication::Challenge::verification_method
 
             attr_accessor verification_value: String?
@@ -437,6 +440,7 @@ module Increase
               attempts: ::Array[Increase::CardPayment::Element::CardAuthentication::Challenge::Attempt],
               created_at: Time,
               one_time_code: String,
+              real_time_decision_id: String?,
               verification_method: Increase::Models::CardPayment::Element::CardAuthentication::Challenge::verification_method,
               verification_value: String?
             ) -> void
@@ -445,6 +449,7 @@ module Increase
               attempts: ::Array[Increase::CardPayment::Element::CardAuthentication::Challenge::Attempt],
               created_at: Time,
               one_time_code: String,
+              real_time_decision_id: String?,
               verification_method: Increase::Models::CardPayment::Element::CardAuthentication::Challenge::verification_method,
               verification_value: String?
             }

data/sig/increase/resources/events.rbs

@@ -15,7 +15,11 @@ module Increase
         ?request_options: Increase::request_opts
       ) -> Increase::Internal::Page[Increase::Event]
 
-      def unwrap: (String payload) -> Increase::UnwrapWebhookEvent
+      def unwrap: (
+        String payload,
+        headers: ::Hash[String, String],
+        ?key: String?
+      ) -> Increase::UnwrapWebhookEvent
 
       def initialize: (client: Increase::Client) -> void
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: increase
 version: !ruby/object:Gem::Version
-  version: 1.240.0
+  version: 1.242.0
 platform: ruby
 authors:
 - Increase
@@ -38,6 +38,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: standardwebhooks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description:
 email: dev-feedback@increase.com
 executables: []