checkout_sdk 1.6.0 → 1.7.0

data/lib/checkout_sdk/payments/setups/account_funding_transaction_identification_type.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Payments
+    # Identification document type used by the sender of an Account Funding Transaction
+    # on a Payment Setup.
+    module AccountFundingTransactionIdentificationType
+      DRIVING_LICENSE = 'driving_license'
+      PASSPORT = 'passport'
+      NATIONAL_ID = 'national_id'
+      TAX_ID = 'tax_id'
+      OTHER = 'other'
+    end
+  end
+end

data/lib/checkout_sdk/payments/setups/account_funding_transaction_purpose.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Payments
+    # Enum of allowed `purpose` values on a PaymentSetup AccountFundingTransaction.
+    # See https://api-reference.checkout.com (PaymentSetupAccountFundingTransaction.purpose).
+    module AccountFundingTransactionPurpose
+      DONATIONS = 'donations'
+      EDUCATION = 'education'
+      EMERGENCY_NEED = 'emergency_need'
+      EXPATRIATION = 'expatriation'
+      FAMILY_SUPPORT = 'family_support'
+      FINANCIAL_SERVICES = 'financial_services'
+      GIFTS = 'gifts'
+      INCOME = 'income'
+      INSURANCE = 'insurance'
+      INVESTMENT = 'investment'
+      IT_SERVICES = 'it_services'
+      LEISURE = 'leisure'
+      LOAN_PAYMENT = 'loan_payment'
+      MEDICAL_TREATMENT = 'medical_treatment'
+      OTHER = 'other'
+      PENSION = 'pension'
+      ROYALTIES = 'royalties'
+      SAVINGS = 'savings'
+      TRAVEL_AND_TOURISM = 'travel_and_tourism'
+    end
+  end
+end

data/lib/checkout_sdk/payments/setups/account_funding_transaction_recipient.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Payments
+    # @!attribute first_name
+    #   @return [String]
+    # @!attribute last_name
+    #   @return [String]
+    # @!attribute account_number
+    #   @return [String]
+    # @!attribute account_type
+    #   @return [String]
+    # @!attribute date_of_birth
+    #   @return [String] Format: YYYY-MM-DD
+    # @!attribute address
+    #   @return [CheckoutSdk::Common::Address]
+    class AccountFundingTransactionRecipient
+      attr_accessor :first_name,
+                    :last_name,
+                    :account_number,
+                    :account_type,
+                    :date_of_birth,
+                    :address
+    end
+  end
+end

data/lib/checkout_sdk/payments/setups/account_funding_transaction_sender.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Payments
+    # @!attribute first_name
+    #   @return [String]
+    # @!attribute last_name
+    #   @return [String]
+    # @!attribute date_of_birth
+    #   @return [String] Format: YYYY-MM-DD
+    # @!attribute country_of_birth
+    #   @return [String] {CheckoutSdk::Common::Country}
+    # @!attribute nationality
+    #   @return [String] {CheckoutSdk::Common::Country}
+    # @!attribute address
+    #   @return [CheckoutSdk::Common::Address]
+    # @!attribute identification
+    #   @return [AccountFundingTransactionIdentification]
+    class AccountFundingTransactionSender
+      attr_accessor :first_name,
+                    :last_name,
+                    :date_of_birth,
+                    :country_of_birth,
+                    :nationality,
+                    :address,
+                    :identification
+    end
+  end
+end

data/lib/checkout_sdk/payments/setups/blik_payment_method.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Payments
+    # Blik payment method configuration on a Payment Setup.
+    #
+    # @!attribute status
+    #   @return [String] (response-only) Payment method status (e.g. "available").
+    # @!attribute flags
+    #   @return [Array(String)] (response-only) Diagnostic flags returned by the API.
+    # @!attribute partner_code
+    #   @return [String] The 6-digit Blik code generated by the customer's banking app.
+    #     Pattern: ^[0-9]{6}$
+    class BlikPaymentMethod
+      attr_accessor :status,
+                    :flags,
+                    :partner_code
+    end
+  end
+end

data/lib/checkout_sdk/payments/setups/payment_setup_account_funding_transaction.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Payments
+    # @!attribute enabled
+    #   @return [TrueClass, FalseClass]
+    # @!attribute purpose
+    #   @return [String] {AccountFundingTransactionPurpose}
+    # @!attribute sender
+    #   @return [AccountFundingTransactionSender]
+    # @!attribute recipient
+    #   @return [AccountFundingTransactionRecipient]
+    class PaymentSetupAccountFundingTransaction
+      attr_accessor :enabled,
+                    :purpose,
+                    :sender,
+                    :recipient
+    end
+  end
+end

data/lib/checkout_sdk/payments/source/apm/blik_source.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Payments
+    # Blik payment source for the /payments endpoint.
+    #
+    # When source.type is "blik":
+    #   - currency must be PLN
+    #   - amount must not exceed 5,000,000 (minor unit)
+    #   - reference is limited to 35 characters
+    # For customer-initiated payments, provide the 6-digit BLIK code in
+    # `processing.partner_code`. For merchant-initiated recurring payments,
+    # use either source.type: "id" with a previous source.id, or
+    # source.type: "blik" with `partner_agreement_id`.
+    #
+    # @!attribute id
+    #   @return [String] (response-only) The Checkout.com source identifier
+    #     for a partner agreement created during a Blik recurring payment.
+    # @!attribute partner_agreement_id
+    #   @return [String] The Blik PAYID identifying an external partner
+    #     agreement created with another PSP.
+    class BlikSource < PaymentSource
+      attr_accessor :id,
+                    :partner_agreement_id
+
+      def initialize
+        super(CheckoutSdk::Common::PaymentSourceType::BLIK)
+      end
+    end
+  end
+end

data/lib/checkout_sdk/sessions/device_information.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Sessions
+    # Details of the device from which the authentication originated.
+    #
+    # @!attribute device_id
+    #   @return [String] The unique identifier for the device.
+    # @!attribute device_session_id
+    #   @return [String] Device session ID collected from the standalone Risk.js package.
+    #     Pattern: ^(dsid)_(\w{26})$
+    class DeviceInformation
+      attr_accessor :device_id,
+                    :device_session_id
+    end
+  end
+end

data/lib/checkout_sdk/sessions/session_request.rb

@@ -73,7 +73,8 @@ module CheckoutSdk
                     :recurring,
                     :installment,
                     :optimization,
-                    :initial_transaction
+                    :initial_transaction,
+                    :device_information
 
       def initialize(source: CardSource.new,
                      authentication_type: CheckoutSdk::Sessions::AuthenticationType::REGULAR,

data/lib/checkout_sdk/sessions/sessions.rb

@@ -5,6 +5,7 @@ require 'checkout_sdk/sessions/authentication_type'
 require 'checkout_sdk/sessions/card_holder_account_info'
 require 'checkout_sdk/sessions/category'
 require 'checkout_sdk/sessions/delivery_timeframe'
+require 'checkout_sdk/sessions/device_information'
 require 'checkout_sdk/sessions/installment'
 require 'checkout_sdk/sessions/merchant_risk_info'
 require 'checkout_sdk/sessions/recurring'

data/lib/checkout_sdk/standalone_account_updater/account_updater_card.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module StandaloneAccountUpdater
+    # Card details for the standalone Account Updater request.
+    #
+    # @!attribute number
+    #   @return [String] The card number.
+    # @!attribute expiry_month
+    #   @return [Integer]
+    # @!attribute expiry_year
+    #   @return [Integer] Four-digit expiry year.
+    class AccountUpdaterCard
+      attr_accessor :number, :expiry_month, :expiry_year
+    end
+  end
+end

data/lib/checkout_sdk/standalone_account_updater/account_updater_instrument.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module StandaloneAccountUpdater
+    # Instrument reference for the standalone Account Updater request.
+    #
+    # @!attribute id
+    #   @return [String] Unique instrument identifier (e.g. "src_...").
+    class AccountUpdaterInstrument
+      attr_accessor :id
+    end
+  end
+end

data/lib/checkout_sdk/standalone_account_updater/account_updater_request.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module StandaloneAccountUpdater
+    # Request body for POST /account-updater/cards.
+    #
+    # @!attribute source_options
+    #   @return [AccountUpdaterSourceOptions]
+    class AccountUpdaterRequest
+      attr_accessor :source_options
+    end
+  end
+end

data/lib/checkout_sdk/standalone_account_updater/account_updater_source_options.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module StandaloneAccountUpdater
+    # The source to update. Provide either `card` or `instrument`, but not both.
+    #
+    # @!attribute card
+    #   @return [AccountUpdaterCard]
+    # @!attribute instrument
+    #   @return [AccountUpdaterInstrument]
+    class AccountUpdaterSourceOptions
+      attr_accessor :card, :instrument
+    end
+  end
+end

data/lib/checkout_sdk/standalone_account_updater/standalone_account_updater.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require 'checkout_sdk/standalone_account_updater/account_updater_card'
+require 'checkout_sdk/standalone_account_updater/account_updater_instrument'
+require 'checkout_sdk/standalone_account_updater/account_updater_source_options'
+require 'checkout_sdk/standalone_account_updater/account_updater_request'
+require 'checkout_sdk/standalone_account_updater/standalone_account_updater_client'

data/lib/checkout_sdk/standalone_account_updater/standalone_account_updater_client.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module StandaloneAccountUpdater
+    # Client for the Standalone Account Updater API.
+    # Uses OAuth with the `vault:real-time-account-updater` scope.
+    class StandaloneAccountUpdaterClient < Client
+      ACCOUNT_UPDATER = 'account-updater'
+      CARDS = 'cards'
+      private_constant :ACCOUNT_UPDATER, :CARDS
+
+      # @param [ApiClient] api_client
+      # @param [CheckoutConfiguration] configuration
+      def initialize(api_client, configuration)
+        super(api_client, configuration, CheckoutSdk::AuthorizationType::OAUTH)
+      end
+
+      # Get updated card credentials.
+      # @param [Hash, AccountUpdaterRequest] account_updater_request
+      def update_card(account_updater_request)
+        api_client.invoke_post(
+          build_path(ACCOUNT_UPDATER, CARDS),
+          sdk_authorization,
+          account_updater_request
+        )
+      end
+    end
+  end
+end

data/lib/checkout_sdk/tokens/token_metadata_billing_address.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Tokens
+    # Partial billing address (city + country) returned by GET /tokens/{tokenId}/metadata.
+    #
+    # @!attribute city
+    #   @return [String]
+    # @!attribute country
+    #   @return [String] {CheckoutSdk::Common::Country}
+    class TokenMetadataBillingAddress
+      attr_accessor :city,
+                    :country
+    end
+  end
+end

data/lib/checkout_sdk/tokens/token_metadata_response.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Tokens
+    # Response from GET /tokens/{tokenId}/metadata.
+    #
+    # @!attribute token
+    #   @return [String]
+    # @!attribute type
+    #   @return [String]
+    # @!attribute expires_on
+    #   @return [String] RFC 3339 timestamp.
+    # @!attribute expiry_month
+    #   @return [Integer]
+    # @!attribute expiry_year
+    #   @return [Integer]
+    # @!attribute scheme
+    #   @return [String]
+    # @!attribute last4
+    #   @return [String]
+    # @!attribute bin
+    #   @return [String]
+    # @!attribute card_type
+    #   @return [String] One of CREDIT/DEBIT/PREPAID/CHARGE/"DEFERRED DEBIT".
+    # @!attribute card_category
+    #   @return [String] One of CONSUMER/COMMERCIAL.
+    # @!attribute issuer
+    #   @return [String]
+    # @!attribute issuer_country
+    #   @return [String] ISO 3166-1 alpha-2.
+    # @!attribute product_id
+    #   @return [String]
+    # @!attribute product_type
+    #   @return [String]
+    # @!attribute billing_address
+    #   @return [TokenMetadataBillingAddress]
+    class TokenMetadataResponse
+      attr_accessor :token,
+                    :type,
+                    :expires_on,
+                    :expiry_month,
+                    :expiry_year,
+                    :scheme,
+                    :last4,
+                    :bin,
+                    :card_type,
+                    :card_category,
+                    :issuer,
+                    :issuer_country,
+                    :product_id,
+                    :product_type,
+                    :billing_address
+    end
+  end
+end

data/lib/checkout_sdk/tokens/tokens.rb

@@ -8,3 +8,5 @@ require 'checkout_sdk/tokens/apple_pay_token_request'
 require 'checkout_sdk/tokens/google_pay_token_request'
 require 'checkout_sdk/tokens/apple_pay_token_data'
 require 'checkout_sdk/tokens/card_token_request'
+require 'checkout_sdk/tokens/token_metadata_billing_address'
+require 'checkout_sdk/tokens/token_metadata_response'

data/lib/checkout_sdk/tokens/tokens_client.rb

@@ -16,6 +16,17 @@ module CheckoutSdk
       def request_token(token_request)
         api_client.invoke_post(TOKENS, sdk_authorization, token_request)
       end
+
+      # Returns the details for an active token without consuming it.
+      # The token remains usable after this call.
+      # Requires SecretKey or OAuth (not PublicKey).
+      # @param [String] token_id Pattern: ^(tok)_(\w{26})$
+      def get_token_metadata(token_id)
+        api_client.invoke_get(
+          build_path(TOKENS, token_id, 'metadata'),
+          sdk_authorization(CheckoutSdk::AuthorizationType::SECRET_KEY_OR_OAUTH)
+        )
+      end
     end
   end
 end

data/lib/checkout_sdk/version.rb

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

data/lib/checkout_sdk/workflows/workflows_client.rb

@@ -120,7 +120,7 @@ module CheckoutSdk
                                sdk_authorization)
       end
 
-      # @param [Reflow] reflow
+      # @param [Hash, Reflow] reflow
       def reflow(reflow)
         api_client.invoke_post(build_path(WORKFLOWS, EVENTS, REFLOW), sdk_authorization, reflow)
       end

data/lib/checkout_sdk.rb

@@ -68,6 +68,13 @@ require 'checkout_sdk/metadata/metadata'
 require 'checkout_sdk/financial/financial'
 require 'checkout_sdk/issuing/issuing'
 require 'checkout_sdk/forward/forward'
+require 'checkout_sdk/onboarding_simulator/onboarding_simulator'
+require 'checkout_sdk/agentic_commerce/agentic_commerce'
+require 'checkout_sdk/compliance_requests/compliance_requests'
+require 'checkout_sdk/standalone_account_updater/standalone_account_updater'
+require 'checkout_sdk/network_tokens/network_tokens'
+require 'checkout_sdk/payment_methods/payment_methods'
+require 'checkout_sdk/identities/identities'
 
 # Checkout modules (previous)
 require 'checkout_sdk/sources/sources'