connect-sdk-ruby 2.25.0 → 2.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7d3544e10cd38ce540eed9db96f91d7528f199344048fdf30a1c0e2fbfac7d88
-  data.tar.gz: 98805c926124ced5fe4237ad63d2ed40dc0e76fb16ca6ea12d510f50f809ea08
+  metadata.gz: cf5846113a34444077709cdd1442d0e0ce79d53aafd628759e1b263b4e6377b2
+  data.tar.gz: 4340e5ca7922f121f5c36317945b55f4ea85c642d1c5eb8e63cce9b3356ddb92
 SHA512:
-  metadata.gz: 1c6d44127b3971794d6dc04d1156da56b45bc778af36e55d90eca4695b6369f660b44de56f53336ee95e15db3de85035b45b3d0e7e5ed5f77c0b1895f9856479
-  data.tar.gz: 13727982fff96b31b113738cbbc3242703b84236ebb0bfd040e180e25311762ecdadf6f112b725384cfbf2b3b451f841103ff7a3ca92a2911ac10bb5156e096d
+  metadata.gz: 3f44ab2a432db832f597d63548ae2f28eb329af96fc32a571b0e1fe2b82f71ac0f5ea5b80fbfb25bd63b4baa906b4eef1b9cbae4f0545c72b14b6041bdb9429f
+  data.tar.gz: 5875974191b3326f5bdc3131429f31dea8379cf95738795a71074cb3512299b1916050655f62a18df57be98787906fada45b29a83d488034e8d2b16204d24fdb

data/connect-sdk-ruby.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |spec|
   spec.name           = 'connect-sdk-ruby'
-  spec.version        = '2.25.0'
+  spec.version        = '2.29.0'
   spec.authors        = ['Ingenico ePayments']
   spec.email          = ['github@epay.ingenico.com']
   spec.summary        = %q{SDK to communicate with the Ingenico ePayments platform using the Ingenico Connect Server API}

data/examples/merchant/captures/create_refund_capture_example.rb

@@ -0,0 +1,54 @@
+#
+# This class was auto-generated from the API references found at
+# https://epayments-api.developer-ingenico.com/s2sapi/v1/
+#
+require 'ingenico/connect/sdk/api_exception'
+require 'ingenico/connect/sdk/declined_refund_exception'
+require 'ingenico/connect/sdk/factory'
+require 'ingenico/connect/sdk/domain/definitions/amount_of_money'
+require 'ingenico/connect/sdk/domain/refund/refund_references'
+require 'ingenico/connect/sdk/domain/refund/refund_request'
+
+Definitions = Ingenico::Connect::SDK::Domain::Definitions
+Refund = Ingenico::Connect::SDK::Domain::Refund
+
+def example
+  get_client do |client|
+    amount_of_money = Definitions::AmountOfMoney.new
+    amount_of_money.amount = 500
+    amount_of_money.currency_code = 'EUR'
+
+    refund_references = Refund::RefundReferences.new
+    refund_references.merchant_reference = 'AcmeOrder0001'
+
+    body = Refund::RefundRequest.new
+    body.amount_of_money = amount_of_money
+    body.refund_references = refund_references
+
+    begin
+      response = client.merchant('merchantId').captures.refund('captureId', body)
+    rescue Ingenico::Connect::SDK::DeclinedRefundException => e
+      handle_declined_refund(e.refund_result)
+    rescue Ingenico::Connect::SDK::ApiException => e
+      handle_api_errors(e.errors)
+    end
+  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 = Ingenico::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
+
+def handle_declined_refund(refund_result)
+  # handle the result here
+end
+
+def handle_api_errors(errors)
+  # handle the errors here
+end

data/examples/merchant/hostedcheckouts/delete_hosted_checkout_example.rb

@@ -0,0 +1,22 @@
+#
+# This class was auto-generated from the API references found at
+# https://epayments-api.developer-ingenico.com/s2sapi/v1/
+#
+require 'ingenico/connect/sdk/factory'
+
+
+def example
+  get_client do |client|
+    client.merchant('merchantId').hostedcheckouts.delete('hostedCheckoutId')
+  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 = Ingenico::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/examples/merchant/services/get_settlement_details_example.rb

@@ -0,0 +1,22 @@
+#
+# This class was auto-generated from the API references found at
+# https://epayments-api.developer-ingenico.com/s2sapi/v1/
+#
+require 'ingenico/connect/sdk/factory'
+
+
+def example
+  get_client do |client|
+    response = client.merchant('merchantId').services.settlementdetails('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 = Ingenico::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/ingenico/connect/sdk/domain/definitions/card.rb

@@ -9,14 +9,18 @@ module Ingenico::Connect::SDK
     module Definitions
 
       # @attr [String] cvv
+      # @attr [String] partial_pin
       class Card < Ingenico::Connect::SDK::Domain::Definitions::CardWithoutCvv
 
         attr_accessor :cvv
 
+        attr_accessor :partial_pin
+
         # @return (Hash)
         def to_h
           hash = super
           hash['cvv'] = @cvv unless @cvv.nil?
+          hash['partialPin'] = @partial_pin unless @partial_pin.nil?
           hash
         end
 
@@ -25,6 +29,9 @@ module Ingenico::Connect::SDK
           if hash.has_key? 'cvv'
             @cvv = hash['cvv']
           end
+          if hash.has_key? 'partialPin'
+            @partial_pin = hash['partialPin']
+          end
         end
       end
     end

data/lib/ingenico/connect/sdk/domain/definitions/card_fraud_results.rb

@@ -5,6 +5,7 @@
 require 'ingenico/connect/sdk/domain/definitions/fraud_results'
 require 'ingenico/connect/sdk/domain/definitions/fraud_results_retail_decisions'
 require 'ingenico/connect/sdk/domain/definitions/fraugster_results'
+require 'ingenico/connect/sdk/domain/definitions/microsoft_fraud_results'
 
 module Ingenico::Connect::SDK
   module Domain
@@ -13,6 +14,7 @@ module Ingenico::Connect::SDK
       # @attr [String] avs_result
       # @attr [String] cvv_result
       # @attr [Ingenico::Connect::SDK::Domain::Definitions::FraugsterResults] fraugster
+      # @attr [Ingenico::Connect::SDK::Domain::Definitions::MicrosoftFraudResults] microsoft_fraud_protection
       # @attr [Ingenico::Connect::SDK::Domain::Definitions::FraudResultsRetailDecisions] retail_decisions
       class CardFraudResults < Ingenico::Connect::SDK::Domain::Definitions::FraudResults
 
@@ -22,6 +24,8 @@ module Ingenico::Connect::SDK
 
         attr_accessor :fraugster
 
+        attr_accessor :microsoft_fraud_protection
+
         attr_accessor :retail_decisions
 
         # @return (Hash)
@@ -30,6 +34,7 @@ module Ingenico::Connect::SDK
           hash['avsResult'] = @avs_result unless @avs_result.nil?
           hash['cvvResult'] = @cvv_result unless @cvv_result.nil?
           hash['fraugster'] = @fraugster.to_h unless @fraugster.nil?
+          hash['microsoftFraudProtection'] = @microsoft_fraud_protection.to_h unless @microsoft_fraud_protection.nil?
           hash['retailDecisions'] = @retail_decisions.to_h unless @retail_decisions.nil?
           hash
         end
@@ -46,6 +51,10 @@ module Ingenico::Connect::SDK
             raise TypeError, "value '%s' is not a Hash" % [hash['fraugster']] unless hash['fraugster'].is_a? Hash
             @fraugster = Ingenico::Connect::SDK::Domain::Definitions::FraugsterResults.new_from_hash(hash['fraugster'])
           end
+          if hash.has_key? 'microsoftFraudProtection'
+            raise TypeError, "value '%s' is not a Hash" % [hash['microsoftFraudProtection']] unless hash['microsoftFraudProtection'].is_a? Hash
+            @microsoft_fraud_protection = Ingenico::Connect::SDK::Domain::Definitions::MicrosoftFraudResults.new_from_hash(hash['microsoftFraudProtection'])
+          end
           if hash.has_key? 'retailDecisions'
             raise TypeError, "value '%s' is not a Hash" % [hash['retailDecisions']] unless hash['retailDecisions'].is_a? Hash
             @retail_decisions = Ingenico::Connect::SDK::Domain::Definitions::FraudResultsRetailDecisions.new_from_hash(hash['retailDecisions'])

data/lib/ingenico/connect/sdk/domain/definitions/microsoft_fraud_results.rb

@@ -0,0 +1,32 @@
+#
+# This class was auto-generated from the API references found at
+# https://epayments-api.developer-ingenico.com/s2sapi/v1/
+#
+require 'ingenico/connect/sdk/data_object'
+
+module Ingenico::Connect::SDK
+  module Domain
+    module Definitions
+
+      # @attr [Integer] fraud_score
+      class MicrosoftFraudResults < Ingenico::Connect::SDK::DataObject
+
+        attr_accessor :fraud_score
+
+        # @return (Hash)
+        def to_h
+          hash = super
+          hash['fraudScore'] = @fraud_score unless @fraud_score.nil?
+          hash
+        end
+
+        def from_hash(hash)
+          super
+          if hash.has_key? 'fraudScore'
+            @fraud_score = hash['fraudScore']
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ingenico/connect/sdk/domain/payment/cash_payment_method_specific_input.rb

@@ -5,6 +5,9 @@
 require 'ingenico/connect/sdk/domain/payment/abstract_cash_payment_method_specific_input'
 require 'ingenico/connect/sdk/domain/payment/cash_payment_product1503_specific_input'
 require 'ingenico/connect/sdk/domain/payment/cash_payment_product1504_specific_input'
+require 'ingenico/connect/sdk/domain/payment/cash_payment_product1506_specific_input'
+require 'ingenico/connect/sdk/domain/payment/cash_payment_product1508_specific_input'
+require 'ingenico/connect/sdk/domain/payment/cash_payment_product1511_specific_input'
 require 'ingenico/connect/sdk/domain/payment/cash_payment_product1521_specific_input'
 require 'ingenico/connect/sdk/domain/payment/cash_payment_product1522_specific_input'
 require 'ingenico/connect/sdk/domain/payment/cash_payment_product1523_specific_input'
@@ -17,6 +20,9 @@ module Ingenico::Connect::SDK
 
       # @attr [Ingenico::Connect::SDK::Domain::Payment::CashPaymentProduct1503SpecificInput] payment_product1503_specific_input
       # @attr [Ingenico::Connect::SDK::Domain::Payment::CashPaymentProduct1504SpecificInput] payment_product1504_specific_input
+      # @attr [Ingenico::Connect::SDK::Domain::Payment::CashPaymentProduct1506SpecificInput] payment_product1506_specific_input
+      # @attr [Ingenico::Connect::SDK::Domain::Payment::CashPaymentProduct1508SpecificInput] payment_product1508_specific_input
+      # @attr [Ingenico::Connect::SDK::Domain::Payment::CashPaymentProduct1511SpecificInput] payment_product1511_specific_input
       # @attr [Ingenico::Connect::SDK::Domain::Payment::CashPaymentProduct1521SpecificInput] payment_product1521_specific_input
       # @attr [Ingenico::Connect::SDK::Domain::Payment::CashPaymentProduct1522SpecificInput] payment_product1522_specific_input
       # @attr [Ingenico::Connect::SDK::Domain::Payment::CashPaymentProduct1523SpecificInput] payment_product1523_specific_input
@@ -30,6 +36,12 @@ module Ingenico::Connect::SDK
 
         attr_accessor :payment_product1504_specific_input
 
+        attr_accessor :payment_product1506_specific_input
+
+        attr_accessor :payment_product1508_specific_input
+
+        attr_accessor :payment_product1511_specific_input
+
         attr_accessor :payment_product1521_specific_input
 
         attr_accessor :payment_product1522_specific_input
@@ -45,6 +57,9 @@ module Ingenico::Connect::SDK
           hash = super
           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?
+          hash['paymentProduct1508SpecificInput'] = @payment_product1508_specific_input.to_h unless @payment_product1508_specific_input.nil?
+          hash['paymentProduct1511SpecificInput'] = @payment_product1511_specific_input.to_h unless @payment_product1511_specific_input.nil?
           hash['paymentProduct1521SpecificInput'] = @payment_product1521_specific_input.to_h unless @payment_product1521_specific_input.nil?
           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?
@@ -63,6 +78,18 @@ module Ingenico::Connect::SDK
             raise TypeError, "value '%s' is not a Hash" % [hash['paymentProduct1504SpecificInput']] unless hash['paymentProduct1504SpecificInput'].is_a? Hash
             @payment_product1504_specific_input = Ingenico::Connect::SDK::Domain::Payment::CashPaymentProduct1504SpecificInput.new_from_hash(hash['paymentProduct1504SpecificInput'])
           end
+          if hash.has_key? 'paymentProduct1506SpecificInput'
+            raise TypeError, "value '%s' is not a Hash" % [hash['paymentProduct1506SpecificInput']] unless hash['paymentProduct1506SpecificInput'].is_a? Hash
+            @payment_product1506_specific_input = Ingenico::Connect::SDK::Domain::Payment::CashPaymentProduct1506SpecificInput.new_from_hash(hash['paymentProduct1506SpecificInput'])
+          end
+          if hash.has_key? 'paymentProduct1508SpecificInput'
+            raise TypeError, "value '%s' is not a Hash" % [hash['paymentProduct1508SpecificInput']] unless hash['paymentProduct1508SpecificInput'].is_a? Hash
+            @payment_product1508_specific_input = Ingenico::Connect::SDK::Domain::Payment::CashPaymentProduct1508SpecificInput.new_from_hash(hash['paymentProduct1508SpecificInput'])
+          end
+          if hash.has_key? 'paymentProduct1511SpecificInput'
+            raise TypeError, "value '%s' is not a Hash" % [hash['paymentProduct1511SpecificInput']] unless hash['paymentProduct1511SpecificInput'].is_a? Hash
+            @payment_product1511_specific_input = Ingenico::Connect::SDK::Domain::Payment::CashPaymentProduct1511SpecificInput.new_from_hash(hash['paymentProduct1511SpecificInput'])
+          end
           if hash.has_key? 'paymentProduct1521SpecificInput'
             raise TypeError, "value '%s' is not a Hash" % [hash['paymentProduct1521SpecificInput']] unless hash['paymentProduct1521SpecificInput'].is_a? Hash
             @payment_product1521_specific_input = Ingenico::Connect::SDK::Domain::Payment::CashPaymentProduct1521SpecificInput.new_from_hash(hash['paymentProduct1521SpecificInput'])

data/lib/ingenico/connect/sdk/domain/payment/cash_payment_product1506_specific_input.rb

@@ -0,0 +1,32 @@
+#
+# This class was auto-generated from the API references found at
+# https://epayments-api.developer-ingenico.com/s2sapi/v1/
+#
+require 'ingenico/connect/sdk/data_object'
+
+module Ingenico::Connect::SDK
+  module Domain
+    module Payment
+
+      # @attr [String] return_url
+      class CashPaymentProduct1506SpecificInput < Ingenico::Connect::SDK::DataObject
+
+        attr_accessor :return_url
+
+        # @return (Hash)
+        def to_h
+          hash = super
+          hash['returnUrl'] = @return_url unless @return_url.nil?
+          hash
+        end
+
+        def from_hash(hash)
+          super
+          if hash.has_key? 'returnUrl'
+            @return_url = hash['returnUrl']
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ingenico/connect/sdk/domain/payment/cash_payment_product1508_specific_input.rb

@@ -0,0 +1,32 @@
+#
+# This class was auto-generated from the API references found at
+# https://epayments-api.developer-ingenico.com/s2sapi/v1/
+#
+require 'ingenico/connect/sdk/data_object'
+
+module Ingenico::Connect::SDK
+  module Domain
+    module Payment
+
+      # @attr [String] return_url
+      class CashPaymentProduct1508SpecificInput < Ingenico::Connect::SDK::DataObject
+
+        attr_accessor :return_url
+
+        # @return (Hash)
+        def to_h
+          hash = super
+          hash['returnUrl'] = @return_url unless @return_url.nil?
+          hash
+        end
+
+        def from_hash(hash)
+          super
+          if hash.has_key? 'returnUrl'
+            @return_url = hash['returnUrl']
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ingenico/connect/sdk/domain/payment/cash_payment_product1511_specific_input.rb

@@ -0,0 +1,32 @@
+#
+# This class was auto-generated from the API references found at
+# https://epayments-api.developer-ingenico.com/s2sapi/v1/
+#
+require 'ingenico/connect/sdk/data_object'
+
+module Ingenico::Connect::SDK
+  module Domain
+    module Payment
+
+      # @attr [String] return_url
+      class CashPaymentProduct1511SpecificInput < Ingenico::Connect::SDK::DataObject
+
+        attr_accessor :return_url
+
+        # @return (Hash)
+        def to_h
+          hash = super
+          hash['returnUrl'] = @return_url unless @return_url.nil?
+          hash
+        end
+
+        def from_hash(hash)
+          super
+          if hash.has_key? 'returnUrl'
+            @return_url = hash['returnUrl']
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ingenico/connect/sdk/domain/payment/order_line_details.rb

@@ -15,6 +15,7 @@ module Ingenico::Connect::SDK
       # @attr [String] product_code
       # @attr [String] product_name
       # @attr [Integer] product_price
+      # @attr [String] product_sku
       # @attr [String] product_type
       # @attr [Integer] quantity
       # @attr [Integer] tax_amount
@@ -35,6 +36,8 @@ module Ingenico::Connect::SDK
 
         attr_accessor :product_price
 
+        attr_accessor :product_sku
+
         attr_accessor :product_type
 
         attr_accessor :quantity
@@ -53,6 +56,7 @@ module Ingenico::Connect::SDK
           hash['productCode'] = @product_code unless @product_code.nil?
           hash['productName'] = @product_name unless @product_name.nil?
           hash['productPrice'] = @product_price unless @product_price.nil?
+          hash['productSku'] = @product_sku unless @product_sku.nil?
           hash['productType'] = @product_type unless @product_type.nil?
           hash['quantity'] = @quantity unless @quantity.nil?
           hash['taxAmount'] = @tax_amount unless @tax_amount.nil?
@@ -83,6 +87,9 @@ module Ingenico::Connect::SDK
           if hash.has_key? 'productPrice'
             @product_price = hash['productPrice']
           end
+          if hash.has_key? 'productSku'
+            @product_sku = hash['productSku']
+          end
           if hash.has_key? 'productType'
             @product_type = hash['productType']
           end

data/lib/ingenico/connect/sdk/domain/services/settlement_details.rb

@@ -0,0 +1,55 @@
+#
+# This class was auto-generated from the API references found at
+# https://epayments-api.developer-ingenico.com/s2sapi/v1/
+#
+require 'ingenico/connect/sdk/data_object'
+require 'ingenico/connect/sdk/domain/definitions/amount_of_money'
+
+module Ingenico::Connect::SDK
+  module Domain
+    module Services
+
+      # @attr [String] acquirer_reference_number
+      # @attr [Ingenico::Connect::SDK::Domain::Definitions::AmountOfMoney] amount_of_money
+      # @attr [String] payment_id
+      # @attr [String] retrieval_reference_number
+      class SettlementDetails < Ingenico::Connect::SDK::DataObject
+
+        attr_accessor :acquirer_reference_number
+
+        attr_accessor :amount_of_money
+
+        attr_accessor :payment_id
+
+        attr_accessor :retrieval_reference_number
+
+        # @return (Hash)
+        def to_h
+          hash = super
+          hash['acquirerReferenceNumber'] = @acquirer_reference_number unless @acquirer_reference_number.nil?
+          hash['amountOfMoney'] = @amount_of_money.to_h unless @amount_of_money.nil?
+          hash['paymentId'] = @payment_id unless @payment_id.nil?
+          hash['retrievalReferenceNumber'] = @retrieval_reference_number unless @retrieval_reference_number.nil?
+          hash
+        end
+
+        def from_hash(hash)
+          super
+          if hash.has_key? 'acquirerReferenceNumber'
+            @acquirer_reference_number = hash['acquirerReferenceNumber']
+          end
+          if hash.has_key? 'amountOfMoney'
+            raise TypeError, "value '%s' is not a Hash" % [hash['amountOfMoney']] unless hash['amountOfMoney'].is_a? Hash
+            @amount_of_money = Ingenico::Connect::SDK::Domain::Definitions::AmountOfMoney.new_from_hash(hash['amountOfMoney'])
+          end
+          if hash.has_key? 'paymentId'
+            @payment_id = hash['paymentId']
+          end
+          if hash.has_key? 'retrievalReferenceNumber'
+            @retrieval_reference_number = hash['retrievalReferenceNumber']
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ingenico/connect/sdk/merchant/captures/captures_client.rb

@@ -6,6 +6,8 @@ require 'ingenico/connect/sdk/api_resource'
 require 'ingenico/connect/sdk/response_exception'
 require 'ingenico/connect/sdk/domain/capture/capture_response'
 require 'ingenico/connect/sdk/domain/errors/error_response'
+require 'ingenico/connect/sdk/domain/refund/refund_error_response'
+require 'ingenico/connect/sdk/domain/refund/refund_response'
 
 module Ingenico::Connect::SDK
   module Merchant
@@ -49,6 +51,39 @@ module Ingenico::Connect::SDK
           error_object = @communicator.marshaller.unmarshal(e.body, error_type)
           raise create_exception(e.status_code, e.body, error_object, context)
         end
+
+        # Resource /!{merchantId}/captures/!{captureId}/refund - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/captures/refund.html Create Refund}
+        # @param capture_id [String]
+        # @param body       [Ingenico::Connect::SDK::Domain::Refund::RefundRequest]
+        # @param context    [Ingenico::Connect::SDK::CallContext]
+        # @return [Ingenico::Connect::SDK::Domain::Refund::RefundResponse]
+        # @raise [Ingenico::Connect::SDK::DeclinedRefundException] if the Ingenico ePayments platform declined / rejected the refund. The refund result will be available from the exception.
+        # @raise [Ingenico::Connect::SDK::ValidationException] if the request was not correct and couldn't be processed (HTTP status code 400)
+        # @raise [Ingenico::Connect::SDK::AuthorizationException] if the request was not allowed (HTTP status code 403)
+        # @raise [Ingenico::Connect::SDK::IdempotenceException] if an idempotent request caused a conflict (HTTP status code 409)
+        # @raise [Ingenico::Connect::SDK::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 [Ingenico::Connect::SDK::GlobalCollectException] if something went wrong at the Ingenico ePayments platform,
+        #        the Ingenico ePayments 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 [Ingenico::Connect::SDK::ApiException]if the Ingenico ePayments platform returned any other error
+        def refund(capture_id, body, context=nil)
+          path_context = {
+            'captureId'.freeze => capture_id,
+          }
+          uri = instantiate_uri('/v1/{merchantId}/captures/{captureId}/refund', path_context)
+          return @communicator.post(
+            uri,
+            client_headers,
+            nil,
+            body,
+            Ingenico::Connect::SDK::Domain::Refund::RefundResponse,
+            context)
+        rescue ResponseException => e
+          error_type = Ingenico::Connect::SDK::Domain::Refund::RefundErrorResponse
+          error_object = @communicator.marshaller.unmarshal(e.body, error_type)
+          raise create_exception(e.status_code, e.body, error_object, context)
+        end
       end
     end
   end

data/lib/ingenico/connect/sdk/merchant/hostedcheckouts/hostedcheckouts_client.rb

@@ -78,6 +78,35 @@ module Ingenico::Connect::SDK
           error_object = @communicator.marshaller.unmarshal(e.body, error_type)
           raise create_exception(e.status_code, e.body, error_object, context)
         end
+
+        # Resource /!{merchantId}/hostedcheckouts/!{hostedCheckoutId} - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/hostedcheckouts/delete.html Delete hosted checkout}
+        # @param hosted_checkout_id [String]
+        # @param context            [Ingenico::Connect::SDK::CallContext]
+        # @raise [Ingenico::Connect::SDK::ValidationException] if the request was not correct and couldn't be processed (HTTP status code 400)
+        # @raise [Ingenico::Connect::SDK::AuthorizationException] if the request was not allowed (HTTP status code 403)
+        # @raise [Ingenico::Connect::SDK::IdempotenceException] if an idempotent request caused a conflict (HTTP status code 409)
+        # @raise [Ingenico::Connect::SDK::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 [Ingenico::Connect::SDK::GlobalCollectException] if something went wrong at the Ingenico ePayments platform,
+        #        the Ingenico ePayments 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 [Ingenico::Connect::SDK::ApiException]if the Ingenico ePayments platform returned any other error
+        def delete(hosted_checkout_id, context=nil)
+          path_context = {
+            'hostedCheckoutId'.freeze => hosted_checkout_id,
+          }
+          uri = instantiate_uri('/v1/{merchantId}/hostedcheckouts/{hostedCheckoutId}', path_context)
+          return @communicator.delete(
+            uri,
+            client_headers,
+            nil,
+            nil,
+            context)
+        rescue ResponseException => e
+          error_type = Ingenico::Connect::SDK::Domain::Errors::ErrorResponse
+          error_object = @communicator.marshaller.unmarshal(e.body, error_type)
+          raise create_exception(e.status_code, e.body, error_object, context)
+        end
       end
     end
   end

data/lib/ingenico/connect/sdk/merchant/services/services_client.rb

@@ -9,6 +9,7 @@ require 'ingenico/connect/sdk/domain/services/bank_details_response'
 require 'ingenico/connect/sdk/domain/services/convert_amount'
 require 'ingenico/connect/sdk/domain/services/get_iin_details_response'
 require 'ingenico/connect/sdk/domain/services/get_privacy_policy_response'
+require 'ingenico/connect/sdk/domain/services/settlement_details'
 require 'ingenico/connect/sdk/domain/services/test_connection'
 
 module Ingenico::Connect::SDK
@@ -159,6 +160,36 @@ module Ingenico::Connect::SDK
           error_object = @communicator.marshaller.unmarshal(e.body, error_type)
           raise create_exception(e.status_code, e.body, error_object, context)
         end
+
+        # Resource /!{merchantId}/services/settlementdetails/!{paymentId} - {https://epayments-api.developer-ingenico.com/s2sapi/v1/en_US/ruby/services/settlementdetails.html Get Settlement details}
+        # @param payment_id [String]
+        # @param context    [Ingenico::Connect::SDK::CallContext]
+        # @return [Ingenico::Connect::SDK::Domain::Services::SettlementDetails]
+        # @raise [Ingenico::Connect::SDK::ValidationException] if the request was not correct and couldn't be processed (HTTP status code 400)
+        # @raise [Ingenico::Connect::SDK::AuthorizationException] if the request was not allowed (HTTP status code 403)
+        # @raise [Ingenico::Connect::SDK::IdempotenceException] if an idempotent request caused a conflict (HTTP status code 409)
+        # @raise [Ingenico::Connect::SDK::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 [Ingenico::Connect::SDK::GlobalCollectException] if something went wrong at the Ingenico ePayments platform,
+        #        the Ingenico ePayments 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 [Ingenico::Connect::SDK::ApiException]if the Ingenico ePayments platform returned any other error
+        def settlementdetails(payment_id, context=nil)
+          path_context = {
+            'paymentId'.freeze => payment_id,
+          }
+          uri = instantiate_uri('/v1/{merchantId}/services/settlementdetails/{paymentId}', path_context)
+          return @communicator.get(
+            uri,
+            client_headers,
+            nil,
+            Ingenico::Connect::SDK::Domain::Services::SettlementDetails,
+            context)
+        rescue ResponseException => e
+          error_type = Ingenico::Connect::SDK::Domain::Errors::ErrorResponse
+          error_object = @communicator.marshaller.unmarshal(e.body, error_type)
+          raise create_exception(e.status_code, e.body, error_object, context)
+        end
       end
     end
   end

data/lib/ingenico/connect/sdk/meta_data_provider.rb

@@ -7,7 +7,7 @@ module Ingenico::Connect::SDK
   #
   # @attr_reader [Array<Ingenico::Connect::SDK::RequestHeader>] meta_data_headers List of headers that should be used in all requests.
   class MetaDataProvider
-    @@SDK_VERSION = '2.25.0'
+    @@SDK_VERSION = '2.29.0'
     @@SERVER_META_INFO_HEADER = 'X-GCS-ServerMetaInfo'
     @@PROHIBITED_HEADERS = [@@SERVER_META_INFO_HEADER, 'X-GCS-Idempotence-Key',
                             'Date', 'Content-Type', 'Authorization'].sort!.freeze

data/spec/integration/idempotence_spec.rb

@@ -10,6 +10,7 @@ require 'ingenico/connect/sdk/domain/payment/order'
 require 'ingenico/connect/sdk/domain/payment/redirect_payment_product809_specific_input'
 require 'ingenico/connect/sdk/domain/payment/redirect_payment_method_specific_input'
 require 'ingenico/connect/sdk/call_context'
+require 'ingenico/connect/sdk/declined_payment_exception'
 
 describe 'Idempotence with the server' do
 
@@ -41,17 +42,31 @@ describe 'Idempotence with the server' do
     context = Ingenico::Connect::SDK::CallContext.new(idempotence_key)
 
     Integration.init_client(false) do |client|
-      response = client.merchant(Integration::MERCHANT_ID).payments.create(body, context)
-      payment_id = response.payment.id
+      def do_create_payment(client, body, context)
+        # For this test it doesn't matter if the response is successful or declined,
+        # as long as idempotence is handled correctly
+        begin
+          client.merchant(Integration::MERCHANT_ID).payments.create(body, context)
+        rescue Ingenico::Connect::SDK::DeclinedPaymentException => ex
+          ex.payment_result
+        end
+      end
+
+      result = do_create_payment(client, body, context)
+      payment_id = result.payment.id
+      status = result.payment.status
 
       expect(payment_id).to_not be_nil
+      expect(status).to_not be_nil
       expect(context.idempotence_key).to eq(idempotence_key)
       expect(context.idempotence_request_timestamp).to be_nil
 
-      response_2 = client.merchant(Integration::MERCHANT_ID).payments.create(body, context)
-      payment_id2 = response_2.payment.id
+      result_2 = do_create_payment(client, body, context)
+      payment_id2 = result_2.payment.id
+      status2 = result_2.payment.status
 
-      expect(payment_id).to eq(payment_id2)
+      expect(payment_id2).to eq(payment_id)
+      expect(status2).to eq(status)
       expect(context.idempotence_key).to eq(idempotence_key)
       expect(context.idempotence_request_timestamp).to_not be_nil
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: connect-sdk-ruby
 version: !ruby/object:Gem::Version
-  version: 2.25.0
+  version: 2.29.0
 platform: ruby
 authors:
 - Ingenico ePayments
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-10-07 00:00:00.000000000 Z
+date: 2022-01-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httpclient
@@ -127,6 +127,7 @@ files:
 - README.md
 - Rakefile
 - connect-sdk-ruby.gemspec
+- examples/merchant/captures/create_refund_capture_example.rb
 - examples/merchant/captures/get_capture_example.rb
 - examples/merchant/disputes/cancel_dispute_example.rb
 - examples/merchant/disputes/get_dispute_example.rb
@@ -135,6 +136,7 @@ files:
 - examples/merchant/example_configuration.yml
 - examples/merchant/files/get_file_example.rb
 - examples/merchant/hostedcheckouts/create_hosted_checkout_example.rb
+- examples/merchant/hostedcheckouts/delete_hosted_checkout_example.rb
 - examples/merchant/hostedcheckouts/get_hosted_checkout_example.rb
 - examples/merchant/hostedmandatemanagements/create_hosted_mandate_management_example.rb
 - examples/merchant/hostedmandatemanagements/get_hosted_mandate_management_example.rb
@@ -187,6 +189,7 @@ files:
 - examples/merchant/services/convert_amount_example.rb
 - examples/merchant/services/convert_bank_account_example.rb
 - examples/merchant/services/get_privacy_policy_example.rb
+- examples/merchant/services/get_settlement_details_example.rb
 - examples/merchant/services/iin_details_example.rb
 - examples/merchant/services/test_connection_example.rb
 - examples/merchant/sessions/create_session_example.rb
@@ -249,6 +252,7 @@ files:
 - lib/ingenico/connect/sdk/domain/definitions/lodging_charge.rb
 - lib/ingenico/connect/sdk/domain/definitions/lodging_data.rb
 - lib/ingenico/connect/sdk/domain/definitions/lodging_room.rb
+- lib/ingenico/connect/sdk/domain/definitions/microsoft_fraud_results.rb
 - lib/ingenico/connect/sdk/domain/definitions/order_status_output.rb
 - lib/ingenico/connect/sdk/domain/definitions/payment_product_filter.rb
 - lib/ingenico/connect/sdk/domain/definitions/personal_name_base.rb
@@ -336,6 +340,9 @@ files:
 - lib/ingenico/connect/sdk/domain/payment/cash_payment_method_specific_output.rb
 - lib/ingenico/connect/sdk/domain/payment/cash_payment_product1503_specific_input.rb
 - lib/ingenico/connect/sdk/domain/payment/cash_payment_product1504_specific_input.rb
+- lib/ingenico/connect/sdk/domain/payment/cash_payment_product1506_specific_input.rb
+- lib/ingenico/connect/sdk/domain/payment/cash_payment_product1508_specific_input.rb
+- lib/ingenico/connect/sdk/domain/payment/cash_payment_product1511_specific_input.rb
 - lib/ingenico/connect/sdk/domain/payment/cash_payment_product1521_specific_input.rb
 - lib/ingenico/connect/sdk/domain/payment/cash_payment_product1522_specific_input.rb
 - lib/ingenico/connect/sdk/domain/payment/cash_payment_product1523_specific_input.rb
@@ -545,6 +552,7 @@ files:
 - lib/ingenico/connect/sdk/domain/services/get_privacy_policy_response.rb
 - lib/ingenico/connect/sdk/domain/services/iin_detail.rb
 - lib/ingenico/connect/sdk/domain/services/payment_context.rb
+- lib/ingenico/connect/sdk/domain/services/settlement_details.rb
 - lib/ingenico/connect/sdk/domain/services/swift.rb
 - lib/ingenico/connect/sdk/domain/services/test_connection.rb
 - lib/ingenico/connect/sdk/domain/sessions/payment_product_filters_client_session.rb