ibancom 0.0.8 → 0.0.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 25b94a77a717ff4aa52de122a08578c9912180d10dfe76baa301d48bf7363028
-  data.tar.gz: 689b1ac403436b3103790b16e9aee7c27dafa4895a0b233e6affaab51f3ddfee
+  metadata.gz: e59cb3b331969ed988a60ce1c2df37c0bd572ec76da3516daa8485918ea156b0
+  data.tar.gz: 8ae96791cf287f92c589d07c60270cb081908bcf262a707618847eec613f0ec2
 SHA512:
-  metadata.gz: 47b14f2079f3cdfada534bea71f1750f821ccde622f9c0a5b73ac670ddc06277f22d67495825f64acc0a6e231560bdaedf18a557d29cde08bb78afa7d809eb64
-  data.tar.gz: 8f683eb5a7a1e95bf1e9cbb4b9f9033a2eab4f499891ca3b44ef6dfaec5510a84fd0e9d387905a394e2b924185c39627f527c4b5738a2d47c0e3f04232d2585d
+  metadata.gz: 29fb3e3fac6917fbbfe48296884e93e7530cc0dc81962682acf4d52f67ee2e7d651156945f0b9cfcdc9e663fa8c203900b5d9de2bc6d80ba2aa9a16648981306
+  data.tar.gz: ec9eac65ef0b236859f30a2404c9c55fd1d434358d57f11c0fa3672201f8477ceb2ef4a3929f9109043b6bc839103f84e985445028fafa2a68ddeadec707b308

data/Gemfile.lock

@@ -1,23 +1,23 @@
 PATH
   remote: .
   specs:
-    ibancom (0.0.8)
+    ibancom (0.0.11)
       faraday (>= 0.15)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.1)
-      public_suffix (>= 2.0.2, < 6.0)
+    addressable (2.9.0)
+      public_suffix (>= 2.0.2, < 8.0)
     ast (2.4.2)
     coderay (1.1.3)
     crack (0.4.5)
       rexml
     diff-lcs (1.5.0)
-    faraday (2.5.2)
+    faraday (2.7.4)
       faraday-net_http (>= 2.0, < 3.1)
       ruby2_keywords (>= 0.0.4)
-    faraday-net_http (3.0.0)
+    faraday-net_http (3.0.2)
     ffi (1.15.5)
     formatador (1.1.0)
     guard (2.18.0)
@@ -35,8 +35,8 @@ GEM
       guard-compat (~> 1.1)
       rspec (>= 2.99.0, < 4.0)
     hashdiff (1.0.1)
-    json (2.6.2)
-    listen (3.7.1)
+    json (2.6.3)
+    listen (3.8.0)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     lumberjack (1.2.8)
@@ -46,63 +46,68 @@ GEM
       nenv (~> 0.1)
       shellany (~> 0.0)
     parallel (1.22.1)
-    parser (3.1.2.1)
+    parser (3.2.1.1)
       ast (~> 2.4.1)
-    pry (0.14.1)
+    pry (0.14.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    public_suffix (5.0.0)
+    public_suffix (5.1.1)
     rainbow (3.1.1)
     rake (12.3.3)
-    rb-fsevent (0.11.1)
+    rb-fsevent (0.11.2)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
-    regexp_parser (2.5.0)
-    rexml (3.2.5)
-    rspec (3.11.0)
-      rspec-core (~> 3.11.0)
-      rspec-expectations (~> 3.11.0)
-      rspec-mocks (~> 3.11.0)
-    rspec-core (3.11.0)
-      rspec-support (~> 3.11.0)
-    rspec-expectations (3.11.0)
+    regexp_parser (2.7.0)
+    rexml (3.4.2)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.1)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.2)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
-    rspec-mocks (3.11.1)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.4)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
-    rspec-support (3.11.0)
-    rubocop (1.35.1)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.0)
+    rubocop (1.48.1)
       json (~> 2.3)
       parallel (~> 1.10)
-      parser (>= 3.1.2.1)
+      parser (>= 3.2.0.0)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.20.1, < 2.0)
+      rubocop-ast (>= 1.26.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 3.0)
-    rubocop-ast (1.21.0)
-      parser (>= 3.1.1.0)
-    rubocop-performance (1.14.2)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.27.0)
+      parser (>= 3.2.1.0)
+    rubocop-capybara (2.17.1)
+      rubocop (~> 1.41)
+    rubocop-performance (1.16.0)
       rubocop (>= 1.7.0, < 2.0)
       rubocop-ast (>= 0.4.0)
     rubocop-rake (0.6.0)
       rubocop (~> 1.0)
-    rubocop-rspec (2.11.1)
-      rubocop (~> 1.19)
-    ruby-progressbar (1.11.0)
+    rubocop-rspec (2.19.0)
+      rubocop (~> 1.33)
+      rubocop-capybara (~> 2.17)
+    ruby-progressbar (1.13.0)
     ruby2_keywords (0.0.5)
     shellany (0.0.1)
-    test-prof (1.0.9)
+    test-prof (1.2.1)
     thor (1.2.1)
-    unicode-display_width (2.2.0)
+    unicode-display_width (2.4.2)
     webmock (3.18.1)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
 
 PLATFORMS
+  arm64-darwin-22
+  arm64-darwin-25
   x86_64-linux
 
 DEPENDENCIES
@@ -119,4 +124,4 @@ DEPENDENCIES
   webmock (~> 3.0)
 
 BUNDLED WITH
-   2.3.3
+   2.4.1

data/README.md

@@ -25,6 +25,7 @@ Or install it yourself as:
 This gem provides support for the following APIs:
 
 - Validation API v4
+- Sortware API v4
 
 ## Usage
 
@@ -79,6 +80,44 @@ iban.failed_checks
 # #<Ibancom::Resources::IBAN::Check:0x00007f384a576cf8 @code="203", @message="IBAN Length is not correct. Spain IBAN must be 24 characters long.", @response=nil, @type=:length>]
 ```
 
+You can also validate United Kingdom Sort Code and Account Numbers:
+
+```rb
+scan = client.validations.validate_scan("200415", "38290008")
+scan.valid? # true
+
+# What is the bank/branch associated to this account?
+bank = scan.bank # <Ibancom::Resources::SCAN::Bank:0x0000000107c0fc80 ...
+bank.bank        # "BARCLAYS BANK UK PLC"
+bank.bic         # "BUKBGB22XXX"
+bank.branch      # "BARCLAYBANK B'CARD N'PTON"
+bank.address     # "Dept AC Barclaycard House "
+bank.city        # "Northampton"
+bank.zip         # "NN4 7SG"
+bank.phone       # "01604 234234"
+bank.country     # "GB"
+
+# What payment schemes does it support?
+scan.supported_schemes
+#[#<Ibancom::Resources::SCAN::Scheme:0x0000000107c0df70 @code=:FPS_PAYMENTS, @response=nil, @supported="YES">,
+# #<Ibancom::Resources::SCAN::Scheme:0x0000000107c0def8 @code=:CHAPS, @response=nil, @supported="YES">,
+# #<Ibancom::Resources::SCAN::Scheme:0x0000000107c0de80 @code=:BACS, @response=nil, @supported="YES">,
+# #<Ibancom::Resources::SCAN::Scheme:0x0000000107c0de08 @code=:CCC_PAYMENTS, @response=nil, @supported="YES">]
+
+# Does the SCAN supports faster payments?
+scan.supported_scheme?(:FPS_PAYMENTS) # true
+```
+
+In the same way as with the IBAN, when the SCAN is not valid the failed checks are available for inspection:
+
+```rb
+scan = client.validations.validate_scan("000001", "00000002")
+scan.valid? # false
+scan.failed_checks
+#[#<Ibancom::Resources::SCAN::Check:0x00000001088debf0 @code="202", @message="Sort Code not found in bank directory",
+# @response=nil, @type=:length>]
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rake` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
@@ -86,8 +125,12 @@ After checking out the repo, run `bin/setup` to install dependencies. Then, run
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then tag and push the new version:
 
 ```git
-git tag vx.x.x main
-git push origin vx.x.x
+bundle install
+git add .
+git commit -m 'feat(release): Bump to vX.X.X'
+git push
+git tag vX.X.X main
+git push origin vX.X.X
 ```
 
 The tagging will trigger the GitHub action defined in `release.yml`, pushing the gem to [rubygems.org](https://rubygems.org).

data/lib/ibancom/api/validation_service.rb

@@ -7,6 +7,11 @@ module Ibancom
         response = client.post("/v4/iban/", { iban: iban, sci: 1 })
         Resources::IBAN::Validation.new(response, response.body)
       end
+
+      def validate_scan(sort_code, account_number)
+        response = client.post("/v4/sort/", { sortcode: sort_code, account: account_number })
+        Resources::SCAN::Validation.new(response, response.body)
+      end
     end
   end
 end

data/lib/ibancom/resources/base.rb

@@ -31,3 +31,10 @@ require_relative "iban/checks"
 require_relative "iban/check"
 require_relative "iban/schemes"
 require_relative "iban/scheme"
+require_relative "scan/validation"
+require_relative "scan/bank"
+require_relative "scan/account"
+require_relative "scan/checks"
+require_relative "scan/check"
+require_relative "scan/schemes"
+require_relative "scan/scheme"

data/lib/ibancom/resources/iban/check.rb

@@ -8,6 +8,7 @@ module Ibancom
           "001" => "IBAN Check digit is correct",
           "002" => "Account Number check digit is correct",
           "003" => "IBAN Length is correct",
+          "004" => "Account Number check digit is not performed for this bank or branch",
           "005" => "IBAN structure is correct",
           "006" => "IBAN does not contain illegal characters",
           "007" => "Country supports IBAN standard",

data/lib/ibancom/resources/scan/account.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Ibancom
+  module Resources
+    module SCAN
+      class Account < Base
+        attr_accessor :sortcode,
+                      :account,
+                      :iban
+      end
+    end
+  end
+end

data/lib/ibancom/resources/scan/bank.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Ibancom
+  module Resources
+    module SCAN
+      class Bank < Base
+        attr_accessor :bic,
+                      :branch,
+                      :bank,
+                      :address,
+                      :city,
+                      :zip,
+                      :phone,
+                      :country
+      end
+    end
+  end
+end

data/lib/ibancom/resources/scan/check.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Ibancom
+  module Resources
+    module SCAN
+      class Check < Base
+        PASSED_MESSAGES = {
+          "001" => "Modulus Success: Check digit is valid",
+          "002" => "Sort Code found in bank directory",
+          "006" => "Sort Code does not contain illegal characters",
+          "007" => "Account Number does not contain illegal characters",
+          "008" => "Sort Code length is correct",
+          "009" => "Account Number length is correct",
+        }.freeze
+
+        attr_accessor :type,
+                      :code,
+                      :message
+
+        def passed?
+          PASSED_MESSAGES[code] == message
+        end
+
+        def failed?
+          !passed?
+        end
+      end
+    end
+  end
+end

data/lib/ibancom/resources/scan/checks.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Ibancom
+  module Resources
+    module SCAN
+      class Checks < Collection
+        def initialize(response, attributes_collection)
+          parsed = attributes_collection.map do |check_attributes|
+            {
+              type: check_attributes[0],
+              code: check_attributes[1][:code],
+              message: check_attributes[1][:message],
+            }
+          end
+          super(response, Check, parsed)
+        end
+      end
+    end
+  end
+end

data/lib/ibancom/resources/scan/scheme.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Ibancom
+  module Resources
+    module SCAN
+      class Scheme < Base
+        attr_accessor :code,
+                      :supported
+
+        def supported?
+          supported == "YES"
+        end
+      end
+    end
+  end
+end

data/lib/ibancom/resources/scan/schemes.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Ibancom
+  module Resources
+    module SCAN
+      class Schemes < Collection
+        def initialize(response, attributes_collection)
+          parsed = attributes_collection.map do |attributes|
+            {
+              code: attributes[0],
+              supported: attributes[1],
+            }
+          end
+          super(response, Scheme, parsed)
+        end
+      end
+    end
+  end
+end

data/lib/ibancom/resources/scan/validation.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Ibancom
+  module Resources
+    module SCAN
+      class Validation < Base
+        attr_reader :bank,
+                    :account,
+                    :checks,
+                    :schemes
+
+        def initialize(response, attributes = {})
+          super(response, attributes)
+          @bank = Bank.new(response, attributes[:bank_data])
+          @account = Account.new(response, attributes[:account_data])
+          @checks = Checks.new(response, attributes[:validations])
+          @schemes = Schemes.new(response, attributes[:payment_schemes])
+        end
+
+        def valid?
+          checks.all?(&:passed?)
+        end
+
+        def failed_checks
+          checks.select(&:failed?)
+        end
+
+        def supported_schemes
+          schemes.select(&:supported?)
+        end
+
+        def supported_scheme?(code)
+          scheme = supported_schemes.find { |supported| supported.code == code }
+
+          return false if scheme.nil?
+
+          scheme.supported?
+        end
+      end
+    end
+  end
+end

data/lib/ibancom/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ibancom
-  VERSION = "0.0.8"
+  VERSION = "0.0.11"
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ibancom
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.11
 platform: ruby
 authors:
 - Aitor García Rey
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-09-22 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -198,6 +197,13 @@ files:
 - lib/ibancom/resources/iban/scheme.rb
 - lib/ibancom/resources/iban/schemes.rb
 - lib/ibancom/resources/iban/validation.rb
+- lib/ibancom/resources/scan/account.rb
+- lib/ibancom/resources/scan/bank.rb
+- lib/ibancom/resources/scan/check.rb
+- lib/ibancom/resources/scan/checks.rb
+- lib/ibancom/resources/scan/scheme.rb
+- lib/ibancom/resources/scan/schemes.rb
+- lib/ibancom/resources/scan/validation.rb
 - lib/ibancom/version.rb
 - sig/ibancom.rbs
 homepage: https://github.com/devengoapp/ibancom-ruby
@@ -207,7 +213,6 @@ metadata:
   homepage_uri: https://github.com/devengoapp/ibancom-ruby
   source_code_uri: https://github.com/devengoapp/ibancom-ruby
   rubygems_mfa_required: 'true'
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -222,8 +227,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Ruby client for iban.com APIs
 test_files: []