checkout_sdk 2.6.0 → 2.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 643ab11801801b6384afcf53088f20e10fd700aea656dd166f1355fd1f5d445e
-  data.tar.gz: ebf1ad17a6f86067c740e66896ea79b49ff2a4433e690e4134f39b89d475bc5a
+  metadata.gz: 0ffa084c12fc5f4e0c765b41a3e4dd3e970ca006584c25623106e93dae1c6001
+  data.tar.gz: 8b69b0fff53b0eb662383c47f36af073aad85adca12d6d7edb46db9323859eb9
 SHA512:
-  metadata.gz: a2aec6348780a7fe62a67ff99cfe125a60b17285b4f4704ecdb32f950a218e7b2464124a54e1a485dcd4271ed3f253f7721ba663d638c8c6eb4eec2232201e48
-  data.tar.gz: 6107aa6f953cfad64ad7a4c99a05530ee989b27843ebfcf27c4c0c5ce108b96aad2c4b105251a3d74ca68871c87655f373912be6a173da4199c1c03f0ddf9de5
+  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'
@@ -233,6 +234,12 @@ require 'checkout_sdk/payments/setups/blik_payment_method'
 require 'checkout_sdk/payments/setups/bacs_payment_method'
 require 'checkout_sdk/payments/setups/card_present_payment_method'
 require 'checkout_sdk/payments/setups/pay_by_bank_payment_method'
+require 'checkout_sdk/payments/setups/cash_app_action_type'
+require 'checkout_sdk/payments/setups/cash_app_payment_method'
+require 'checkout_sdk/payments/setups/payment_setup_device_client'
+require 'checkout_sdk/payments/setups/payment_setup_device_os'
+require 'checkout_sdk/payments/setups/payment_setup_payment_method_initialization'
+require 'checkout_sdk/payments/setups/payment_setup_payment_method_status'
 require 'checkout_sdk/payments/setups/stablecoin_payment_method'
 require 'checkout_sdk/payments/setups/payment_setups_client'
 

data/lib/checkout_sdk/payments/sessions/payment_methods_type.rb

@@ -2,19 +2,55 @@
 
 module CheckoutSdk
   module Payments
+    # The type of payment method that can be enabled or disabled for a payment session.
+    #
+    # This is a consolidated list covering every payment method the Flow API accepts for
+    # enabled_payment_methods / disabled_payment_methods. Constants marked deprecated are no
+    # longer part of the specification but are kept for backward compatibility.
     module PaymentMethodsType
+      ALIPAY_CN = 'alipay_cn'
+      ALIPAY_HK = 'alipay_hk'
+      ALMA = 'alma'
       APPLEPAY = 'applepay'
       BANCONTACT = 'bancontact'
+      BENEFIT = 'benefit'
+      BIZUM = 'bizum'
       CARD = 'card'
+      DANA = 'dana'
       EPS = 'eps'
+      # @deprecated No longer part of the specification.
       GIROPAY = 'giropay'
+      GCASH = 'gcash'
       GOOGLEPAY = 'googlepay'
       IDEAL = 'ideal'
+      KAKAOPAY = 'kakaopay'
+      KLARNA = 'klarna'
       KNET = 'knet'
+      MBWAY = 'mbway'
+      MOBILEPAY = 'mobilepay'
       MULTIBANCO = 'multibanco'
+      OCTOPUS = 'octopus'
       PRZELEWY24 = 'p24'
+      PAYNOW = 'paynow'
       PAYPAL = 'paypal'
+      PLAID = 'plaid'
+      QPAY = 'qpay'
+      # Fully supported by the API but deliberately unlisted in the public specification, so
+      # that merchants do not disable Remember Me en masse. Do not remove it as an unspecified
+      # value.
+      REMEMBER_ME = 'remember_me'
+      SEPA = 'sepa'
+      # @deprecated No longer part of the specification.
       SOFORT = 'sofort'
+      STCPAY = 'stcpay'
+      STORED_CARD = 'stored_card'
+      TABBY = 'tabby'
+      TAMARA = 'tamara'
+      TNG = 'tng'
+      TRUEMONEY = 'truemoney'
+      TWINT = 'twint'
+      VIPPS = 'vipps'
+      WECHATPAY = 'wechatpay'
     end
   end
 end

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/cash_app_action_type.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Payments
+    # The type of the next available action for the Cash App Pay payment method on a
+    # Payment Setup. Maps swagger `CashApp.action.type`.
+    module CashAppActionType
+      REDIRECT = 'redirect'
+    end
+  end
+end

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

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Payments
+    # The Cash App payment method's details and configuration on a Payment Setup.
+    # Maps swagger `CashApp`. Sent under the `payment_methods.cashapp` key (one lowercase word,
+    # not `cash_app`).
+    #
+    # 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:
+    #   cash_app = CheckoutSdk::Payments::CashAppPaymentMethod.new
+    #   cash_app.initialization = 'enabled'
+    #   cash_app.customer_profile_sharing = true
+    #   request[:payment_methods] = { cashapp: CheckoutSdk::JsonSerializer.to_custom_hash(cash_app) }
+    # Responses are read with dot access, for example response.payment_methods.cashapp.action.redirect_url.
+    class CashAppPaymentMethod
+      # 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 initialization state of the payment method.
+      # When you create a Payment Setup, this defaults to `disabled`.
+      # [Optional]
+      # Default: "disabled"
+      # Enum: "disabled" "enabled"
+      # @return [String] One of {PaymentSetupPaymentMethodInitialization}.
+      attr_accessor :initialization
+
+      # Indicates whether the customer consents to share their Cash App customer profile with Checkout.com.
+      # [Optional]
+      # @return [TrueClass, FalseClass]
+      attr_accessor :customer_profile_sharing
+
+      # The customer's Cash App profile that they consented to share. Included in the response when
+      # `customer_profile_sharing` is enabled.
+      # Cash App releases this profile only once. It's present in the first successful response when you
+      # get the Payment Setup after the customer authorizes the payment. Every subsequent response omits it.
+      # [Optional]
+      # Read only.
+      # Keys (all strings, all optional):
+      # - `customer_id`: Cash App's identifier for the customer. This is not a Checkout.com customer identifier.
+      # - `cashtag`: The customer's $Cashtag.
+      # - `reference_id`: Cash App's reference for the customer profile.
+      # - `full_name`: The customer's full name.
+      # - `given_name`: The customer's given name.
+      # - `middle_name`: The customer's middle name.
+      # - `family_name`: The customer's family name.
+      # - `suffix`: The suffix of the customer's name.
+      # - `birth_date`: The customer's date of birth. Format: date (the API example carries a time part,
+      #   so the value is kept as a string).
+      # - `address` (Hash): The customer's address, with Cash App's own key names (not the Checkout.com
+      #   common address): `address_line_1` (the first line of the address), `address_line_2` (the second
+      #   line of the address), `address_line_3` (the third line of the address), `locality` (the address
+      #   locality, such as the city or town), `sublocality` (the address sublocality, such as the district
+      #   or neighborhood), `administrative_district_level_1` (the address's top-level administrative
+      #   district, such as the state or province), `postal_code` (the postal or zip code) and `country`
+      #   (the address country, in ISO 3166-1 alpha-2 format, max 2 characters).
+      # - `phone_number`: The customer's phone number.
+      # - `email_address`: The customer's email address.
+      # - `customer_since`: The date and time the customer's Cash App account was created.
+      #   Format: date-time (kept as a string).
+      # @return [Hash]
+      attr_accessor :customer_profile
+
+      # A reference for the Cash App Pay transaction, returned by the provider.
+      # [Optional]
+      # Read only.
+      # max 80 characters
+      # @return [String]
+      attr_accessor :reference
+
+      # The next available action for the payment method.
+      # [Optional]
+      # Read only.
+      # Keys:
+      # - `type` (String): The type of action. One of {CashAppActionType}.
+      # - `redirect_url` (String): The URL to redirect the customer to so they can authorize the payment
+      #   with Cash App. Format: uri
+      # @return [Hash]
+      attr_accessor :action
+    end
+  end
+end

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_device_client.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Payments
+    # The type of client the customer uses to initiate the payment.
+    # Maps swagger `PaymentSetup.customer.device.client`.
+    module PaymentSetupDeviceClient
+      WEB = 'web'
+      MOBILE_WEB = 'mobile_web'
+      APP = 'app'
+    end
+  end
+end

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

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Payments
+    # The operating system of the customer's device.
+    # Maps swagger `PaymentSetup.customer.device.os`.
+    module PaymentSetupDeviceOs
+      ANDROID = 'android'
+      IOS = 'ios'
+    end
+  end
+end

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

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Payments
+    # The initialization state of a payment method on a Payment Setup.
+    # Maps swagger `PaymentMethodInitialization.initialization`.
+    module PaymentSetupPaymentMethodInitialization
+      DISABLED = 'disabled'
+      ENABLED = 'enabled'
+    end
+  end
+end

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

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Payments
+    # The payment method status on a Payment Setup.
+    # Maps swagger `PaymentMethodStatus`.
+    module PaymentSetupPaymentMethodStatus
+      UNAVAILABLE = 'unavailable'
+      ACTION_REQUIRED = 'action_required'
+      READY = 'ready'
+      INITIALIZATION_REQUIRED = 'initialization_required'
+      INVALID = 'invalid'
+    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

@@ -16,9 +16,9 @@ module CheckoutSdk
       end
 
       # Creates a Payment Setup.
-      # To maximize the amount of information the payment setup can use, we recommend that you create
-      # a payment setup as early as possible in the customer's journey. For example, the first time
-      # they land on the basket page.
+      # To maximize the information available to the payment setup, create a Payment Setup as early as
+      # possible in the customer's journey. For example, create it the first time they land on the
+      # basket page.
       # [Beta]
       #
       # @param [Hash] payment_setups_request
@@ -27,6 +27,81 @@ module CheckoutSdk
       #   :terminal {PaymentSetupTerminal} and
       #   :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}, {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
+      #     (min 2 characters, max 2 characters).
+      #   - :email - Details of the customer's email: :address (the customer's email address) and
+      #     :verified (Boolean, whether the customer's email address is verified).
+      #   - :name - The customer's full name (max 100 characters).
+      #   - :tax_number - The customer's tax identification number.
+      #   - :phone - The customer's phone number: :country_code (the international country calling
+      #     code, min 1 character, max 7 characters) and :number (the phone number, min 6 characters,
+      #     max 25 characters).
+      #   - :merchant_account - Details of the account the customer holds with the merchant: :id,
+      #     :registration_date, :last_modified, :first_transaction_date and :last_transaction_date
+      #     (dates, yyyy-MM-dd), :returning_customer (Boolean), :total_order_count (Integer) and
+      #     :last_payment_amount (Number).
+      #   - :device - Details of the customer's device: :locale (the locale of the device),
+      #     :fingerprint (a unique identifier for the customer's device), :ipv4 and :ipv6 (the
+      #     customer's device IPv4 or IPv6 address, used by some payment methods for risk and
+      #     eligibility checks), :client (the type of client the customer uses to initiate the
+      #     payment, one of {PaymentSetupDeviceClient}; Cash App Pay requires it, although the API
+      #     reference does not mark it as required) and :os (the operating system of the
+      #     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. 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),
@@ -36,9 +111,9 @@ module CheckoutSdk
       end
 
       # Updates a Payment Setup.
-      # You should update the payment setup whenever there are significant changes in the data relevant
-      # to the customer's transaction. For example, when the customer makes a change that impacts the
-      # total payment amount.
+      # Update the Payment Setup whenever there are significant changes in the data relevant to the
+      # customer's transaction. For example, when the customer makes a change that impacts the total
+      # payment amount.
       # [Beta]
       #
       # @param [String] id - The unique identifier of the Payment Setup to update
@@ -48,6 +123,81 @@ module CheckoutSdk
       #   :terminal {PaymentSetupTerminal} and
       #   :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}, {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
+      #     (min 2 characters, max 2 characters).
+      #   - :email - Details of the customer's email: :address (the customer's email address) and
+      #     :verified (Boolean, whether the customer's email address is verified).
+      #   - :name - The customer's full name (max 100 characters).
+      #   - :tax_number - The customer's tax identification number.
+      #   - :phone - The customer's phone number: :country_code (the international country calling
+      #     code, min 1 character, max 7 characters) and :number (the phone number, min 6 characters,
+      #     max 25 characters).
+      #   - :merchant_account - Details of the account the customer holds with the merchant: :id,
+      #     :registration_date, :last_modified, :first_transaction_date and :last_transaction_date
+      #     (dates, yyyy-MM-dd), :returning_customer (Boolean), :total_order_count (Integer) and
+      #     :last_payment_amount (Number).
+      #   - :device - Details of the customer's device: :locale (the locale of the device),
+      #     :fingerprint (a unique identifier for the customer's device), :ipv4 and :ipv6 (the
+      #     customer's device IPv4 or IPv6 address, used by some payment methods for risk and
+      #     eligibility checks), :client (the type of client the customer uses to initiate the
+      #     payment, one of {PaymentSetupDeviceClient}; Cash App Pay requires it, although the API
+      #     reference does not mark it as required) and :os (the operating system of the
+      #     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. 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),
@@ -56,10 +206,17 @@ module CheckoutSdk
         )
       end
 
-      # Retrieves a Payment Setup.
+      # Retrieves a Payment Setup by its unique identifier.
       # [Beta]
       #
       # @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. 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),
@@ -73,7 +230,14 @@ module CheckoutSdk
       #
       # @param [String] id - The unique identifier of the Payment Setup
       # @param [String] payment_method_name - The name of the payment method to process the
-      # payment with (for example, "tabby", "klarna", "card")
+      #   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. 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.6.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.6.0
+  version: 2.7.1
 platform: ruby
 authors:
 - Checkout
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-06 00:00:00.000000000 Z
+date: 2026-10-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -593,6 +593,8 @@ files:
 - lib/checkout_sdk/payments/setups/bacs_payment_method.rb
 - lib/checkout_sdk/payments/setups/blik_payment_method.rb
 - lib/checkout_sdk/payments/setups/card_present_payment_method.rb
+- lib/checkout_sdk/payments/setups/cash_app_action_type.rb
+- lib/checkout_sdk/payments/setups/cash_app_payment_method.rb
 - lib/checkout_sdk/payments/setups/pay_by_bank_payment_method.rb
 - lib/checkout_sdk/payments/setups/payment_setup_accommodation.rb
 - lib/checkout_sdk/payments/setups/payment_setup_accommodation_address.rb
@@ -605,8 +607,13 @@ files:
 - lib/checkout_sdk/payments/setups/payment_setup_airline_passenger.rb
 - lib/checkout_sdk/payments/setups/payment_setup_airline_ticket.rb
 - lib/checkout_sdk/payments/setups/payment_setup_billing_descriptor.rb
+- lib/checkout_sdk/payments/setups/payment_setup_device_client.rb
+- lib/checkout_sdk/payments/setups/payment_setup_device_os.rb
 - 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_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