checkout_sdk 2.7.0 → 2.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5cd5982ca215c9826f2e674ae220b9e8e543df849aa3a53f52bb6776d10640d7
-  data.tar.gz: db69647504e345b28e6b59984c7003f5af518857e5c1d5e272f286ef412f9640
+  metadata.gz: 0ffa084c12fc5f4e0c765b41a3e4dd3e970ca006584c25623106e93dae1c6001
+  data.tar.gz: 8b69b0fff53b0eb662383c47f36af073aad85adca12d6d7edb46db9323859eb9
 SHA512:
-  metadata.gz: 37f9058e2c2201e2718792e701c23cc691f41219fbbd3b483475399d2de69c0ab26ba3c07f218ba5ea656da4ef37976f962c77e4d60d142c8c9c98c55b51da44
-  data.tar.gz: 4449ec19ac66472ce3a4f1d01eae9deb4f4535b2ed7c9c8060c26219245183d8beb8361ab8b7316f7d21041ac7d7af885581daf520b1dabd8aeab743c150c750
+  metadata.gz: c4d4935f79a0e91ce703cae0dbdf02e6445065525e501cba3401adf956de27d7ea399e75d52b230e7c3de5279e5e2d5936fff9fcc77f556b19aae6b80c7de801
+  data.tar.gz: a209f2204ed7275f7e9b880dc4fe0c55758eefbd3687d8c83eed8596c3c69f701f4aadd0193c5d79e4da241756eeb19eaf21f88feefc1f49de076df41d8c3b2d

data/lib/checkout_sdk/payments/flow/flow_client.rb

@@ -3,7 +3,6 @@
 module CheckoutSdk
   module Payments
     # Client for Payment Flow API operations
-    # [Beta]
     class FlowClient < Client
       PAYMENT_SESSIONS_PATH = 'payment-sessions'
       SUBMIT_PATH = 'submit'
@@ -17,7 +16,6 @@ module CheckoutSdk
 
       # Creates a Payment Session.
       # Use this endpoint to set up a payment session before collecting payment details from your customer.
-      # [Beta]
       #
       # @param [Hash] request_payment_session_request
       def request_payment_session(request_payment_session_request)
@@ -30,7 +28,6 @@ module CheckoutSdk
 
       # Submits a Payment Session.
       # Use this endpoint to submit payment details and process the payment for an existing session.
-      # [Beta]
       #
       # The request accepts `amount_allocations`: the sub-entities the payment is being
       # processed on behalf of, min 1 max 50 items. Each entry maps to
@@ -50,7 +47,6 @@ module CheckoutSdk
 
       # Creates and submits a Payment Session in a single request.
       # Use this endpoint to create a payment session and immediately process the payment.
-      # [Beta]
       #
       # @param [Hash] request_payment_session_with_payment_request
       def request_payment_session_with_payment(request_payment_session_with_payment_request)

data/lib/checkout_sdk/payments/payments.rb

@@ -219,6 +219,7 @@ require 'checkout_sdk/payments/setups/payment_setup_account_funding_transaction'
 require 'checkout_sdk/payments/setups/payment_setup_billing_descriptor'
 require 'checkout_sdk/payments/setups/payment_setup_presentment_details'
 require 'checkout_sdk/payments/setups/payment_setup_terminal'
+require 'checkout_sdk/payments/setups/payment_setup_risk'
 require 'checkout_sdk/payments/setups/payment_setup_accommodation_address'
 require 'checkout_sdk/payments/setups/payment_setup_accommodation_guest'
 require 'checkout_sdk/payments/setups/payment_setup_accommodation_room'

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

@@ -5,7 +5,8 @@ module CheckoutSdk
     # Bacs payment method configuration on a Payment Setup. Maps swagger `Bacs`.
     #
     # @!attribute status
-    #   @return [String] (response-only) Payment method status.
+    #   @return [String] (response-only) Payment method status, one of
+    #     {PaymentSetupPaymentMethodStatus} (e.g. "ready").
     # @!attribute flags
     #   @return [Array(String)] (response-only) Diagnostic flags returned by the API.
     # @!attribute initialization

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

@@ -2,10 +2,11 @@
 
 module CheckoutSdk
   module Payments
-    # Blik payment method configuration on a Payment Setup.
+    # Blik payment method configuration on a Payment Setup. Maps swagger `Blik`.
     #
     # @!attribute status
-    #   @return [String] (response-only) Payment method status (e.g. "available").
+    #   @return [String] (response-only) Payment method status, one of
+    #     {PaymentSetupPaymentMethodStatus} (e.g. "ready").
     # @!attribute flags
     #   @return [Array(String)] (response-only) Diagnostic flags returned by the API.
     # @!attribute partner_code

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

@@ -5,7 +5,8 @@ module CheckoutSdk
     # Card Present payment method configuration on a Payment Setup. Maps swagger `CardPresent`.
     #
     # @!attribute status
-    #   @return [String] (response-only) Payment method status.
+    #   @return [String] (response-only) Payment method status, one of
+    #     {PaymentSetupPaymentMethodStatus} (e.g. "ready").
     # @!attribute flags
     #   @return [Array(String)] (response-only) Diagnostic flags returned by the API.
     # @!attribute track2

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

@@ -2,23 +2,47 @@
 
 module CheckoutSdk
   module Payments
-    # Pay by Bank (Open Banking) payment method configuration on a Payment Setup.
-    # Maps swagger `PayByBank`.
+    # The Pay by Bank (Open Banking) payment method's details and configuration on a Payment Setup.
+    # Maps swagger `PayByBank`. Sent under the `payment_methods.paybybank` key (one lowercase word,
+    # not `pay_by_bank`; the API ignores `pay_by_bank` without an error).
     #
-    # @!attribute status
-    #   @return [String] (response-only) Payment method status.
-    # @!attribute flags
-    #   @return [Array(String)] (response-only) Diagnostic flags returned by the API.
-    # @!attribute bank_id
-    #   @return [String] The identifier of the bank the customer has selected for the payment.
-    # @!attribute action
-    #   @return [Hash] (response-only) The next available action for the payment method
-    #     (`type`, `banks`).
+    # The Payment Setup request is a Hash, and a Hash request is sent as is, so do not nest an
+    # instance of this class in it directly: it would not be serialized. Pass a Hash with these keys,
+    # or convert an instance first:
+    #   pay_by_bank = CheckoutSdk::Payments::PayByBankPaymentMethod.new
+    #   pay_by_bank.bank_id = 'ob-natwest'
+    #   request[:payment_methods] = { paybybank: CheckoutSdk::JsonSerializer.to_custom_hash(pay_by_bank) }
+    # Responses are read with dot access, for example response.payment_methods.paybybank.action.banks.
     class PayByBankPaymentMethod
-      attr_accessor :status,
-                    :flags,
-                    :bank_id,
-                    :action
+      # The payment method status.
+      # [Optional]
+      # Read only.
+      # Enum: "unavailable" "action_required" "ready" "initialization_required" "invalid"
+      # @return [String] One of {PaymentSetupPaymentMethodStatus}.
+      attr_accessor :status
+
+      # The list of error codes or indicators that highlight missing or invalid information.
+      # [Optional]
+      # Read only.
+      # @return [Array(String)]
+      attr_accessor :flags
+
+      # The identifier of the bank the customer has selected for the payment.
+      # [Optional]
+      # @return [String]
+      attr_accessor :bank_id
+
+      # The next available action for the payment method.
+      # [Optional]
+      # Read only.
+      # Keys:
+      # - `type` (String): The type of action. Enum: "select_bank".
+      # - `banks` (Array(Hash)): The list of banks available for the customer to select. Each item has
+      #   `bank_id` (String, the unique identifier of the bank), `display_name` (String, the display
+      #   name of the bank), `logo_url` (String, the URL of the bank's logo) and `available`
+      #   (Boolean, whether the bank is currently available for selection).
+      # @return [Hash]
+      attr_accessor :action
     end
   end
 end

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

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Payments
+    # Risk assessment settings for the Payment Setup.
+    # Maps the swagger `PaymentSetup.risk` object. Sent under the `risk` key.
+    #
+    # The Payment Setup request is a Hash, so pass { enabled: false } directly, or convert an
+    # instance first with CheckoutSdk::JsonSerializer.to_custom_hash(risk).
+    class PaymentSetupRisk
+      # Indicates whether a risk assessment should be performed.
+      # [Optional]
+      # Default: true
+      # @return [TrueClass, FalseClass]
+      attr_accessor :enabled
+    end
+  end
+end

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

@@ -28,12 +28,51 @@ module CheckoutSdk
       #   :industry {PaymentSetupIndustry} (containing :accommodation
       #   {Array(PaymentSetupAccommodation)} and :airline {Array(PaymentSetupAirline)}).
       #   A Hash request is sent as is, so every nested value must be a Hash too. To use one of the
-      #   typed classes above (or {CashAppPaymentMethod}), convert it first with
+      #   typed classes above (or {CashAppPaymentMethod}, {PayByBankPaymentMethod} or
+      #   {PaymentSetupRisk}), convert it first with
       #   CheckoutSdk::JsonSerializer.to_custom_hash(object); a typed object nested directly in the
       #   Hash is not serialized and is sent as "#<CheckoutSdk::...>".
       #   :payment_methods may include :cashapp (the key is the single lowercase word `cashapp`), a Hash
       #   with the keys documented on {CashAppPaymentMethod}; you send :initialization ("disabled" or
       #   "enabled") and :customer_profile_sharing (Boolean).
+      #   :payment_methods may also include :paybybank (the key is the single lowercase word
+      #   `paybybank`; the API ignores `pay_by_bank` without an error), a Hash with the keys documented
+      #   on {PayByBankPaymentMethod}; you send :bank_id (the identifier of the bank the customer has
+      #   selected for the payment).
+      #   :payment_methods may also include (every key is optional unless marked required):
+      #   - :card - :token (a Hash with :id, String, the Checkout.com card token), :details (the card
+      #     data: :number (String, write-only), :expiry_month (Integer), :expiry_year (Integer), :name
+      #     (String, write-only), :cvv (String, write-only), :stored (Boolean, write-only) and
+      #     :allow_update (Boolean)), :store_for_future_use (Boolean, write-only), :phone
+      #     (:country_code, String, min 1 character, max 7 characters, and :number, String, min 6
+      #     characters, max 25 characters), :account_holder (:type, one of "individual", "government"
+      #     or "corporate", :first_name, :last_name, :middle_name, :company_name (Strings) and
+      #     :account_name_inquiry (Boolean)) and :preferred_scheme ("visa", "mastercard" or
+      #     "cartes_bancaires"). The card data goes under :details; the API ignores it at the top level
+      #     of :card.
+      #   - :applepay - :token_data (write-only: :version, :data and :signature (Strings) and :header,
+      #     a Hash with :ephemeral_public_key, :public_key_hash and :transaction_id (Strings)), :token (a
+      #     Hash with :id, String, required, pattern ^(tok)_(\w{26})$, and :expires_on, date-time,
+      #     ISO 8601; a String token is not accepted), :store_for_future_use (Boolean, write-only),
+      #     :phone and :account_holder as on :card, and :preferred_scheme ("visa", "mastercard" or
+      #     "cartes_bancaires"). Apple Pay has no :details.
+      #   - :googlepay - :token_data (write-only: :protocol_version, :signature, :signed_message and
+      #     :tokenization_key (Strings)), :token, :store_for_future_use, :phone and :account_holder as
+      #     on :applepay, and :preferred_scheme ("visa" or "mastercard" only). Google Pay has no
+      #     :details.
+      #   - :instrument - :id (String, the unique identifier of the instrument to use).
+      #   - :auto_confirm - String, the payment method that automatically confirms the payment when it
+      #     is ready, for example "card".
+      #   :settings may include :success_url and :failure_url (String, format uri, max 255
+      #   characters), :capture (Boolean, whether to capture the payment immediately, default true) and
+      #   :excluded_payment_methods (Array of Strings, payment method names, for example ["klarna"]).
+      #   :order may include :sub_merchants, an Array of Hashes with :id (String), :product_category
+      #   (String), :number_of_sales (Integer; the API does not define number_of_trades) and
+      #   :registration_date (String, format date, yyyy-MM-dd).
+      #   :metadata - A Hash of key/value pairs to attach to the payment (max 20 keys); each value is a
+      #   String (max 255 characters), a Number or a Boolean.
+      #   :risk {PaymentSetupRisk} - Risk assessment settings for the Payment Setup: :enabled
+      #   (Boolean, whether a risk assessment should be performed, default true).
       #   :customer may include:
       #   - :id - The unique identifier of the customer.
       #   - :country - The two-letter ISO country code of the customer for this payment
@@ -58,7 +97,11 @@ module CheckoutSdk
       #     customer's device, one of {PaymentSetupDeviceOs}).
       # @return [Hash] The Payment Setup (swagger `PaymentSetup`, 200). For Cash App Pay, read
       #   payment_methods.cashapp.action.redirect_url, payment_methods.cashapp.reference and, once only,
-      #   payment_methods.cashapp.customer_profile.
+      #   payment_methods.cashapp.customer_profile. For Pay by Bank, read
+      #   payment_methods.paybybank.action.banks. Card, Apple Pay and Google Pay return the read-only
+      #   :schemes (supported card scheme names; Google Pay never lists cartes_bancaires) and card
+      #   details :last4, :bin, :scheme (Strings) and :expires_on (date-time); instrument returns the
+      #   read-only :type (String) and :action (:type, "set_instrument").
       def create_payment_setup(payment_setups_request)
         api_client.invoke_post(
           build_path(PAYMENTS_PATH, SETUPS_PATH),
@@ -81,12 +124,51 @@ module CheckoutSdk
       #   :industry {PaymentSetupIndustry} (containing :accommodation
       #   {Array(PaymentSetupAccommodation)} and :airline {Array(PaymentSetupAirline)}).
       #   A Hash request is sent as is, so every nested value must be a Hash too. To use one of the
-      #   typed classes above (or {CashAppPaymentMethod}), convert it first with
+      #   typed classes above (or {CashAppPaymentMethod}, {PayByBankPaymentMethod} or
+      #   {PaymentSetupRisk}), convert it first with
       #   CheckoutSdk::JsonSerializer.to_custom_hash(object); a typed object nested directly in the
       #   Hash is not serialized and is sent as "#<CheckoutSdk::...>".
       #   :payment_methods may include :cashapp (the key is the single lowercase word `cashapp`), a Hash
       #   with the keys documented on {CashAppPaymentMethod}; you send :initialization ("disabled" or
       #   "enabled") and :customer_profile_sharing (Boolean).
+      #   :payment_methods may also include :paybybank (the key is the single lowercase word
+      #   `paybybank`; the API ignores `pay_by_bank` without an error), a Hash with the keys documented
+      #   on {PayByBankPaymentMethod}; you send :bank_id (the identifier of the bank the customer has
+      #   selected for the payment).
+      #   :payment_methods may also include (every key is optional unless marked required):
+      #   - :card - :token (a Hash with :id, String, the Checkout.com card token), :details (the card
+      #     data: :number (String, write-only), :expiry_month (Integer), :expiry_year (Integer), :name
+      #     (String, write-only), :cvv (String, write-only), :stored (Boolean, write-only) and
+      #     :allow_update (Boolean)), :store_for_future_use (Boolean, write-only), :phone
+      #     (:country_code, String, min 1 character, max 7 characters, and :number, String, min 6
+      #     characters, max 25 characters), :account_holder (:type, one of "individual", "government"
+      #     or "corporate", :first_name, :last_name, :middle_name, :company_name (Strings) and
+      #     :account_name_inquiry (Boolean)) and :preferred_scheme ("visa", "mastercard" or
+      #     "cartes_bancaires"). The card data goes under :details; the API ignores it at the top level
+      #     of :card.
+      #   - :applepay - :token_data (write-only: :version, :data and :signature (Strings) and :header,
+      #     a Hash with :ephemeral_public_key, :public_key_hash and :transaction_id (Strings)), :token (a
+      #     Hash with :id, String, required, pattern ^(tok)_(\w{26})$, and :expires_on, date-time,
+      #     ISO 8601; a String token is not accepted), :store_for_future_use (Boolean, write-only),
+      #     :phone and :account_holder as on :card, and :preferred_scheme ("visa", "mastercard" or
+      #     "cartes_bancaires"). Apple Pay has no :details.
+      #   - :googlepay - :token_data (write-only: :protocol_version, :signature, :signed_message and
+      #     :tokenization_key (Strings)), :token, :store_for_future_use, :phone and :account_holder as
+      #     on :applepay, and :preferred_scheme ("visa" or "mastercard" only). Google Pay has no
+      #     :details.
+      #   - :instrument - :id (String, the unique identifier of the instrument to use).
+      #   - :auto_confirm - String, the payment method that automatically confirms the payment when it
+      #     is ready, for example "card".
+      #   :settings may include :success_url and :failure_url (String, format uri, max 255
+      #   characters), :capture (Boolean, whether to capture the payment immediately, default true) and
+      #   :excluded_payment_methods (Array of Strings, payment method names, for example ["klarna"]).
+      #   :order may include :sub_merchants, an Array of Hashes with :id (String), :product_category
+      #   (String), :number_of_sales (Integer; the API does not define number_of_trades) and
+      #   :registration_date (String, format date, yyyy-MM-dd).
+      #   :metadata - A Hash of key/value pairs to attach to the payment (max 20 keys); each value is a
+      #   String (max 255 characters), a Number or a Boolean.
+      #   :risk {PaymentSetupRisk} - Risk assessment settings for the Payment Setup: :enabled
+      #   (Boolean, whether a risk assessment should be performed, default true).
       #   :customer may include:
       #   - :id - The unique identifier of the customer.
       #   - :country - The two-letter ISO country code of the customer for this payment
@@ -111,7 +193,11 @@ module CheckoutSdk
       #     customer's device, one of {PaymentSetupDeviceOs}).
       # @return [Hash] The Payment Setup (swagger `PaymentSetup`, 200). For Cash App Pay, read
       #   payment_methods.cashapp.action.redirect_url, payment_methods.cashapp.reference and, once only,
-      #   payment_methods.cashapp.customer_profile.
+      #   payment_methods.cashapp.customer_profile. For Pay by Bank, read
+      #   payment_methods.paybybank.action.banks. Card, Apple Pay and Google Pay return the read-only
+      #   :schemes (supported card scheme names; Google Pay never lists cartes_bancaires) and card
+      #   details :last4, :bin, :scheme (Strings) and :expires_on (date-time); instrument returns the
+      #   read-only :type (String) and :action (:type, "set_instrument").
       def update_payment_setup(id, payment_setups_request)
         api_client.invoke_put(
           build_path(PAYMENTS_PATH, SETUPS_PATH, id),
@@ -126,7 +212,11 @@ module CheckoutSdk
       # @param [String] id - The unique identifier of the Payment Setup to retrieve
       # @return [Hash] The Payment Setup (swagger `PaymentSetup`, 200). For Cash App Pay, read
       #   payment_methods.cashapp.action.redirect_url, payment_methods.cashapp.reference and, once only,
-      #   payment_methods.cashapp.customer_profile.
+      #   payment_methods.cashapp.customer_profile. For Pay by Bank, read
+      #   payment_methods.paybybank.action.banks. Card, Apple Pay and Google Pay return the read-only
+      #   :schemes (supported card scheme names; Google Pay never lists cartes_bancaires) and card
+      #   details :last4, :bin, :scheme (Strings) and :expires_on (date-time); instrument returns the
+      #   read-only :type (String) and :action (:type, "set_instrument").
       def get_payment_setup(id)
         api_client.invoke_get(
           build_path(PAYMENTS_PATH, SETUPS_PATH, id),
@@ -143,7 +233,11 @@ module CheckoutSdk
       #   payment with (for example, "tabby", "klarna", "card" or "cashapp")
       # @return [Hash] The Payment Setup (swagger `PaymentSetup`, 200). For Cash App Pay, read
       #   payment_methods.cashapp.action.redirect_url, payment_methods.cashapp.reference and, once only,
-      #   payment_methods.cashapp.customer_profile.
+      #   payment_methods.cashapp.customer_profile. For Pay by Bank, read
+      #   payment_methods.paybybank.action.banks. Card, Apple Pay and Google Pay return the read-only
+      #   :schemes (supported card scheme names; Google Pay never lists cartes_bancaires) and card
+      #   details :last4, :bin, :scheme (Strings) and :expires_on (date-time); instrument returns the
+      #   read-only :type (String) and :action (:type, "set_instrument").
       def confirm_payment_setup(id, payment_method_name)
         api_client.invoke_post(
           build_path(PAYMENTS_PATH, SETUPS_PATH, id, CONFIRM_PATH, payment_method_name),

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

@@ -5,7 +5,8 @@ module CheckoutSdk
     # Stablecoin payment method configuration on a Payment Setup. Maps swagger `Stablecoin`.
     #
     # @!attribute status
-    #   @return [String] (response-only) Payment method status.
+    #   @return [String] (response-only) Payment method status, one of
+    #     {PaymentSetupPaymentMethodStatus} (e.g. "ready").
     # @!attribute flags
     #   @return [Array(String)] (response-only) Diagnostic flags returned by the API.
     class StablecoinPaymentMethod

data/lib/checkout_sdk/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: checkout_sdk
 version: !ruby/object:Gem::Version
-  version: 2.7.0
+  version: 2.7.1
 platform: ruby
 authors:
 - Checkout
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-08 00:00:00.000000000 Z
+date: 2026-10-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -613,6 +613,7 @@ files:
 - 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_presentment_details.rb
+- lib/checkout_sdk/payments/setups/payment_setup_risk.rb
 - lib/checkout_sdk/payments/setups/payment_setup_terminal.rb
 - lib/checkout_sdk/payments/setups/payment_setups_client.rb
 - lib/checkout_sdk/payments/setups/stablecoin_payment_method.rb