connect-sdk-ruby 4.3.0 → 4.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6eb70538d7cb572c35fca75c5d19fa3b7aa898aadf8303fed5f0b648e36ade87
-  data.tar.gz: 709340e0e61f1a9421768407179b707321a2f883acadb97df052183798190aba
+  metadata.gz: dca4f933ae21eb8d75de43679c2050ea7e2ce28eaefd0a7382bd4d7165e35f80
+  data.tar.gz: ad89109f67fc5fb8f7708da59e284737bc90a930e46a21222ba6c20253622be9
 SHA512:
-  metadata.gz: 8ab8e6993d9472abc575763089c3a037911b0b71858ef75f3799f96e8d6f3e2e9e004622945eb9827844ee86d259f614b9ebef985db95d1fe8479b1a55866560
-  data.tar.gz: dfcba9e5ea4755debd7b92d54d28198b25719f58b68f043a93c2ac461b1c6cb73e6af2bee9a0e69c810a03ab9373ea9a930950e7a504b374718df79b4ea62f7f
+  metadata.gz: c5862d9fb8824427f8b442272559e6665029917f636dc0df538213bea43fdeaea1b85750ace45607c665a98ce350c76ba3238fdd49526b8616a6cafda41faf65
+  data.tar.gz: fd36486d0b09bbb8750ac64d40aa585405a2205f2135a7c44ede29895aa7968a43a7950419699a3e501f668ad0ed9eb59127a860f908fcb4ec49144e8d7d170f

data/connect-sdk-ruby.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |spec|
   spec.name           = 'connect-sdk-ruby'
-  spec.version        = '4.3.0'
+  spec.version        = '4.5.0'
   spec.authors        = ['Worldline Global Collect']
   spec.email          = ['github.connect@worldline.com']
   spec.summary        = %q{SDK to communicate with the Worldline Global Collect platform using the Worldline Connect Server API}

data/examples/v1/merchant/payments/finalize_capture_example.rb

@@ -0,0 +1,22 @@
+#
+# This class was auto-generated from the API references found at
+# https://apireference.connect.worldline-solutions.com/
+#
+require 'worldline/connect/sdk/factory'
+
+
+def example
+  get_client do |client|
+    response = client.v1.merchant('merchantId').payments.finalizecapture('paymentId')
+  end
+end
+
+def get_client
+  api_key_id = ENV.fetch('connect.api.apiKeyId', 'someKey')
+  secret_api_key = ENV.fetch('connect.api.secretApiKey', 'someSecret')
+  configuration_file_name = File.join(__FILE__, '..', '..', '..', 'example_configuration.yml')
+  yield client = Worldline::Connect::SDK::Factory.create_client_from_file(configuration_file_name, api_key_id, secret_api_key)
+ensure
+  # Free networking resources when done
+  client.close unless client.nil?
+end

data/lib/worldline/connect/sdk/communication/metadata_provider.rb

@@ -14,7 +14,7 @@ module Worldline
         class MetadataProvider
           private
 
-          SDK_VERSION = '4.3.0'.freeze
+          SDK_VERSION = '4.5.0'.freeze
           SERVER_META_INFO_HEADER = 'X-GCS-ServerMetaInfo'.freeze
           PROHIBITED_HEADERS = [SERVER_META_INFO_HEADER, 'X-GCS-Idempotence-Key','Date', 'Content-Type', 'Authorization'].sort!.freeze
           CHARSET = 'utf-8'.freeze

data/lib/worldline/connect/sdk/communication/response_header.rb

@@ -51,10 +51,8 @@ module Worldline
           # If this Response does not contain a header with the given name, return _nil_ instead
           def self.get_disposition_filename(headers)
             header_value = get_header_value(headers, "Content-Disposition")
-            unless header_value.nil?
-              if header_value =~ /(?:^|;)\s*filename\s*=\s*(.*?)\s*(?:;|$)i/
-                return trim_quotes($2)
-              end
+            if !header_value.nil? && header_value =~ /(?:^|;)\s*filename\s*=\s*(.*?)\s*(?:;|$)i/
+              return trim_quotes($2)
             end
 
             return nil
@@ -65,11 +63,9 @@ module Worldline
           # Trims the single or double quotes at the beginning and end of parameter _filename_ if they exist
           # If they don't exist, it returns the original _filename_ instead
           def trim_quotes(filename)
-            unless filename.length < 2
-              if (filename.chars.first == '\'' && filename.chars.last == '\"') ||
-                (filename.chars.first == '"' && filename.chars.last == '"')
-                return filename[1...-1]
-              end
+            if filename.length >= 2 &&
+               (filename.chars.first == '\'' && filename.chars.last == '\'') || (filename.chars.first == '"' && filename.chars.last == '"')
+              return filename[1...-1]
             end
             filename
           end

data/lib/worldline/connect/sdk/v1/domain/cash_payment_method_specific_input.rb

@@ -3,6 +3,7 @@
 # https://apireference.connect.worldline-solutions.com/
 #
 require 'worldline/connect/sdk/v1/domain/abstract_cash_payment_method_specific_input'
+require 'worldline/connect/sdk/v1/domain/cash_payment_product1502_specific_input'
 require 'worldline/connect/sdk/v1/domain/cash_payment_product1503_specific_input'
 require 'worldline/connect/sdk/v1/domain/cash_payment_product1504_specific_input'
 require 'worldline/connect/sdk/v1/domain/cash_payment_product1506_specific_input'
@@ -11,6 +12,7 @@ require 'worldline/connect/sdk/v1/domain/cash_payment_product1521_specific_input
 require 'worldline/connect/sdk/v1/domain/cash_payment_product1522_specific_input'
 require 'worldline/connect/sdk/v1/domain/cash_payment_product1523_specific_input'
 require 'worldline/connect/sdk/v1/domain/cash_payment_product1524_specific_input'
+require 'worldline/connect/sdk/v1/domain/cash_payment_product1525_specific_input'
 require 'worldline/connect/sdk/v1/domain/cash_payment_product1526_specific_input'
 
 module Worldline
@@ -18,6 +20,7 @@ module Worldline
     module SDK
       module V1
         module Domain
+          # @attr [Worldline::Connect::SDK::V1::Domain::CashPaymentProduct1502SpecificInput] payment_product1502_specific_input
           # @attr [Worldline::Connect::SDK::V1::Domain::CashPaymentProduct1503SpecificInput] payment_product1503_specific_input
           # @attr [Worldline::Connect::SDK::V1::Domain::CashPaymentProduct1504SpecificInput] payment_product1504_specific_input
           # @attr [Worldline::Connect::SDK::V1::Domain::CashPaymentProduct1506SpecificInput] payment_product1506_specific_input
@@ -26,9 +29,12 @@ module Worldline
           # @attr [Worldline::Connect::SDK::V1::Domain::CashPaymentProduct1522SpecificInput] payment_product1522_specific_input
           # @attr [Worldline::Connect::SDK::V1::Domain::CashPaymentProduct1523SpecificInput] payment_product1523_specific_input
           # @attr [Worldline::Connect::SDK::V1::Domain::CashPaymentProduct1524SpecificInput] payment_product1524_specific_input
+          # @attr [Worldline::Connect::SDK::V1::Domain::CashPaymentProduct1525SpecificInput] payment_product1525_specific_input
           # @attr [Worldline::Connect::SDK::V1::Domain::CashPaymentProduct1526SpecificInput] payment_product1526_specific_input
           class CashPaymentMethodSpecificInput < Worldline::Connect::SDK::V1::Domain::AbstractCashPaymentMethodSpecificInput
 
+            attr_accessor :payment_product1502_specific_input
+
             # @deprecated No replacement
             attr_accessor :payment_product1503_specific_input
 
@@ -46,11 +52,14 @@ module Worldline
 
             attr_accessor :payment_product1524_specific_input
 
+            attr_accessor :payment_product1525_specific_input
+
             attr_accessor :payment_product1526_specific_input
 
             # @return (Hash)
             def to_h
               hash = super
+              hash['paymentProduct1502SpecificInput'] = @payment_product1502_specific_input.to_h unless @payment_product1502_specific_input.nil?
               hash['paymentProduct1503SpecificInput'] = @payment_product1503_specific_input.to_h unless @payment_product1503_specific_input.nil?
               hash['paymentProduct1504SpecificInput'] = @payment_product1504_specific_input.to_h unless @payment_product1504_specific_input.nil?
               hash['paymentProduct1506SpecificInput'] = @payment_product1506_specific_input.to_h unless @payment_product1506_specific_input.nil?
@@ -59,12 +68,17 @@ module Worldline
               hash['paymentProduct1522SpecificInput'] = @payment_product1522_specific_input.to_h unless @payment_product1522_specific_input.nil?
               hash['paymentProduct1523SpecificInput'] = @payment_product1523_specific_input.to_h unless @payment_product1523_specific_input.nil?
               hash['paymentProduct1524SpecificInput'] = @payment_product1524_specific_input.to_h unless @payment_product1524_specific_input.nil?
+              hash['paymentProduct1525SpecificInput'] = @payment_product1525_specific_input.to_h unless @payment_product1525_specific_input.nil?
               hash['paymentProduct1526SpecificInput'] = @payment_product1526_specific_input.to_h unless @payment_product1526_specific_input.nil?
               hash
             end
 
             def from_hash(hash)
               super
+              if hash.has_key? 'paymentProduct1502SpecificInput'
+                raise TypeError, "value '%s' is not a Hash" % [hash['paymentProduct1502SpecificInput']] unless hash['paymentProduct1502SpecificInput'].is_a? Hash
+                @payment_product1502_specific_input = Worldline::Connect::SDK::V1::Domain::CashPaymentProduct1502SpecificInput.new_from_hash(hash['paymentProduct1502SpecificInput'])
+              end
               if hash.has_key? 'paymentProduct1503SpecificInput'
                 raise TypeError, "value '%s' is not a Hash" % [hash['paymentProduct1503SpecificInput']] unless hash['paymentProduct1503SpecificInput'].is_a? Hash
                 @payment_product1503_specific_input = Worldline::Connect::SDK::V1::Domain::CashPaymentProduct1503SpecificInput.new_from_hash(hash['paymentProduct1503SpecificInput'])
@@ -97,6 +111,10 @@ module Worldline
                 raise TypeError, "value '%s' is not a Hash" % [hash['paymentProduct1524SpecificInput']] unless hash['paymentProduct1524SpecificInput'].is_a? Hash
                 @payment_product1524_specific_input = Worldline::Connect::SDK::V1::Domain::CashPaymentProduct1524SpecificInput.new_from_hash(hash['paymentProduct1524SpecificInput'])
               end
+              if hash.has_key? 'paymentProduct1525SpecificInput'
+                raise TypeError, "value '%s' is not a Hash" % [hash['paymentProduct1525SpecificInput']] unless hash['paymentProduct1525SpecificInput'].is_a? Hash
+                @payment_product1525_specific_input = Worldline::Connect::SDK::V1::Domain::CashPaymentProduct1525SpecificInput.new_from_hash(hash['paymentProduct1525SpecificInput'])
+              end
               if hash.has_key? 'paymentProduct1526SpecificInput'
                 raise TypeError, "value '%s' is not a Hash" % [hash['paymentProduct1526SpecificInput']] unless hash['paymentProduct1526SpecificInput'].is_a? Hash
                 @payment_product1526_specific_input = Worldline::Connect::SDK::V1::Domain::CashPaymentProduct1526SpecificInput.new_from_hash(hash['paymentProduct1526SpecificInput'])

data/lib/worldline/connect/sdk/v1/domain/cash_payment_product1502_specific_input.rb

@@ -0,0 +1,18 @@
+#
+# This class was auto-generated from the API references found at
+# https://apireference.connect.worldline-solutions.com/
+#
+require 'worldline/connect/sdk/v1/domain/cash_payment_product_with_redirect_specific_input_base'
+
+module Worldline
+  module Connect
+    module SDK
+      module V1
+        module Domain
+          class CashPaymentProduct1502SpecificInput < Worldline::Connect::SDK::V1::Domain::CashPaymentProductWithRedirectSpecificInputBase
+          end
+        end
+      end
+    end
+  end
+end

data/lib/worldline/connect/sdk/v1/domain/cash_payment_product1525_specific_input.rb

@@ -0,0 +1,18 @@
+#
+# This class was auto-generated from the API references found at
+# https://apireference.connect.worldline-solutions.com/
+#
+require 'worldline/connect/sdk/v1/domain/cash_payment_product_with_redirect_specific_input_base'
+
+module Worldline
+  module Connect
+    module SDK
+      module V1
+        module Domain
+          class CashPaymentProduct1525SpecificInput < Worldline::Connect::SDK::V1::Domain::CashPaymentProductWithRedirectSpecificInputBase
+          end
+        end
+      end
+    end
+  end
+end

data/lib/worldline/connect/sdk/v1/domain/click_to_pay_configuration.rb

@@ -5,16 +5,20 @@
 require 'worldline/connect/sdk/domain/data_object'
 require 'worldline/connect/sdk/v1/domain/click_to_pay_configuration_mastercard'
 require 'worldline/connect/sdk/v1/domain/click_to_pay_configuration_visa'
+require 'worldline/connect/sdk/v1/domain/click_to_pay_display_hints'
 
 module Worldline
   module Connect
     module SDK
       module V1
         module Domain
+          # @attr [Worldline::Connect::SDK::V1::Domain::ClickToPayDisplayHints] display_hints
           # @attr [Worldline::Connect::SDK::V1::Domain::ClickToPayConfigurationMastercard] mastercard
           # @attr [Worldline::Connect::SDK::V1::Domain::ClickToPayConfigurationVisa] visa
           class ClickToPayConfiguration < Worldline::Connect::SDK::Domain::DataObject
 
+            attr_accessor :display_hints
+
             attr_accessor :mastercard
 
             attr_accessor :visa
@@ -22,6 +26,7 @@ module Worldline
             # @return (Hash)
             def to_h
               hash = super
+              hash['displayHints'] = @display_hints.to_h unless @display_hints.nil?
               hash['mastercard'] = @mastercard.to_h unless @mastercard.nil?
               hash['visa'] = @visa.to_h unless @visa.nil?
               hash
@@ -29,6 +34,10 @@ module Worldline
 
             def from_hash(hash)
               super
+              if hash.has_key? 'displayHints'
+                raise TypeError, "value '%s' is not a Hash" % [hash['displayHints']] unless hash['displayHints'].is_a? Hash
+                @display_hints = Worldline::Connect::SDK::V1::Domain::ClickToPayDisplayHints.new_from_hash(hash['displayHints'])
+              end
               if hash.has_key? 'mastercard'
                 raise TypeError, "value '%s' is not a Hash" % [hash['mastercard']] unless hash['mastercard'].is_a? Hash
                 @mastercard = Worldline::Connect::SDK::V1::Domain::ClickToPayConfigurationMastercard.new_from_hash(hash['mastercard'])

data/lib/worldline/connect/sdk/v1/domain/click_to_pay_display_hints.rb

@@ -0,0 +1,35 @@
+#
+# This class was auto-generated from the API references found at
+# https://apireference.connect.worldline-solutions.com/
+#
+require 'worldline/connect/sdk/domain/data_object'
+
+module Worldline
+  module Connect
+    module SDK
+      module V1
+        module Domain
+          # @attr [String] logo
+          class ClickToPayDisplayHints < Worldline::Connect::SDK::Domain::DataObject
+
+            attr_accessor :logo
+
+            # @return (Hash)
+            def to_h
+              hash = super
+              hash['logo'] = @logo unless @logo.nil?
+              hash
+            end
+
+            def from_hash(hash)
+              super
+              if hash.has_key? 'logo'
+                @logo = hash['logo']
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/worldline/connect/sdk/v1/merchant/payments/payments_client.rb

@@ -325,6 +325,38 @@ module Worldline
                 raise Worldline::Connect::SDK::V1.create_exception(e.status_code, e.body, error_object, context)
               end
 
+              # Resource /!{merchantId}/payments/!{paymentId}/finalizecapture - {https://apireference.connect.worldline-solutions.com/s2sapi/v1/en_US/ruby/payments/finalizecapture.html Finalize capture}
+              #
+              # @param payment_id [String]
+              # @param context    [Worldline::Connect::SDK::CallContext, nil]
+              # @return [Worldline::Connect::SDK::V1::Domain::PaymentResponse]
+              # @raise [Worldline::Connect::SDK::V1::IdempotenceException] if an idempotent request caused a conflict (HTTP status code 409)
+              # @raise [Worldline::Connect::SDK::V1::ValidationException] if the request was not correct and couldn't be processed (HTTP status code 400)
+              # @raise [Worldline::Connect::SDK::V1::AuthorizationException] if the request was not allowed (HTTP status code 403)
+              # @raise [Worldline::Connect::SDK::V1::ReferenceException] if an object was attempted to be referenced that doesn't exist or has been removed,
+              #        or there was a conflict (HTTP status code 404, 409 or 410)
+              # @raise [Worldline::Connect::SDK::V1::PlatformException] if something went wrong at the Worldline Global Collect platform,
+              #        the Worldline Global Collect platform was unable to process a message from a downstream partner/acquirer,
+              #        or the service that you're trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)
+              # @raise [Worldline::Connect::SDK::V1::ApiException] if the Worldline Global Collect platform returned any other error
+              def finalizecapture(payment_id, context = nil)
+                path_context = {
+                  'paymentId'.freeze => payment_id,
+                }
+                uri = instantiate_uri('/v1/{merchantId}/payments/{paymentId}/finalizecapture', path_context)
+                @communicator.post(
+                  uri,
+                  client_headers,
+                  nil,
+                  nil,
+                  Worldline::Connect::SDK::V1::Domain::PaymentResponse,
+                  context)
+              rescue ResponseException => e
+                error_type = Worldline::Connect::SDK::V1::Domain::ErrorResponse
+                error_object = @communicator.marshaller.unmarshal(e.body, error_type)
+                raise Worldline::Connect::SDK::V1.create_exception(e.status_code, e.body, error_object, context)
+              end
+
               # Resource /!{merchantId}/payments/!{paymentId}/cancelapproval - {https://apireference.connect.worldline-solutions.com/s2sapi/v1/en_US/ruby/payments/cancelapproval.html Undo capture payment}
               #
               # @param payment_id [String]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: connect-sdk-ruby
 version: !ruby/object:Gem::Version
-  version: 4.3.0
+  version: 4.5.0
 platform: ruby
 authors:
 - Worldline Global Collect
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-11 00:00:00.000000000 Z
+date: 2026-03-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httpclient
@@ -170,6 +170,7 @@ files:
 - examples/v1/merchant/payments/complete_payment_example.rb
 - examples/v1/merchant/payments/create_payment_dispute_example.rb
 - examples/v1/merchant/payments/create_payment_example.rb
+- examples/v1/merchant/payments/finalize_capture_example.rb
 - examples/v1/merchant/payments/find_payments_example.rb
 - examples/v1/merchant/payments/get_payment_captures_example.rb
 - examples/v1/merchant/payments/get_payment_device_fingerprint_details_example.rb
@@ -355,6 +356,7 @@ files:
 - lib/worldline/connect/sdk/v1/domain/cash_payment_method_specific_input.rb
 - lib/worldline/connect/sdk/v1/domain/cash_payment_method_specific_input_base.rb
 - lib/worldline/connect/sdk/v1/domain/cash_payment_method_specific_output.rb
+- lib/worldline/connect/sdk/v1/domain/cash_payment_product1502_specific_input.rb
 - lib/worldline/connect/sdk/v1/domain/cash_payment_product1503_specific_input.rb
 - lib/worldline/connect/sdk/v1/domain/cash_payment_product1504_specific_input.rb
 - lib/worldline/connect/sdk/v1/domain/cash_payment_product1506_specific_input.rb
@@ -363,11 +365,13 @@ files:
 - lib/worldline/connect/sdk/v1/domain/cash_payment_product1522_specific_input.rb
 - lib/worldline/connect/sdk/v1/domain/cash_payment_product1523_specific_input.rb
 - lib/worldline/connect/sdk/v1/domain/cash_payment_product1524_specific_input.rb
+- lib/worldline/connect/sdk/v1/domain/cash_payment_product1525_specific_input.rb
 - lib/worldline/connect/sdk/v1/domain/cash_payment_product1526_specific_input.rb
 - lib/worldline/connect/sdk/v1/domain/cash_payment_product_with_redirect_specific_input_base.rb
 - lib/worldline/connect/sdk/v1/domain/click_to_pay_configuration.rb
 - lib/worldline/connect/sdk/v1/domain/click_to_pay_configuration_mastercard.rb
 - lib/worldline/connect/sdk/v1/domain/click_to_pay_configuration_visa.rb
+- lib/worldline/connect/sdk/v1/domain/click_to_pay_display_hints.rb
 - lib/worldline/connect/sdk/v1/domain/click_to_pay_scheme_configuration_base.rb
 - lib/worldline/connect/sdk/v1/domain/company_information.rb
 - lib/worldline/connect/sdk/v1/domain/complete_payment_card_payment_method_specific_input.rb