checkout_sdk 2.0.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c470151f96c3425b61e6c49458a3612daf2174cf3b69e92861c5932dacfe5879
-  data.tar.gz: 2201bb66edace8b6b24edb4e84decf122dde349e6418c268e68dacdb1d8239b6
+  metadata.gz: 8ab7d38f61ed5faeabcf716c00ead8f3863b96ead74abd6c3e2835617d8090c5
+  data.tar.gz: 70b87b4515f6084c189956b6e7d9360a4e96686e91a1bdc293207748302b9f21
 SHA512:
-  metadata.gz: 9d28b90870372311da801cb4c93f3fd16933b8ee79f43954bb837c8d30f82fe2ddef2ed965a41a81611a32263bf11d2778c8f21f49c8031d0b977b9aad2d15ce
-  data.tar.gz: d2a7438c35e5815e9be95804597218ae62d7a967e92ef6285f749110a77d82cead49c1933d88994551822547ea59ce5ee41b3466f2b0773569ac11eada4dd663
+  metadata.gz: 15700b0fe9e01a5d21f8a4b88971c729de748f79b8d213a7e695575c492c4d1f61781e43075228695ee429b3d5172cb8475541fb41122acc17a19d82a7319422
+  data.tar.gz: 1d271293014b5535cb92b87cb7bff5b3ada0021dca9824560c432e0ece531ecdedfacff7ff8f312fe36eb9a285339d7f1bc04e8c8f51a9be998427b1f65933cb

data/lib/checkout_sdk/apm/apm.rb

@@ -9,3 +9,8 @@ require 'checkout_sdk/apm/previous/klarna/order_capture_request'
 require 'checkout_sdk/apm/previous/klarna/klarna_client'
 require 'checkout_sdk/apm/previous/sepa/sepa_client'
 require 'checkout_sdk/apm/ideal/ideal_client'
+
+# Bacs
+require 'checkout_sdk/apm/bacs/bacs_notification_type'
+require 'checkout_sdk/apm/bacs/bacs_notification_request'
+require 'checkout_sdk/apm/bacs/bacs_client'

data/lib/checkout_sdk/apm/bacs/bacs_client.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Apm
+    # Bacs Direct Debit client.
+    class BacsClient < Client
+      APMS = 'apms'
+      BACS_NOTIFICATIONS = 'bacs/notifications'
+      private_constant :APMS, :BACS_NOTIFICATIONS
+
+      # @param [ApiClient] api_client
+      # @param [CheckoutConfiguration] configuration
+      def initialize(api_client, configuration)
+        super(api_client, configuration, CheckoutSdk::AuthorizationType::SECRET_KEY)
+      end
+
+      # Sends a Bacs Direct Debit pre-notification (advance notice) to a payer ahead
+      # of collecting funds from their account.
+      #
+      # @param [Hash, BacsNotificationRequest] bacs_notification_request
+      # @return [Hash] the BacsNotificationResponse, carrying event_id.
+      def send_notification(bacs_notification_request)
+        api_client.invoke_post(build_path(APMS, BACS_NOTIFICATIONS),
+                               sdk_authorization,
+                               bacs_notification_request)
+      end
+    end
+  end
+end

data/lib/checkout_sdk/apm/bacs/bacs_notification_request.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Apm
+    # Bacs Direct Debit notification request.
+    #
+    # @!attribute source_id
+    #   @return [String] The ID of the Bacs Direct Debit instrument to notify
+    #     against. [Required] Pattern: ^(src)_(\w{26})$
+    # @!attribute notification_type
+    #   @return [String] {BacsNotificationType} The type of pre-notification being
+    #     sent to the payer. [Required]
+    # @!attribute collection_date
+    #   @return [String] The date the funds will be collected from the payer's
+    #     account, in the format yyyy-MM-dd. [Required]
+    #     Format: date - pass a yyyy-MM-dd String, not a DateTime.
+    # @!attribute amount
+    #   @return [Integer] The amount to be collected, in the currency's minor unit.
+    #     [Required] min 1
+    # @!attribute currency
+    #   @return [String] {CheckoutSdk::Common::Currency} The three-letter ISO 4217
+    #     currency code of the collection. [Required] min 3 characters,
+    #     max 3 characters.
+    # @!attribute billing_descriptor
+    #   @return [String] The billing descriptor that appears on the payer's bank
+    #     statement. [Required] max 25 characters.
+    # @!attribute customer_email
+    #   @return [String] The email address of the payer that the pre-notification is
+    #     sent to. [Required] Format: email
+    # @!attribute support_email
+    #   @return [String] The support email address included in the pre-notification.
+    #     [Required] Format: email
+    # @!attribute reference
+    #   @return [String] A reference you can use to identify the collection.
+    #     [Optional] max 50 characters.
+    # @!attribute support_phone
+    #   @return [String] The support phone number included in the pre-notification,
+    #     in E.164 format. [Optional]
+    class BacsNotificationRequest
+      attr_accessor :source_id,
+                    :notification_type,
+                    :collection_date,
+                    :amount,
+                    :currency,
+                    :billing_descriptor,
+                    :customer_email,
+                    :support_email,
+                    :reference,
+                    :support_phone
+    end
+  end
+end

data/lib/checkout_sdk/apm/bacs/bacs_notification_type.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Apm
+    # The type of pre-notification being sent to the payer.
+    module BacsNotificationType
+      ADVANCE_NOTICE = 'advance_notice'
+    end
+  end
+end

data/lib/checkout_sdk/balances/balances.rb

@@ -4,4 +4,7 @@ require 'checkout_sdk/balances/balances_query'
 require 'checkout_sdk/balances/collateral_breakdown'
 require 'checkout_sdk/balances/balance_values'
 require 'checkout_sdk/balances/currency_account_balance'
+require 'checkout_sdk/balances/top_up_funding_details'
+require 'checkout_sdk/balances/top_up_bank_details'
+require 'checkout_sdk/balances/top_up_instructions'
 require 'checkout_sdk/balances/balances_client'

data/lib/checkout_sdk/balances/balances_client.rb

@@ -4,7 +4,10 @@ module CheckoutSdk
   module Balances
     class BalancesClient < Client
       BALANCES = 'balances'
-      private_constant :BALANCES
+      ENTITIES = 'entities'
+      CURRENCY_ACCOUNTS = 'currency-accounts'
+      TOP_UP_INSTRUCTIONS = 'top-up-instructions'
+      private_constant :BALANCES, :ENTITIES, :CURRENCY_ACCOUNTS, :TOP_UP_INSTRUCTIONS
 
       # @param [ApiClient] api_client
       # @param [CheckoutConfiguration] configuration
@@ -12,11 +15,42 @@ module CheckoutSdk
         super(api_client, configuration, CheckoutSdk::AuthorizationType::SECRET_KEY_OR_OAUTH)
       end
 
-      # @param [String] entity_id
-      # @param [String] balances_query
+      # Retrieves the balances for each sub-account belonging to an entity.
+      #
+      # @param [String] entity_id the ID of the entity
+      # @param [String, BalancesQuery] balances_query a raw query string
+      #   (e.g. "currency:GBP") or a {BalancesQuery}
+      # @return [Hash] the balances response
       def retrieve_entity_balances(entity_id, balances_query)
         api_client.invoke_get(build_path(BALANCES, entity_id), sdk_authorization, balances_query)
       end
+
+      # Retrieves the bank details required to top up a sub-account, along with the payment
+      # reference that attributes an incoming payment to that sub-account.
+      #
+      # Note: The sub-account is referred to as currency account in the API.
+      #
+      # The response maps to {TopUpInstructions}, whose `bank_details` is a {TopUpBankDetails}
+      # holding up to two {TopUpFundingDetails} rails. Neither rail is guaranteed.
+      #
+      # @param [String] entity_id the ID of the entity that owns the sub-account, or of an entity
+      #   above it in your hierarchy; a platform can use its own entity ID to reach the
+      #   sub-accounts of any entity beneath it
+      # @param [String] currency_account_id the ID of the sub-account to retrieve top-up
+      #   instructions for
+      # @return [Hash] the top-up instructions response
+      # @raise [CheckoutArgumentException] if either path parameter is nil, empty or blank. Both
+      #   segments are interpolated straight into the request path, so a blank value would build a
+      #   malformed URL and be rejected by the API rather than by the SDK.
+      def retrieve_top_up_instructions(entity_id, currency_account_id)
+        raise CheckoutArgumentException, 'entity_id cannot be blank' if entity_id.to_s.strip.empty?
+        raise CheckoutArgumentException, 'currency_account_id cannot be blank' if currency_account_id.to_s.strip.empty?
+
+        api_client.invoke_get(
+          build_path(ENTITIES, entity_id, CURRENCY_ACCOUNTS, currency_account_id, TOP_UP_INSTRUCTIONS),
+          sdk_authorization
+        )
+      end
     end
   end
 end

data/lib/checkout_sdk/balances/top_up_bank_details.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Balances
+    # The bank details for each available funding rail (swagger schema: TopUpBankDetails).
+    #
+    # Both `domestic` and `international` are optional, and their availability depends on the
+    # sub-account's holding currency, jurisdiction, and banking partner. Do not assume that both
+    # rails are always available; neither may be present.
+    #
+    # @!attribute domestic
+    #   [Optional]
+    #   @return [TopUpFundingDetails] The bank details for the domestic funding rail.
+    # @!attribute international
+    #   [Optional]
+    #   @return [TopUpFundingDetails] The bank details for the international funding rail.
+    class TopUpBankDetails
+      attr_accessor :domestic,
+                    :international
+    end
+  end
+end

data/lib/checkout_sdk/balances/top_up_funding_details.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Balances
+    # The bank details for a single funding rail (swagger schema: TopUpFundingDetails).
+    #
+    # `beneficiary_account_name` and `bank_name` are the only fields always returned. The
+    # remaining fields vary by rail and the receiving bank's jurisdiction, and are omitted when
+    # they do not apply.
+    #
+    # @!attribute beneficiary_account_name
+    #   [Required]
+    #   @return [String] The name of the account that receives the funds.
+    # @!attribute beneficiary_address
+    #   [Optional]
+    #   @return [String] The address of the beneficiary, if the rail requires it.
+    # @!attribute bank_name
+    #   [Required]
+    #   @return [String] The name of the bank that receives the funds.
+    # @!attribute bank_address
+    #   [Optional]
+    #   @return [String] The address of the receiving bank, if the rail requires it.
+    # @!attribute account_number
+    #   [Optional]
+    #   @return [String] The account number of the receiving account.
+    # @!attribute sort_code
+    #   [Optional]
+    #   @return [String] The sort code of the receiving bank. Returned for United Kingdom
+    #     domestic transfers.
+    # @!attribute routing_number
+    #   [Optional]
+    #   @return [String] The routing number of the receiving bank. Returned for United States
+    #     domestic transfers.
+    # @!attribute iban
+    #   [Optional]
+    #   @return [String] The International Bank Account Number of the receiving account.
+    # @!attribute swift_code
+    #   [Optional]
+    #   @return [String] The SWIFT or BIC code of the receiving bank. Returned for
+    #     international transfers.
+    class TopUpFundingDetails
+      attr_accessor :beneficiary_account_name,
+                    :beneficiary_address,
+                    :bank_name,
+                    :bank_address,
+                    :account_number,
+                    :sort_code,
+                    :routing_number,
+                    :iban,
+                    :swift_code
+    end
+  end
+end

data/lib/checkout_sdk/balances/top_up_instructions.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Balances
+    # The bank details and payment reference used to top up a sub-account
+    # (swagger schema: TopUpInstructionsResponse).
+    #
+    # Returned by
+    # GET /entities/{entityId}/currency-accounts/{currencyAccountId}/top-up-instructions.
+    #
+    # @!attribute currency_account_id
+    #   [Required]
+    #   @return [String] The unique identifier of the sub-account that the instructions apply to.
+    # @!attribute currency
+    #   [Required]
+    #   @return [String] {CheckoutSdk::Common::Currency} The currency that funds must be sent in,
+    #     as a three-letter ISO 4217 currency code. This is the sub-account's holding currency,
+    #     returned as `holding_currency` by the Retrieve entity balances endpoint.
+    # @!attribute payment_reference
+    #   [Required]
+    #   @return [String] The reference that must be quoted on the payment. It is how an incoming
+    #     payment is attributed to the sub-account. A payment sent without this reference may not
+    #     be credited.
+    # @!attribute bank_details
+    #   [Required]
+    #   @return [TopUpBankDetails] The bank details for each available funding rail.
+    class TopUpInstructions
+      attr_accessor :currency_account_id,
+                    :currency,
+                    :payment_reference,
+                    :bank_details
+    end
+  end
+end

data/lib/checkout_sdk/checkout_api.rb

@@ -73,6 +73,8 @@ module CheckoutSdk
   #   @return [CheckoutSdk::Identities::IdentityVerification::IdentityVerificationClient]
   # @!attribute face_authentication
   #   @return [CheckoutSdk::Identities::FaceAuthentication::FaceAuthenticationClient]
+  # @!attribute bacs
+  #   @return [CheckoutSdk::Apm::BacsClient]
   # @!attribute apple_pay
   #   @return [CheckoutSdk::Payments::ApplePayClient]
   # @!attribute google_pay
@@ -91,6 +93,7 @@ module CheckoutSdk
                 :sessions,
                 :tokens,
                 :ideal,
+                :bacs,
                 :accounts,
                 :workflows,
                 :risk,
@@ -131,6 +134,7 @@ module CheckoutSdk
       @sessions = CheckoutSdk::Sessions::SessionsClient.new api_client, configuration
       @tokens = CheckoutSdk::Tokens::TokensClient.new api_client, configuration
       @ideal = CheckoutSdk::Apm::IdealClient.new api_client, configuration
+      @bacs = CheckoutSdk::Apm::BacsClient.new api_client, configuration
       @workflows = CheckoutSdk::Workflows::WorkflowsClient.new api_client, configuration
       @accounts = CheckoutSdk::Accounts::AccountsClient.new(api_client, files_client(configuration), configuration)
       @risk = CheckoutSdk::Risk::RiskClient.new api_client, configuration

data/lib/checkout_sdk/common/account_holder_type.rb

@@ -2,9 +2,25 @@
 
 module CheckoutSdk
   module Common
+    # The type of account holder.
+    #
+    # For stored instruments use {CheckoutSdk::Instruments::InstrumentAccountHolderType},
+    # whose schemas declare individual and corporate only.
     module AccountHolderType
       INDIVIDUAL = 'individual'
       CORPORATE = 'corporate'
+
+      # Declared by the account-holder positions (AccountHolder, AccountHolderAch,
+      # PaymentSetupAccountHolder, RefundDestinationAccountHolder and the card-payout
+      # destination and sender) but **not** by any sender schema -
+      # PaymentRequestSender, PayoutSender, PaymentDetailsResponseSender and
+      # PaymentInterfacesSender all omit it. Do not send it as a sender type.
+      GOVERNMENT = 'government'
+
+      # Declared only by the payment and payout *sender* schemas
+      # (PaymentRequestSender, PayoutSender, PaymentDetailsResponseSender), never by
+      # an account-holder position. Retained rather than removed because removal is
+      # breaking; prefer the sender-specific type where one exists.
       INSTRUMENT = 'instrument'
     end
   end

data/lib/checkout_sdk/common/customer_request.rb

@@ -2,18 +2,30 @@
 
 module CheckoutSdk
   module Common
+    # The customer's details.
+    #
+    # This type serves two positions with different property sets. The payments
+    # position (swagger `CustomerRequest`) declares all six properties below. The
+    # instrument position (swagger `StoreCustomerInstrumentRequest`, used by
+    # {CheckoutSdk::Instruments::InstrumentBacs}, {CheckoutSdk::Instruments::InstrumentSepa}
+    # and {CheckoutSdk::Instruments::InstrumentAch}) declares every property except
+    # tax_number - do not send tax_number when storing an instrument.
+    #
     # @!attribute id
     #   @return [String]
     # @!attribute email
     #   @return [String]
     # @!attribute name
-    #   @return [String]
+    #   @return [String] Only sets the name for *new* customers.
     # @!attribute tax_number
-    #   @return [String]
+    #   @return [String] Payments position only. Not declared by
+    #     StoreCustomerInstrumentRequest.
     # @!attribute phone
     #   @return [Phone]
     # @!attribute default
-    #   @return [TrueClass, FalseClass]
+    #   @return [TrueClass, FalseClass] If true, this instrument becomes the default
+    #     for the customer. An instrument is automatically the default when the
+    #     request creates a new customer.
     class CustomerRequest
       attr_accessor :id,
                     :email,

data/lib/checkout_sdk/common/instrument_type.rb

@@ -2,11 +2,19 @@
 
 module CheckoutSdk
   module Common
+    # The type of a payment instrument.
     module InstrumentType
       BANK_ACCOUNT = 'bank_account'
       TOKEN = 'token'
       CARD = 'card'
       SEPA = 'sepa'
+
+      # Current API (NAS) only. The previous API (ABC) instrument schemas declare
+      # neither of these, so do not use them with a previous-platform client.
+      ACH = 'ach'
+      BACS = 'bacs'
+
+      # Previous API (ABC) only. Not declared by any current-API instrument schema.
       CARD_TOKEN = 'card_token'
     end
   end

data/lib/checkout_sdk/common/payment_source_type.rb

@@ -2,6 +2,19 @@
 
 module CheckoutSdk
   module Common
+    # The type of a payment source or destination.
+    #
+    # This module is shared by the current API (NAS) and the previous API (ABC),
+    # which is still actively maintained. These 22 values are declared by neither
+    # `PaymentRequestSourceType` nor `PaymentDetailsResponseSourceType` in the
+    # current specification and are **previous API (ABC) only**:
+    #
+    #   afterpay, alipay, applepay, baloto, bank_account, benefit, benefitpay,
+    #   boleto, cvconnect, dlocal, giropay, googlepay, illicado, oxxo, pagofacil,
+    #   poli, postfinance, provider_token, rapipago, sofort, tabby, trustly
+    #
+    # Use them only with a previous-platform client. Every other value below is
+    # current-API.
     module PaymentSourceType
       CARD = 'card'
       ID = 'id'
@@ -54,10 +67,16 @@ module CheckoutSdk
       ILLICADO = 'illicado'
       SEPA = 'sepa'
       ACH = 'ach'
+      BACS = 'bacs'
       BIZUM = 'bizum'
       OCTOPUS = 'octopus'
       PLAID = 'plaid'
       SEQURA = 'sequra'
+      MOBILEPAY = 'mobilepay'
+      PAYNOW = 'paynow'
+      SWISH = 'swish'
+      TWINT = 'twint'
+      VIPPS = 'vipps'
       TABBY = 'tabby'
       APPLEPAY = 'applepay'
       GOOGLEPAY = 'googlepay'

data/lib/checkout_sdk/instruments/ach_account_type.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Instruments
+    # The type of Direct Debit account on an ACH instrument.
+    #
+    # The ACH instrument schemas declare savings and checking only. The ACH payment
+    # source additionally declares cash - see {CheckoutSdk::Common::AccountType}.
+    module AchAccountType
+      SAVINGS = 'savings'
+      CHECKING = 'checking'
+    end
+  end
+end

data/lib/checkout_sdk/instruments/bacs_payment_type.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Instruments
+    # The type of payment on a Bacs Direct Debit instrument.
+    #
+    # Declared capitalized by the Bacs instrument schemas, unlike {SepaPaymentType}
+    # which declares the same two concepts lowercase. The casing is not
+    # interchangeable and must not be unified.
+    module BacsPaymentType
+      RECURRING = 'Recurring'
+      REGULAR = 'Regular'
+    end
+  end
+end

data/lib/checkout_sdk/instruments/create/create_ach_account_holder.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Instruments
+    # The account holder details of an ACH instrument being stored.
+    #
+    # The specification lists all four properties in the schema's required array,
+    # while the individual field descriptions make them conditional on type
+    # ("Required for individual account holder type" / "Required for corporate
+    # account holder type"). The two readings contradict each other; send the pair
+    # that matches your type value.
+    #
+    # @!attribute first_name
+    #   @return [String] First name. Required for individual account holder type.
+    # @!attribute last_name
+    #   @return [String] Last name. Required for individual account holder type.
+    # @!attribute company_name
+    #   @return [String] Company name. Required for corporate account holder type.
+    # @!attribute type
+    #   @return [String] {InstrumentAccountHolderType} Account holder type.
+    #     [Required]
+    class CreateAchAccountHolder
+      attr_accessor :first_name,
+                    :last_name,
+                    :company_name,
+                    :type
+    end
+  end
+end

data/lib/checkout_sdk/instruments/create/create_ach_instrument_data.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Instruments
+    # The details of the bank account of an ACH instrument being stored.
+    #
+    # @!attribute account_type
+    #   @return [String] {AchAccountType} The type of Direct Debit account,
+    #     savings or checking. [Required]
+    # @!attribute account_number
+    #   @return [String] The account number of the Direct Debit account.
+    #     [Required] min 4 characters, max 17 characters.
+    # @!attribute bank_code
+    #   @return [String] The bank code of the Direct Debit account.
+    #     [Required] min 8 characters, max 9 characters.
+    # @!attribute currency
+    #   @return [String] {CheckoutSdk::Common::Currency} The currency of the account.
+    #     [Required] min 3 characters, max 3 characters.
+    # @!attribute country
+    #   @return [String] {CheckoutSdk::Common::Country} The country of the account.
+    #     [Required] min 2 characters, max 2 characters.
+    class CreateAchInstrumentData
+      attr_accessor :account_type,
+                    :account_number,
+                    :bank_code,
+                    :currency,
+                    :country
+    end
+  end
+end

data/lib/checkout_sdk/instruments/create/create_bacs_account_holder.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Instruments
+    # The account holder details of a Bacs Direct Debit instrument being stored.
+    #
+    # The store shape declares three properties only. The update and retrieve shapes
+    # additionally declare company_name and type - see
+    # {UpdateBacsAccountHolder}.
+    #
+    # @!attribute first_name
+    #   @return [String] The first name of the account holder. [Required]
+    # @!attribute last_name
+    #   @return [String] The last name of the account holder. [Required]
+    # @!attribute billing_address
+    #   @return [CreateBacsBillingAddress] The billing address of the account
+    #     holder. [Required]
+    class CreateBacsAccountHolder
+      attr_accessor :first_name,
+                    :last_name,
+                    :billing_address
+    end
+  end
+end

data/lib/checkout_sdk/instruments/create/create_bacs_billing_address.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Instruments
+    # The billing address of the account holder of a Bacs Direct Debit instrument
+    # being stored.
+    #
+    # @!attribute address_line1
+    #   @return [String] The first line of the address. [Optional] max 200 characters.
+    # @!attribute address_line2
+    #   @return [String] The street number. If no number, pass "w/n".
+    #     [Optional] max 10 characters.
+    # @!attribute city
+    #   @return [String] The address city. [Optional] max 35 characters.
+    #     Note the update variant allows max 50.
+    # @!attribute zip
+    #   @return [String] The address zip/postal code. [Optional] max 16 characters.
+    #     Note the update variant allows max 50.
+    # @!attribute country
+    #   @return [String] {CheckoutSdk::Common::Country} The two-letter ISO country
+    #     code of the address. [Required] min 2 characters, max 2 characters.
+    class CreateBacsBillingAddress
+      attr_accessor :address_line1,
+                    :address_line2,
+                    :city,
+                    :zip,
+                    :country
+    end
+  end
+end

data/lib/checkout_sdk/instruments/create/create_bacs_instrument_account.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Instruments
+    # The account configuration of a Bacs Direct Debit instrument being stored.
+    #
+    # @!attribute processing_channel_id
+    #   @return [String] The ID of the processing channel to associate with the
+    #     instrument. [Required] Pattern: ^(pc)_(\w{26})$
+    class CreateBacsInstrumentAccount
+      attr_accessor :processing_channel_id
+    end
+  end
+end

data/lib/checkout_sdk/instruments/create/create_bacs_instrument_data.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module CheckoutSdk
+  module Instruments
+    # The details of a Bacs Direct Debit account being stored.
+    #
+    # @!attribute account_number
+    #   @return [String] The account number of the Bacs Direct Debit account.
+    #     [Required] min 8 characters, max 8 characters.
+    # @!attribute bank_code
+    #   @return [String] The sort code of the Bacs Direct Debit account.
+    #     [Required] min 6 characters, max 6 characters.
+    # @!attribute country
+    #   @return [String] {CheckoutSdk::Common::Country} The country of the account,
+    #     as an ISO 3166-1 alpha-2 code. [Required] min 2 characters, max 2 characters.
+    # @!attribute currency
+    #   @return [String] {CheckoutSdk::Common::Currency} The currency of the account.
+    #     [Required] min 3 characters, max 3 characters.
+    # @!attribute payment_type
+    #   @return [String] {BacsPaymentType} The type of payment, Recurring or
+    #     Regular. [Required] Capitalized, unlike the SEPA equivalent.
+    # @!attribute allow_partial_match
+    #   @return [TrueClass, FalseClass] Indicates whether the Bacs instrument is
+    #     created when account validation returns a partial match. When true the
+    #     instrument is created on a partial match; when false instrument creation
+    #     fails on a partial match. [Optional] Default: false
+    class CreateBacsInstrumentData
+      attr_accessor :account_number,
+                    :bank_code,
+                    :country,
+                    :currency,
+                    :payment_type,
+                    :allow_partial_match
+    end
+  end
+end