checkout_sdk 1.2.2 → 1.9.1

data/lib/checkout_sdk/issuing/amend_dispute_request.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Issuing
+    # Request body for POST /issuing/disputes/{disputeId}/amend.
+    # Submit an amendment to a dispute that is currently blocked from proceeding. Maps swagger
+    # `amend-dispute-request`. All fields are optional.
+    #
+    # @!attribute reason
+    #   @return [String] The updated four-digit scheme-specific reason code. If not provided, the
+    #     existing reason code is retained.
+    # @!attribute amount
+    #   @return [Numeric] The updated disputed amount, in the minor unit of the transaction currency.
+    #     If not provided, the existing amount is retained.
+    # @!attribute evidence
+    #   @return [Array<Hash>] Evidence supporting the dispute (maps `IssuingDisputeEvidence`).
+    # @!attribute fraud_details
+    #   @return [IssuingDisputeFraudDetails] Fraud-related details. Required if `reason` specifies a
+    #     fraud-related dispute.
+    # @!attribute reason_change_justification
+    #   @return [String] Justification for changing the reason at the escalation stage. Max 13000
+    #     characters.
+    # @!attribute action_response
+    #   @return [String] Free-form text explaining your choices or asking questions about the
+    #     requested changes. Max 1000 characters.
+    class AmendDisputeRequest
+      attr_accessor :reason, :amount, :evidence, :fraud_details,
+                    :reason_change_justification, :action_response
+    end
+  end
+end

data/lib/checkout_sdk/issuing/cardholder_access_token_request.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Issuing
+    # Form-encoded body for POST /issuing/access/connect/token.
+    # The api_client encodes this as application/x-www-form-urlencoded.
+    #
+    # @!attribute grant_type
+    #   @return [String] Must be "client_credentials".
+    # @!attribute client_id
+    #   @return [String] Access key ID.
+    # @!attribute client_secret
+    #   @return [String] Access key secret.
+    # @!attribute cardholder_id
+    #   @return [String] The cardholder's unique identifier (e.g. "crh_...").
+    # @!attribute single_use
+    #   @return [Boolean] Whether the request is for a single-use token.
+    class CardholderAccessTokenRequest
+      attr_accessor :grant_type, :client_id, :client_secret, :cardholder_id, :single_use
+
+      def initialize
+        @grant_type = 'client_credentials'
+      end
+    end
+  end
+end

data/lib/checkout_sdk/issuing/create_dispute_request.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Issuing
+    # Request body for POST /issuing/disputes.
+    #
+    # @!attribute transaction_id
+    #   @return [String]
+    # @!attribute reason
+    #   @return [String]
+    # @!attribute evidence
+    #   @return [Array<Hash>]
+    # @!attribute amount
+    #   @return [Numeric]
+    # @!attribute presentment_message_id
+    #   @return [String]
+    # @!attribute fraud_details
+    #   @return [IssuingDisputeFraudDetails] Fraud-related information to send with the chargeback.
+    #     Required if the dispute has a fraud-related reason code.
+    # @!attribute justification
+    #   @return [String]
+    class CreateDisputeRequest
+      attr_accessor :transaction_id, :reason, :evidence, :amount,
+                    :presentment_message_id, :fraud_details, :justification
+    end
+  end
+end

data/lib/checkout_sdk/issuing/escalate_dispute_request.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Issuing
+    # Request body for POST /issuing/disputes/{disputeId}/escalate.
+    #
+    # @!attribute additional_evidence
+    #   @return [Array<Hash>]
+    # @!attribute amount
+    #   @return [Numeric]
+    # @!attribute reason_change
+    #   @return [String]
+    # @!attribute fraud_details
+    #   @return [IssuingDisputeFraudDetails] Fraud-related details. Required if the dispute has a
+    #     fraud-related reason code at the escalation stage, or after a reason-code change to a
+    #     fraud code.
+    # @!attribute justification
+    #   @return [String] Required.
+    class EscalateDisputeRequest
+      attr_accessor :additional_evidence, :amount, :reason_change, :fraud_details, :justification
+    end
+  end
+end

data/lib/checkout_sdk/issuing/issuing.rb

@@ -1,3 +1,30 @@
 # frozen_string_literal: true
 
+# Authentication
+require 'checkout_sdk/issuing/cardholder_access_token_request'
+require 'checkout_sdk/issuing/oob_simulate_transaction_details'
+require 'checkout_sdk/issuing/oob_authentication_request'
+
+# Cardholders / Cards updates
+require 'checkout_sdk/issuing/issuing_phone_number'
+require 'checkout_sdk/issuing/issuing_address'
+require 'checkout_sdk/issuing/update_cardholder_request'
+require 'checkout_sdk/issuing/update_card_request'
+
+# Simulations
+require 'checkout_sdk/issuing/simulate_refund_request'
+
+# Controls
+require 'checkout_sdk/issuing/add_control_group_request'
+require 'checkout_sdk/issuing/add_control_profile_request'
+require 'checkout_sdk/issuing/update_control_profile_request'
+
+# Disputes
+require 'checkout_sdk/issuing/issuing_dispute_fraud_type'
+require 'checkout_sdk/issuing/issuing_dispute_fraud_details'
+require 'checkout_sdk/issuing/create_dispute_request'
+require 'checkout_sdk/issuing/escalate_dispute_request'
+require 'checkout_sdk/issuing/amend_dispute_request'
+require 'checkout_sdk/issuing/submit_dispute_request'
+
 require 'checkout_sdk/issuing/issuing_client'

data/lib/checkout_sdk/issuing/issuing_address.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Issuing
+    # Address block used in Issuing requests (billing/residency on cardholders).
+    # Matches swagger `IssuingAddress`. `address_line1`, `city`, `zip`, `country`
+    # are required per spec; other fields are optional.
+    #
+    # @!attribute address_line1
+    #   @return [String] [Required]
+    # @!attribute address_line2
+    #   @return [String]
+    # @!attribute city
+    #   @return [String] [Required]
+    # @!attribute state
+    #   @return [String]
+    # @!attribute zip
+    #   @return [String] [Required]
+    # @!attribute country
+    #   @return [String] ISO-3166 alpha-2 country code. [Required]
+    class IssuingAddress
+      attr_accessor :address_line1, :address_line2, :city, :state, :zip, :country
+    end
+  end
+end

data/lib/checkout_sdk/issuing/issuing_client.rb

@@ -12,30 +12,42 @@ module CheckoutSdk
       REVOKE = 'revoke'
       SUSPEND = 'suspend'
       CONTROLS = 'controls'
+      CONTROL_GROUPS = 'control-groups'
+      CONTROL_PROFILES = 'control-profiles'
       SIMULATE = 'simulate'
       AUTHORIZATIONS = 'authorizations'
       PRESENTMENTS = 'presentments'
       REVERSALS = 'reversals'
-      private_constant :ISSUING,
-                       :CARDHOLDERS,
-                       :CARDS,
-                       :THREE_DS,
-                       :ACTIVATE,
-                       :CREDENTIALS,
-                       :REVOKE,
-                       :SUSPEND,
-                       :CONTROLS,
-                       :SIMULATE,
-                       :AUTHORIZATIONS,
-                       :PRESENTMENTS,
-                       :REVERSALS
+      REFUNDS = 'refunds'
+      RENEW = 'renew'
+      DISPUTES = 'disputes'
+      CANCEL = 'cancel'
+      ESCALATE = 'escalate'
+      AMEND = 'amend'
+      SUBMIT = 'submit'
+      TRANSACTIONS = 'transactions'
+      DIGITAL_CARDS = 'digital-cards'
+      ADD = 'add'
+      REMOVE = 'remove'
+      ACCESS = 'access'
+      CONNECT = 'connect'
+      TOKEN = 'token'
+      OOB = 'oob'
+      AUTHENTICATION = 'authentication'
+      private_constant :ISSUING, :CARDHOLDERS, :CARDS, :THREE_DS, :ACTIVATE, :CREDENTIALS,
+                       :REVOKE, :SUSPEND, :CONTROLS, :CONTROL_GROUPS, :CONTROL_PROFILES,
+                       :SIMULATE, :AUTHORIZATIONS, :PRESENTMENTS, :REVERSALS, :REFUNDS,
+                       :RENEW, :DISPUTES, :CANCEL, :ESCALATE, :AMEND, :SUBMIT,
+                       :TRANSACTIONS, :DIGITAL_CARDS, :ADD, :REMOVE
 
       # @param [ApiClient] api_client
       # @param [CheckoutConfiguration] configuration
       def initialize(api_client, configuration)
-        super api_client, configuration, CheckoutSdk::AuthorizationType::SECRET_KEY_OR_OAUTH
+        super(api_client, configuration, CheckoutSdk::AuthorizationType::SECRET_KEY_OR_OAUTH)
       end
 
+      # ====== Cardholders ======
+
       # @param [Hash] cardholder_request
       def create_cardholder(cardholder_request)
         api_client.invoke_post(build_path(ISSUING, CARDHOLDERS), sdk_authorization, cardholder_request)
@@ -46,11 +58,23 @@ module CheckoutSdk
         api_client.invoke_get(build_path(ISSUING, CARDHOLDERS, cardholder_id), sdk_authorization)
       end
 
+      # @param [String] cardholder_id
+      # @param [Hash, UpdateCardholderRequest] update_cardholder_request
+      def update_cardholder(cardholder_id, update_cardholder_request)
+        api_client.invoke_patch(
+          build_path(ISSUING, CARDHOLDERS, cardholder_id),
+          sdk_authorization,
+          update_cardholder_request
+        )
+      end
+
       # @param [String] cardholder_id
       def get_cardholder_cards(cardholder_id)
         api_client.invoke_get(build_path(ISSUING, CARDHOLDERS, cardholder_id, CARDS), sdk_authorization)
       end
 
+      # ====== Cards ======
+
       # @param [Hash] card_request
       def create_card(card_request)
         api_client.invoke_post(build_path(ISSUING, CARDS), sdk_authorization, card_request)
@@ -61,6 +85,16 @@ module CheckoutSdk
         api_client.invoke_get(build_path(ISSUING, CARDS, card_id), sdk_authorization)
       end
 
+      # @param [String] card_id
+      # @param [Hash, UpdateCardRequest] update_card_request
+      def update_card(card_id, update_card_request)
+        api_client.invoke_patch(
+          build_path(ISSUING, CARDS, card_id),
+          sdk_authorization,
+          update_card_request
+        )
+      end
+
       # @param [String] card_id
       # @param [Hash] three_ds_request
       def enroll_three_ds(card_id, three_ds_request)
@@ -101,6 +135,19 @@ module CheckoutSdk
         api_client.invoke_post(build_path(ISSUING, CARDS, card_id, SUSPEND), sdk_authorization, suspend_request)
       end
 
+      # Renew a card. POST /issuing/cards/{cardId}/renew.
+      # @param [String] card_id
+      # @param [Hash] renew_request
+      def renew_card(card_id, renew_request = nil)
+        api_client.invoke_post(
+          build_path(ISSUING, CARDS, card_id, RENEW),
+          sdk_authorization,
+          renew_request
+        )
+      end
+
+      # ====== Controls (legacy single endpoint) ======
+
       # @param [Hash] control_request
       def create_control(control_request)
         api_client.invoke_post(build_path(ISSUING, CONTROLS), sdk_authorization, control_request)
@@ -127,6 +174,187 @@ module CheckoutSdk
         api_client.invoke_delete(build_path(ISSUING, CONTROLS, control_id), sdk_authorization)
       end
 
+      # ====== Control Groups ======
+
+      # @param [Hash, AddControlGroupRequest] control_group_request
+      def create_control_group(control_group_request)
+        api_client.invoke_post(
+          build_path(ISSUING, CONTROLS, CONTROL_GROUPS),
+          sdk_authorization,
+          control_group_request
+        )
+      end
+
+      def get_control_groups
+        api_client.invoke_get(build_path(ISSUING, CONTROLS, CONTROL_GROUPS), sdk_authorization)
+      end
+
+      # @param [String] control_group_id
+      def get_control_group(control_group_id)
+        api_client.invoke_get(
+          build_path(ISSUING, CONTROLS, CONTROL_GROUPS, control_group_id),
+          sdk_authorization
+        )
+      end
+
+      # @param [String] control_group_id
+      def delete_control_group(control_group_id)
+        api_client.invoke_delete(
+          build_path(ISSUING, CONTROLS, CONTROL_GROUPS, control_group_id),
+          sdk_authorization
+        )
+      end
+
+      # ====== Control Profiles ======
+
+      # @param [Hash, AddControlProfileRequest] control_profile_request
+      def create_control_profile(control_profile_request)
+        api_client.invoke_post(
+          build_path(ISSUING, CONTROLS, CONTROL_PROFILES),
+          sdk_authorization,
+          control_profile_request
+        )
+      end
+
+      def get_control_profiles
+        api_client.invoke_get(build_path(ISSUING, CONTROLS, CONTROL_PROFILES), sdk_authorization)
+      end
+
+      # @param [String] control_profile_id
+      def get_control_profile(control_profile_id)
+        api_client.invoke_get(
+          build_path(ISSUING, CONTROLS, CONTROL_PROFILES, control_profile_id),
+          sdk_authorization
+        )
+      end
+
+      # @param [String] control_profile_id
+      # @param [Hash, UpdateControlProfileRequest] update_control_profile_request
+      def update_control_profile(control_profile_id, update_control_profile_request)
+        api_client.invoke_patch(
+          build_path(ISSUING, CONTROLS, CONTROL_PROFILES, control_profile_id),
+          sdk_authorization,
+          update_control_profile_request
+        )
+      end
+
+      # @param [String] control_profile_id
+      def delete_control_profile(control_profile_id)
+        api_client.invoke_delete(
+          build_path(ISSUING, CONTROLS, CONTROL_PROFILES, control_profile_id),
+          sdk_authorization
+        )
+      end
+
+      # @param [String] control_profile_id
+      # @param [String] target_id
+      def add_target_to_control_profile(control_profile_id, target_id)
+        api_client.invoke_post(
+          build_path(ISSUING, CONTROLS, CONTROL_PROFILES, control_profile_id, ADD, target_id),
+          sdk_authorization
+        )
+      end
+
+      # @param [String] control_profile_id
+      # @param [String] target_id
+      def remove_target_from_control_profile(control_profile_id, target_id)
+        api_client.invoke_post(
+          build_path(ISSUING, CONTROLS, CONTROL_PROFILES, control_profile_id, REMOVE, target_id),
+          sdk_authorization
+        )
+      end
+
+      # ====== Issuing Disputes ======
+
+      # @param [Hash, CreateDisputeRequest] create_dispute_request
+      def create_issuing_dispute(create_dispute_request)
+        api_client.invoke_post(
+          build_path(ISSUING, DISPUTES),
+          sdk_authorization,
+          create_dispute_request
+        )
+      end
+
+      # @param [String] dispute_id
+      def get_issuing_dispute(dispute_id)
+        api_client.invoke_get(build_path(ISSUING, DISPUTES, dispute_id), sdk_authorization)
+      end
+
+      # @param [String] dispute_id
+      def cancel_issuing_dispute(dispute_id)
+        api_client.invoke_post(
+          build_path(ISSUING, DISPUTES, dispute_id, CANCEL),
+          sdk_authorization
+        )
+      end
+
+      # @param [String] dispute_id
+      # @param [Hash, EscalateDisputeRequest] escalate_dispute_request
+      def escalate_issuing_dispute(dispute_id, escalate_dispute_request)
+        api_client.invoke_post(
+          build_path(ISSUING, DISPUTES, dispute_id, ESCALATE),
+          sdk_authorization,
+          escalate_dispute_request
+        )
+      end
+
+      # Submit an Issuing dispute. POST /issuing/disputes/{disputeId}/submit.
+      # @param [String] dispute_id
+      # @param [Hash, SubmitDisputeRequest] submit_dispute_request
+      # @deprecated Use {#create_issuing_dispute} to create and submit a dispute in one step, or
+      #   {#amend_issuing_dispute} when the dispute status is `action_required`.
+      def submit_issuing_dispute(dispute_id, submit_dispute_request = nil)
+        api_client.invoke_post(
+          build_path(ISSUING, DISPUTES, dispute_id, SUBMIT),
+          sdk_authorization,
+          submit_dispute_request
+        )
+      end
+
+      # Amend an Issuing dispute. POST /issuing/disputes/{disputeId}/amend.
+      # Submit an amendment to a dispute that is currently blocked from proceeding. Handles both
+      # chargeback-stage and escalation-stage amendments using the same payload.
+      # @param [String] dispute_id
+      # @param [Hash, AmendDisputeRequest] amend_dispute_request
+      def amend_issuing_dispute(dispute_id, amend_dispute_request = nil)
+        api_client.invoke_post(
+          build_path(ISSUING, DISPUTES, dispute_id, AMEND),
+          sdk_authorization,
+          amend_dispute_request
+        )
+      end
+
+      # ====== Transactions ======
+
+      # @param [Hash] transactions_query
+      def get_transactions(transactions_query = nil)
+        api_client.invoke_get(
+          build_path(ISSUING, TRANSACTIONS),
+          sdk_authorization,
+          transactions_query
+        )
+      end
+
+      # @param [String] transaction_id
+      def get_transaction(transaction_id)
+        api_client.invoke_get(
+          build_path(ISSUING, TRANSACTIONS, transaction_id),
+          sdk_authorization
+        )
+      end
+
+      # ====== Digital Cards ======
+
+      # @param [String] digital_card_id
+      def get_digital_card(digital_card_id)
+        api_client.invoke_get(
+          build_path(ISSUING, DIGITAL_CARDS, digital_card_id),
+          sdk_authorization
+        )
+      end
+
+      # ====== Simulations ======
+
       # @param [Hash] authorization_request
       def simulate_authorization(authorization_request)
         api_client.invoke_post(build_path(ISSUING, SIMULATE, AUTHORIZATIONS), sdk_authorization, authorization_request)
@@ -161,6 +389,38 @@ module CheckoutSdk
           reversal_request
         )
       end
+
+      # Simulate a refund for an authorization.
+      # @param [String] transaction_id
+      # @param [Hash, SimulateRefundRequest] refund_request
+      def simulate_refund(transaction_id, refund_request)
+        api_client.invoke_post(
+          build_path(ISSUING, SIMULATE, AUTHORIZATIONS, transaction_id, REFUNDS),
+          sdk_authorization,
+          refund_request
+        )
+      end
+
+      # Request a Cardholder access token.
+      # The api_client serializes the body as application/x-www-form-urlencoded.
+      # @param [Hash, CardholderAccessTokenRequest] cardholder_token_request
+      def request_cardholder_access_token(cardholder_token_request)
+        api_client.invoke_post(
+          build_path(ISSUING, ACCESS, CONNECT, TOKEN),
+          sdk_authorization(CheckoutSdk::AuthorizationType::OAUTH),
+          cardholder_token_request
+        )
+      end
+
+      # Simulate an out-of-band (OOB) authentication request.
+      # @param [Hash, OobAuthenticationRequest] oob_authentication_request
+      def simulate_oob_authentication(oob_authentication_request)
+        api_client.invoke_post(
+          build_path(ISSUING, SIMULATE, OOB, AUTHENTICATION),
+          sdk_authorization(CheckoutSdk::AuthorizationType::OAUTH),
+          oob_authentication_request
+        )
+      end
     end
   end
 end

data/lib/checkout_sdk/issuing/issuing_dispute_fraud_details.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Issuing
+    # Fraud-related information required when the dispute reason code is fraud-related.
+    # Maps swagger `IssuingDisputeFraudDetails`. Reused by create, escalate and amend dispute
+    # requests.
+    #
+    # @!attribute fraud_type
+    #   @return [String] {IssuingDisputeFraudType} The type of fraud the cardholder is asserting.
+    #     [Required]
+    # @!attribute description
+    #   @return [String] Optional free-form description of the fraud.
+    class IssuingDisputeFraudDetails
+      attr_accessor :fraud_type, :description
+    end
+  end
+end

data/lib/checkout_sdk/issuing/issuing_dispute_fraud_type.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Issuing
+    # The type of fraud the cardholder is asserting on an Issuing dispute.
+    # Maps swagger `IssuingDisputeFraudDetails.fraud_type`.
+    module IssuingDisputeFraudType
+      CARD_LOST = 'card_lost'
+      CARD_STOLEN = 'card_stolen'
+      CARD_NEVER_RECEIVED = 'card_never_received'
+      FRAUDULENT_ACCOUNT = 'fraudulent_account'
+      COUNTERFEIT_CARD = 'counterfeit_card'
+      ACCOUNT_TAKEOVER = 'account_takeover'
+      CARD_NOT_PRESENT_FRAUD = 'card_not_present_fraud'
+      MERCHANT_MISREPRESENTATION = 'merchant_misrepresentation'
+      CARDHOLDER_MANIPULATION = 'cardholder_manipulation'
+      INCORRECT_PROCESSING = 'incorrect_processing'
+      OTHER = 'other'
+    end
+  end
+end

data/lib/checkout_sdk/issuing/issuing_phone_number.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Issuing
+    # Phone number block used in Issuing requests (e.g. cardholder updates).
+    # Matches swagger `IssuingPhoneNumber`.
+    #
+    # @!attribute country_code
+    #   @return [String] E.164 country dial code (e.g. "+1").
+    # @!attribute number
+    #   @return [String] Local subscriber number.
+    class IssuingPhoneNumber
+      attr_accessor :country_code, :number
+    end
+  end
+end

data/lib/checkout_sdk/issuing/oob_authentication_request.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Issuing
+    # Request body for POST /issuing/simulate/oob/authentication.
+    #
+    # @!attribute card_id
+    #   @return [String] The card's unique identifier (e.g. "crd_...").
+    # @!attribute transaction_details
+    #   @return [OobSimulateTransactionDetails]
+    class OobAuthenticationRequest
+      attr_accessor :card_id, :transaction_details
+    end
+  end
+end

data/lib/checkout_sdk/issuing/oob_simulate_transaction_details.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Issuing
+    # Details for a simulated OOB authentication transaction.
+    #
+    # @!attribute last_four
+    #   @return [String] The last four digits of the card.
+    # @!attribute merchant_name
+    #   @return [String]
+    # @!attribute purchase_amount
+    #   @return [Numeric]
+    # @!attribute purchase_currency
+    #   @return [String] ISO currency (e.g. "GBP").
+    class OobSimulateTransactionDetails
+      attr_accessor :last_four, :merchant_name, :purchase_amount, :purchase_currency
+    end
+  end
+end

data/lib/checkout_sdk/issuing/simulate_refund_request.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Issuing
+    # Request body for POST /issuing/simulate/authorizations/{id}/refunds.
+    #
+    # @!attribute amount
+    #   @return [Integer]
+    class SimulateRefundRequest
+      attr_accessor :amount
+    end
+  end
+end

data/lib/checkout_sdk/issuing/submit_dispute_request.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Issuing
+    # Request body for POST /issuing/disputes/{disputeId}/submit. Maps swagger
+    # `submit-dispute-request`. All fields are optional.
+    #
+    # @!attribute reason
+    #   @return [String] The updated four-digit scheme-specific reason code. If not provided, the
+    #     existing reason code is used.
+    # @!attribute evidence
+    #   @return [Array<Hash>] Evidence for the chargeback, if updated since you created the dispute
+    #     (maps `IssuingDisputeEvidence`).
+    # @!attribute amount
+    #   @return [Numeric] The updated disputed amount, in the minor unit of the transaction currency.
+    #     If not provided, the existing disputed amount is used.
+    class SubmitDisputeRequest
+      attr_accessor :reason, :evidence, :amount
+    end
+  end
+end

data/lib/checkout_sdk/issuing/update_card_request.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Issuing
+    # Request body for PATCH /issuing/cards/{cardId}.
+    #
+    # @!attribute reference
+    #   @return [String]
+    # @!attribute metadata
+    #   @return [Hash{String => String}]
+    # @!attribute expiry_month
+    #   @return [Integer]
+    # @!attribute expiry_year
+    #   @return [Integer]
+    # @!attribute activation_date
+    #   @return [String] ISO-8601 date scheduling the card's activation. Supported formats:
+    #     date only `yyyy-mm-dd` (treated as midnight UTC) or date with round hour
+    #     `yyyy-mm-ddTHH:mmZ` / `yyyy-mm-ddTHH:mm±HH:mm`. Maps swagger `IssuingActivationDate`.
+    # @!attribute revocation_date
+    #   @return [String] Date for the card to be automatically revoked, in the form `yyyy-mm-dd`.
+    #     Must be after the current date. Maps swagger `IssuingRevocationDate`.
+    class UpdateCardRequest
+      attr_accessor :reference, :metadata, :expiry_month, :expiry_year,
+                    :activation_date, :revocation_date
+    end
+  end
+end