lithic 0.20.0 → 0.22.0

data/rbi/lithic/models/account_holder_updated_webhook_event.rbi

@@ -280,7 +280,8 @@ module Lithic
               end
 
             # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-            # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+            # acceptable; APO/FPO are acceptable. Only USA addresses are supported for the KYB
+            # and KYC workflows.
             sig do
               returns(
                 T.nilable(
@@ -347,7 +348,8 @@ module Lithic
             end
             def self.new(
               # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-              # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+              # acceptable; APO/FPO are acceptable. Only USA addresses are supported for the KYB
+              # and KYC workflows.
               address: nil,
               # Individual's date of birth, as an RFC 3339 date.
               dob: nil,
@@ -397,21 +399,12 @@ module Lithic
               sig { returns(String) }
               attr_accessor :city
 
-              # Valid country code. Only USA is currently supported, entered in uppercase ISO
-              # 3166-1 alpha-3 three-character format.
+              # Valid country code, entered in uppercase ISO 3166-1 alpha-3 three-character
+              # format. Supported countries depend on the onboarding workflow used for the
+              # account holder.
               sig { returns(String) }
               attr_accessor :country
 
-              # Valid postal code. Only USA ZIP codes are currently supported, entered as a
-              # five-digit ZIP or nine-digit ZIP+4.
-              sig { returns(String) }
-              attr_accessor :postal_code
-
-              # Valid state code. Only USA state codes are currently supported, entered in
-              # uppercase ISO 3166-2 two-character format.
-              sig { returns(String) }
-              attr_accessor :state
-
               # Unit or apartment number (if applicable).
               sig { returns(T.nilable(String)) }
               attr_reader :address2
@@ -419,16 +412,42 @@ module Lithic
               sig { params(address2: String).void }
               attr_writer :address2
 
+              # Valid postal code. For USA addresses, enter either a five-digit postal code or a
+              # nine-digit postal code (ZIP+4) using the format 12345-1234. Required for all
+              # countries except the following, which do not use postal codes: ABW, AGO, ARE,
+              # ATG, BDI, BEN, BFA, BHS, BLZ, BOL, BWA, CIV, CMR, COD, COG, COK, COM, DJI, DMA,
+              # ERI, FJI, GAB, GMB, GNQ, GRD, GUY, HKG, KIR, MAC, MLI, MRT, NIU, NRU, QAT, RWA,
+              # SLB, SLE, SSD, SUR, SXM, SYC, TGO, TKL, TLS, TON, TUV, UGA, VUT, YEM, ZWE
+              sig { returns(T.nilable(String)) }
+              attr_accessor :postal_code
+
+              # Valid state, province, or subdivision code, entered as the uppercase ISO 3166-2
+              # code for the country without the country prefix. For example, `CA` for
+              # California. Optional unless the address is in one of the following countries,
+              # where it is required:
+              #
+              # - `USA`
+              # - `CAN`
+              # - `AUS`
+              # - `CHN`
+              # - `KOR`
+              # - `MEX`
+              # - `MYS`
+              # - `NZL`
+              sig { returns(T.nilable(String)) }
+              attr_accessor :state
+
               # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-              # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+              # acceptable; APO/FPO are acceptable. Only USA addresses are supported for the KYB
+              # and KYC workflows.
               sig do
                 params(
                   address1: String,
                   city: String,
                   country: String,
-                  postal_code: String,
-                  state: String,
-                  address2: String
+                  address2: String,
+                  postal_code: T.nilable(String),
+                  state: T.nilable(String)
                 ).returns(T.attached_class)
               end
               def self.new(
@@ -436,17 +455,33 @@ module Lithic
                 address1:,
                 # Name of city.
                 city:,
-                # Valid country code. Only USA is currently supported, entered in uppercase ISO
-                # 3166-1 alpha-3 three-character format.
+                # Valid country code, entered in uppercase ISO 3166-1 alpha-3 three-character
+                # format. Supported countries depend on the onboarding workflow used for the
+                # account holder.
                 country:,
-                # Valid postal code. Only USA ZIP codes are currently supported, entered as a
-                # five-digit ZIP or nine-digit ZIP+4.
-                postal_code:,
-                # Valid state code. Only USA state codes are currently supported, entered in
-                # uppercase ISO 3166-2 two-character format.
-                state:,
                 # Unit or apartment number (if applicable).
-                address2: nil
+                address2: nil,
+                # Valid postal code. For USA addresses, enter either a five-digit postal code or a
+                # nine-digit postal code (ZIP+4) using the format 12345-1234. Required for all
+                # countries except the following, which do not use postal codes: ABW, AGO, ARE,
+                # ATG, BDI, BEN, BFA, BHS, BLZ, BOL, BWA, CIV, CMR, COD, COG, COK, COM, DJI, DMA,
+                # ERI, FJI, GAB, GMB, GNQ, GRD, GUY, HKG, KIR, MAC, MLI, MRT, NIU, NRU, QAT, RWA,
+                # SLB, SLE, SSD, SUR, SXM, SYC, TGO, TKL, TLS, TON, TUV, UGA, VUT, YEM, ZWE
+                postal_code: nil,
+                # Valid state, province, or subdivision code, entered as the uppercase ISO 3166-2
+                # code for the country without the country prefix. For example, `CA` for
+                # California. Optional unless the address is in one of the following countries,
+                # where it is required:
+                #
+                # - `USA`
+                # - `CAN`
+                # - `AUS`
+                # - `CHN`
+                # - `KOR`
+                # - `MEX`
+                # - `MYS`
+                # - `NZL`
+                state: nil
               )
               end
 
@@ -456,9 +491,9 @@ module Lithic
                     address1: String,
                     city: String,
                     country: String,
-                    postal_code: String,
-                    state: String,
-                    address2: String
+                    address2: String,
+                    postal_code: T.nilable(String),
+                    state: T.nilable(String)
                   }
                 )
               end
@@ -477,7 +512,8 @@ module Lithic
               end
 
             # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-            # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+            # acceptable; APO/FPO are acceptable. Only USA addresses are supported for the KYB
+            # and KYC workflows.
             sig do
               returns(
                 T.nilable(
@@ -552,7 +588,8 @@ module Lithic
             end
             def self.new(
               # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-              # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+              # acceptable; APO/FPO are acceptable. Only USA addresses are supported for the KYB
+              # and KYC workflows.
               address: nil,
               # Individual's date of birth, as an RFC 3339 date.
               dob: nil,
@@ -602,21 +639,12 @@ module Lithic
               sig { returns(String) }
               attr_accessor :city
 
-              # Valid country code. Only USA is currently supported, entered in uppercase ISO
-              # 3166-1 alpha-3 three-character format.
+              # Valid country code, entered in uppercase ISO 3166-1 alpha-3 three-character
+              # format. Supported countries depend on the onboarding workflow used for the
+              # account holder.
               sig { returns(String) }
               attr_accessor :country
 
-              # Valid postal code. Only USA ZIP codes are currently supported, entered as a
-              # five-digit ZIP or nine-digit ZIP+4.
-              sig { returns(String) }
-              attr_accessor :postal_code
-
-              # Valid state code. Only USA state codes are currently supported, entered in
-              # uppercase ISO 3166-2 two-character format.
-              sig { returns(String) }
-              attr_accessor :state
-
               # Unit or apartment number (if applicable).
               sig { returns(T.nilable(String)) }
               attr_reader :address2
@@ -624,16 +652,42 @@ module Lithic
               sig { params(address2: String).void }
               attr_writer :address2
 
+              # Valid postal code. For USA addresses, enter either a five-digit postal code or a
+              # nine-digit postal code (ZIP+4) using the format 12345-1234. Required for all
+              # countries except the following, which do not use postal codes: ABW, AGO, ARE,
+              # ATG, BDI, BEN, BFA, BHS, BLZ, BOL, BWA, CIV, CMR, COD, COG, COK, COM, DJI, DMA,
+              # ERI, FJI, GAB, GMB, GNQ, GRD, GUY, HKG, KIR, MAC, MLI, MRT, NIU, NRU, QAT, RWA,
+              # SLB, SLE, SSD, SUR, SXM, SYC, TGO, TKL, TLS, TON, TUV, UGA, VUT, YEM, ZWE
+              sig { returns(T.nilable(String)) }
+              attr_accessor :postal_code
+
+              # Valid state, province, or subdivision code, entered as the uppercase ISO 3166-2
+              # code for the country without the country prefix. For example, `CA` for
+              # California. Optional unless the address is in one of the following countries,
+              # where it is required:
+              #
+              # - `USA`
+              # - `CAN`
+              # - `AUS`
+              # - `CHN`
+              # - `KOR`
+              # - `MEX`
+              # - `MYS`
+              # - `NZL`
+              sig { returns(T.nilable(String)) }
+              attr_accessor :state
+
               # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-              # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+              # acceptable; APO/FPO are acceptable. Only USA addresses are supported for the KYB
+              # and KYC workflows.
               sig do
                 params(
                   address1: String,
                   city: String,
                   country: String,
-                  postal_code: String,
-                  state: String,
-                  address2: String
+                  address2: String,
+                  postal_code: T.nilable(String),
+                  state: T.nilable(String)
                 ).returns(T.attached_class)
               end
               def self.new(
@@ -641,17 +695,33 @@ module Lithic
                 address1:,
                 # Name of city.
                 city:,
-                # Valid country code. Only USA is currently supported, entered in uppercase ISO
-                # 3166-1 alpha-3 three-character format.
+                # Valid country code, entered in uppercase ISO 3166-1 alpha-3 three-character
+                # format. Supported countries depend on the onboarding workflow used for the
+                # account holder.
                 country:,
-                # Valid postal code. Only USA ZIP codes are currently supported, entered as a
-                # five-digit ZIP or nine-digit ZIP+4.
-                postal_code:,
-                # Valid state code. Only USA state codes are currently supported, entered in
-                # uppercase ISO 3166-2 two-character format.
-                state:,
                 # Unit or apartment number (if applicable).
-                address2: nil
+                address2: nil,
+                # Valid postal code. For USA addresses, enter either a five-digit postal code or a
+                # nine-digit postal code (ZIP+4) using the format 12345-1234. Required for all
+                # countries except the following, which do not use postal codes: ABW, AGO, ARE,
+                # ATG, BDI, BEN, BFA, BHS, BLZ, BOL, BWA, CIV, CMR, COD, COG, COK, COM, DJI, DMA,
+                # ERI, FJI, GAB, GMB, GNQ, GRD, GUY, HKG, KIR, MAC, MLI, MRT, NIU, NRU, QAT, RWA,
+                # SLB, SLE, SSD, SUR, SXM, SYC, TGO, TKL, TLS, TON, TUV, UGA, VUT, YEM, ZWE
+                postal_code: nil,
+                # Valid state, province, or subdivision code, entered as the uppercase ISO 3166-2
+                # code for the country without the country prefix. For example, `CA` for
+                # California. Optional unless the address is in one of the following countries,
+                # where it is required:
+                #
+                # - `USA`
+                # - `CAN`
+                # - `AUS`
+                # - `CHN`
+                # - `KOR`
+                # - `MEX`
+                # - `MYS`
+                # - `NZL`
+                state: nil
               )
               end
 
@@ -661,9 +731,9 @@ module Lithic
                     address1: String,
                     city: String,
                     country: String,
-                    postal_code: String,
-                    state: String,
-                    address2: String
+                    address2: String,
+                    postal_code: T.nilable(String),
+                    state: T.nilable(String)
                   }
                 )
               end
@@ -861,7 +931,8 @@ module Lithic
               end
 
             # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-            # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+            # acceptable; APO/FPO are acceptable. Only USA addresses are supported for the KYB
+            # and KYC workflows.
             sig do
               returns(
                 T.nilable(
@@ -930,7 +1001,8 @@ module Lithic
             end
             def self.new(
               # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-              # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+              # acceptable; APO/FPO are acceptable. Only USA addresses are supported for the KYB
+              # and KYC workflows.
               address: nil,
               # Individual's date of birth, as an RFC 3339 date.
               dob: nil,
@@ -980,21 +1052,12 @@ module Lithic
               sig { returns(String) }
               attr_accessor :city
 
-              # Valid country code. Only USA is currently supported, entered in uppercase ISO
-              # 3166-1 alpha-3 three-character format.
+              # Valid country code, entered in uppercase ISO 3166-1 alpha-3 three-character
+              # format. Supported countries depend on the onboarding workflow used for the
+              # account holder.
               sig { returns(String) }
               attr_accessor :country
 
-              # Valid postal code. Only USA ZIP codes are currently supported, entered as a
-              # five-digit ZIP or nine-digit ZIP+4.
-              sig { returns(String) }
-              attr_accessor :postal_code
-
-              # Valid state code. Only USA state codes are currently supported, entered in
-              # uppercase ISO 3166-2 two-character format.
-              sig { returns(String) }
-              attr_accessor :state
-
               # Unit or apartment number (if applicable).
               sig { returns(T.nilable(String)) }
               attr_reader :address2
@@ -1002,16 +1065,42 @@ module Lithic
               sig { params(address2: String).void }
               attr_writer :address2
 
+              # Valid postal code. For USA addresses, enter either a five-digit postal code or a
+              # nine-digit postal code (ZIP+4) using the format 12345-1234. Required for all
+              # countries except the following, which do not use postal codes: ABW, AGO, ARE,
+              # ATG, BDI, BEN, BFA, BHS, BLZ, BOL, BWA, CIV, CMR, COD, COG, COK, COM, DJI, DMA,
+              # ERI, FJI, GAB, GMB, GNQ, GRD, GUY, HKG, KIR, MAC, MLI, MRT, NIU, NRU, QAT, RWA,
+              # SLB, SLE, SSD, SUR, SXM, SYC, TGO, TKL, TLS, TON, TUV, UGA, VUT, YEM, ZWE
+              sig { returns(T.nilable(String)) }
+              attr_accessor :postal_code
+
+              # Valid state, province, or subdivision code, entered as the uppercase ISO 3166-2
+              # code for the country without the country prefix. For example, `CA` for
+              # California. Optional unless the address is in one of the following countries,
+              # where it is required:
+              #
+              # - `USA`
+              # - `CAN`
+              # - `AUS`
+              # - `CHN`
+              # - `KOR`
+              # - `MEX`
+              # - `MYS`
+              # - `NZL`
+              sig { returns(T.nilable(String)) }
+              attr_accessor :state
+
               # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-              # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+              # acceptable; APO/FPO are acceptable. Only USA addresses are supported for the KYB
+              # and KYC workflows.
               sig do
                 params(
                   address1: String,
                   city: String,
                   country: String,
-                  postal_code: String,
-                  state: String,
-                  address2: String
+                  address2: String,
+                  postal_code: T.nilable(String),
+                  state: T.nilable(String)
                 ).returns(T.attached_class)
               end
               def self.new(
@@ -1019,17 +1108,33 @@ module Lithic
                 address1:,
                 # Name of city.
                 city:,
-                # Valid country code. Only USA is currently supported, entered in uppercase ISO
-                # 3166-1 alpha-3 three-character format.
+                # Valid country code, entered in uppercase ISO 3166-1 alpha-3 three-character
+                # format. Supported countries depend on the onboarding workflow used for the
+                # account holder.
                 country:,
-                # Valid postal code. Only USA ZIP codes are currently supported, entered as a
-                # five-digit ZIP or nine-digit ZIP+4.
-                postal_code:,
-                # Valid state code. Only USA state codes are currently supported, entered in
-                # uppercase ISO 3166-2 two-character format.
-                state:,
                 # Unit or apartment number (if applicable).
-                address2: nil
+                address2: nil,
+                # Valid postal code. For USA addresses, enter either a five-digit postal code or a
+                # nine-digit postal code (ZIP+4) using the format 12345-1234. Required for all
+                # countries except the following, which do not use postal codes: ABW, AGO, ARE,
+                # ATG, BDI, BEN, BFA, BHS, BLZ, BOL, BWA, CIV, CMR, COD, COG, COK, COM, DJI, DMA,
+                # ERI, FJI, GAB, GMB, GNQ, GRD, GUY, HKG, KIR, MAC, MLI, MRT, NIU, NRU, QAT, RWA,
+                # SLB, SLE, SSD, SUR, SXM, SYC, TGO, TKL, TLS, TON, TUV, UGA, VUT, YEM, ZWE
+                postal_code: nil,
+                # Valid state, province, or subdivision code, entered as the uppercase ISO 3166-2
+                # code for the country without the country prefix. For example, `CA` for
+                # California. Optional unless the address is in one of the following countries,
+                # where it is required:
+                #
+                # - `USA`
+                # - `CAN`
+                # - `AUS`
+                # - `CHN`
+                # - `KOR`
+                # - `MEX`
+                # - `MYS`
+                # - `NZL`
+                state: nil
               )
               end
 
@@ -1039,9 +1144,9 @@ module Lithic
                     address1: String,
                     city: String,
                     country: String,
-                    postal_code: String,
-                    state: String,
-                    address2: String
+                    address2: String,
+                    postal_code: T.nilable(String),
+                    state: T.nilable(String)
                   }
                 )
               end

data/rbi/lithic/models/account_holders/account_holder_entity.rbi

@@ -144,21 +144,12 @@ module Lithic
           sig { returns(String) }
           attr_accessor :city
 
-          # Valid country code. Only USA is currently supported, entered in uppercase ISO
-          # 3166-1 alpha-3 three-character format.
+          # Valid country code, entered in uppercase ISO 3166-1 alpha-3 three-character
+          # format. Supported countries depend on the onboarding workflow used for the
+          # account holder.
           sig { returns(String) }
           attr_accessor :country
 
-          # Valid postal code. Only USA ZIP codes are currently supported, entered as a
-          # five-digit ZIP or nine-digit ZIP+4.
-          sig { returns(String) }
-          attr_accessor :postal_code
-
-          # Valid state code. Only USA state codes are currently supported, entered in
-          # uppercase ISO 3166-2 two-character format.
-          sig { returns(String) }
-          attr_accessor :state
-
           # Unit or apartment number (if applicable).
           sig { returns(T.nilable(String)) }
           attr_reader :address2
@@ -166,15 +157,40 @@ module Lithic
           sig { params(address2: String).void }
           attr_writer :address2
 
+          # Valid postal code. For USA addresses, enter either a five-digit postal code or a
+          # nine-digit postal code (ZIP+4) using the format 12345-1234. Required for all
+          # countries except the following, which do not use postal codes: ABW, AGO, ARE,
+          # ATG, BDI, BEN, BFA, BHS, BLZ, BOL, BWA, CIV, CMR, COD, COG, COK, COM, DJI, DMA,
+          # ERI, FJI, GAB, GMB, GNQ, GRD, GUY, HKG, KIR, MAC, MLI, MRT, NIU, NRU, QAT, RWA,
+          # SLB, SLE, SSD, SUR, SXM, SYC, TGO, TKL, TLS, TON, TUV, UGA, VUT, YEM, ZWE
+          sig { returns(T.nilable(String)) }
+          attr_accessor :postal_code
+
+          # Valid state, province, or subdivision code, entered as the uppercase ISO 3166-2
+          # code for the country without the country prefix. For example, `CA` for
+          # California. Optional unless the address is in one of the following countries,
+          # where it is required:
+          #
+          # - `USA`
+          # - `CAN`
+          # - `AUS`
+          # - `CHN`
+          # - `KOR`
+          # - `MEX`
+          # - `MYS`
+          # - `NZL`
+          sig { returns(T.nilable(String)) }
+          attr_accessor :state
+
           # Individual's current address
           sig do
             params(
               address1: String,
               city: String,
               country: String,
-              postal_code: String,
-              state: String,
-              address2: String
+              address2: String,
+              postal_code: T.nilable(String),
+              state: T.nilable(String)
             ).returns(T.attached_class)
           end
           def self.new(
@@ -182,17 +198,33 @@ module Lithic
             address1:,
             # Name of city.
             city:,
-            # Valid country code. Only USA is currently supported, entered in uppercase ISO
-            # 3166-1 alpha-3 three-character format.
+            # Valid country code, entered in uppercase ISO 3166-1 alpha-3 three-character
+            # format. Supported countries depend on the onboarding workflow used for the
+            # account holder.
             country:,
-            # Valid postal code. Only USA ZIP codes are currently supported, entered as a
-            # five-digit ZIP or nine-digit ZIP+4.
-            postal_code:,
-            # Valid state code. Only USA state codes are currently supported, entered in
-            # uppercase ISO 3166-2 two-character format.
-            state:,
             # Unit or apartment number (if applicable).
-            address2: nil
+            address2: nil,
+            # Valid postal code. For USA addresses, enter either a five-digit postal code or a
+            # nine-digit postal code (ZIP+4) using the format 12345-1234. Required for all
+            # countries except the following, which do not use postal codes: ABW, AGO, ARE,
+            # ATG, BDI, BEN, BFA, BHS, BLZ, BOL, BWA, CIV, CMR, COD, COG, COK, COM, DJI, DMA,
+            # ERI, FJI, GAB, GMB, GNQ, GRD, GUY, HKG, KIR, MAC, MLI, MRT, NIU, NRU, QAT, RWA,
+            # SLB, SLE, SSD, SUR, SXM, SYC, TGO, TKL, TLS, TON, TUV, UGA, VUT, YEM, ZWE
+            postal_code: nil,
+            # Valid state, province, or subdivision code, entered as the uppercase ISO 3166-2
+            # code for the country without the country prefix. For example, `CA` for
+            # California. Optional unless the address is in one of the following countries,
+            # where it is required:
+            #
+            # - `USA`
+            # - `CAN`
+            # - `AUS`
+            # - `CHN`
+            # - `KOR`
+            # - `MEX`
+            # - `MYS`
+            # - `NZL`
+            state: nil
           )
           end
 
@@ -202,9 +234,9 @@ module Lithic
                 address1: String,
                 city: String,
                 country: String,
-                postal_code: String,
-                state: String,
-                address2: String
+                address2: String,
+                postal_code: T.nilable(String),
+                state: T.nilable(String)
               }
             )
           end