checkout_sdk 2.7.1 → 2.8.0

data/lib/checkout_sdk/payments/source/currency_account_source.rb

@@ -2,6 +2,14 @@
 
 module CheckoutSdk
   module Payments
+    # A currency account source, with type currency_account.
+    # Used by card payouts, bank payouts and unreferenced refunds.
+    #
+    # id: the ID of the currency account that will fund the payout or the unreferenced refund. For bank
+    # payouts, its holding currency must match the payout's currency.
+    # [Required]
+    # ^(ca)_(\w{26})$
+    # 29 characters
     class CurrencyAccountSource < PayoutSource
       def initialize
         super(PayoutSourceType::CURRENCY_ACCOUNT)

data/lib/checkout_sdk/payments/source/entity_source.rb

@@ -2,6 +2,11 @@
 
 module CheckoutSdk
   module Payments
+    # An entity source, with type entity. Bank payouts only.
+    #
+    # id: the entity or sub-entity's identifier, only applies to Platform Clients.
+    # [Required]
+    # ^(ent)_(\w{26})$
     class EntitySource < PayoutSource
       def initialize
         super(PayoutSourceType::ENTITY)

data/lib/checkout_sdk/payments/source/payout_source.rb

@@ -2,12 +2,23 @@
 
 module CheckoutSdk
   module Payments
+    # The source of a card payout, bank payout or unreferenced refund.
+    #
     # @!attribute type
+    #   The payout source type. Set by each subclass.
+    #   [Required]
     #   @return [String] {PayoutSourceType}
     # @!attribute id
+    #   The identifier of the source. See {CurrencyAccountSource} and {EntitySource} for the format.
+    #   [Required]
     #   @return [String]
     # @!attribute amount
-    #   @return [String]
+    #   The amount of the source.
+    #   [Optional]
+    #   @deprecated Not in the request schema of any payout or unreferenced refund source; still returned in
+    #     PayoutDetails (source.amount). Retained for backwards compatibility and will be removed in the next
+    #     major version. There is no replacement.
+    #   @return [Integer]
     class PayoutSource
       attr_reader :type
       attr_accessor :id,

data/lib/checkout_sdk/payments/unreferenced_refund_request.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Payments
+    # An unreferenced refund request, sent to POST /payments.
+    # The payment_type is set to UnreferencedRefund by the constructor.
+    #
+    # @!attribute source
+    #   The source of the unreferenced refund.
+    #   Only type and id are part of this position; amount is not used.
+    #   [Required]
+    #   @return [CurrencyAccountSource]
+    # @!attribute destination
+    #   The destination of the unreferenced refund.
+    #   Takes {CardDestination}, {NetworkTokenDestination}, {IdDestination} or {TokenDestination}.
+    #   [Required]
+    #   @return [Destination]
+    # @!attribute instruction
+    #   Additional details about the unreferenced refund instruction.
+    #   Only funds_transfer_type and purpose are part of this position.
+    #   [Optional]
+    #   @return [PaymentInstruction]
+    # @!attribute amount
+    #   The amount in minor currency.
+    #   [Required]
+    #   Format: int64
+    #   min 1
+    #   max 9999999999
+    #   @return [Integer]
+    # @!attribute currency
+    #   The three-letter ISO currency code of the payment.
+    #   [Required]
+    #   3 characters
+    #   @return [String] {CheckoutSdk::Common::Currency}
+    # @!attribute payment_type
+    #   The type of the payment. Set to UnreferencedRefund by the constructor.
+    #   [Required]
+    #   Enum: "UnreferencedRefund"
+    #   @return [String]
+    # @!attribute processing_channel_id
+    #   The processing channel identifier.
+    #   [Required]
+    #   ^(pc)_(\w{26})$
+    #   @return [String]
+    # @!attribute reference
+    #   An internal reference you can later use to identify this payment.
+    #   [Optional]
+    #   @return [String]
+    # @!attribute metadata
+    #   A set of key-value pairs that you can attach to the refund request. It can be useful for storing
+    #   additional information in a structured format. Note: this object only allows one level of depth,
+    #   so cannot accept non-primitive data types such as objects or arrays.
+    #   [Optional]
+    #   @return [Hash{String => Object}]
+    # @!attribute previous_payment_id
+    #   The previous related payment identifier. This could be the ID of the payment that you want to refund.
+    #   [Optional]
+    #   @return [String]
+    # @!attribute segment
+    #   The dimension details about business segment for payment request. At least one dimension required.
+    #   [Optional]
+    #   @return [PaymentSegment]
+    # @!attribute processing
+    #   Returns information related to the processing of the payment.
+    #   Only processing_speed is part of this position.
+    #   [Optional]
+    #   @return [CardPayoutProcessing]
+    class UnreferencedRefundRequest
+      PAYMENT_TYPE = 'UnreferencedRefund'
+
+      attr_reader :payment_type
+      attr_accessor :source,
+                    :destination,
+                    :instruction,
+                    :amount,
+                    :currency,
+                    :processing_channel_id,
+                    :reference,
+                    :metadata,
+                    :previous_payment_id,
+                    :segment,
+                    :processing
+
+      def initialize
+        @payment_type = PAYMENT_TYPE
+      end
+    end
+  end
+end

data/lib/checkout_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CheckoutSdk
-  VERSION = '2.7.1'
+  VERSION = '2.8.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: checkout_sdk
 version: !ruby/object:Gem::Version
-  version: 2.7.1
+  version: 2.8.0
 platform: ruby
 authors:
 - Checkout
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-20 00:00:00.000000000 Z
+date: 2026-11-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -297,6 +297,7 @@ files:
 - lib/checkout_sdk/common/payment_source_type.rb
 - lib/checkout_sdk/common/phone.rb
 - lib/checkout_sdk/common/product.rb
+- lib/checkout_sdk/common/residential_status_type.rb
 - lib/checkout_sdk/common/shipping_info.rb
 - lib/checkout_sdk/common/update_customer_request.rb
 - lib/checkout_sdk/compliance_requests/compliance_request_responded_field.rb
@@ -476,6 +477,8 @@ files:
 - lib/checkout_sdk/payments/capture_request.rb
 - lib/checkout_sdk/payments/capture_type.rb
 - lib/checkout_sdk/payments/card.rb
+- lib/checkout_sdk/payments/card_payout_item.rb
+- lib/checkout_sdk/payments/card_payout_processing.rb
 - lib/checkout_sdk/payments/charge_bearer.rb
 - lib/checkout_sdk/payments/contexts/payment_contexts_client.rb
 - lib/checkout_sdk/payments/d_local_installments.rb
@@ -485,7 +488,10 @@ files:
 - lib/checkout_sdk/payments/destination/destination.rb
 - lib/checkout_sdk/payments/destination/destination_type.rb
 - lib/checkout_sdk/payments/destination/id_destination.rb
+- lib/checkout_sdk/payments/destination/network_token_destination.rb
 - lib/checkout_sdk/payments/destination/token_destination.rb
+- lib/checkout_sdk/payments/downtime_retry_request.rb
+- lib/checkout_sdk/payments/dunning_retry_request.rb
 - lib/checkout_sdk/payments/exemption.rb
 - lib/checkout_sdk/payments/flight_leg_details.rb
 - lib/checkout_sdk/payments/flow/flow_client.rb
@@ -497,6 +503,7 @@ files:
 - lib/checkout_sdk/payments/hosted/hosted_payments_client.rb
 - lib/checkout_sdk/payments/hosted/hosted_payments_session.rb
 - lib/checkout_sdk/payments/hosted/payment_purpose_type.rb
+- lib/checkout_sdk/payments/instruction_remittance.rb
 - lib/checkout_sdk/payments/instruction_scheme.rb
 - lib/checkout_sdk/payments/links/payment_link.rb
 - lib/checkout_sdk/payments/links/payments_links_client.rb
@@ -612,6 +619,7 @@ files:
 - lib/checkout_sdk/payments/setups/payment_setup_industry.rb
 - lib/checkout_sdk/payments/setups/payment_setup_payment_method_initialization.rb
 - lib/checkout_sdk/payments/setups/payment_setup_payment_method_status.rb
+- lib/checkout_sdk/payments/setups/payment_setup_payment_type.rb
 - lib/checkout_sdk/payments/setups/payment_setup_presentment_details.rb
 - lib/checkout_sdk/payments/setups/payment_setup_risk.rb
 - lib/checkout_sdk/payments/setups/payment_setup_terminal.rb
@@ -686,6 +694,7 @@ files:
 - lib/checkout_sdk/payments/three_ds_flow_type.rb
 - lib/checkout_sdk/payments/three_ds_request.rb
 - lib/checkout_sdk/payments/ticket.rb
+- lib/checkout_sdk/payments/unreferenced_refund_request.rb
 - lib/checkout_sdk/payments/user_action.rb
 - lib/checkout_sdk/payments/void_request.rb
 - lib/checkout_sdk/platform_type.rb