lithic 0.1.0.pre.alpha.16 → 0.1.0.pre.alpha.18

data/rbi/lib/lithic/models/account_holder_update_params.rbi

@@ -179,20 +179,56 @@ module Lithic
           .returns(T.attached_class)
       end
       def self.new(
+        # Deprecated.
         beneficial_owner_entities: nil,
+        # You must submit a list of all direct and indirect individuals with 25% or more
+        # ownership in the company. A maximum of 4 beneficial owners can be submitted. If
+        # no individual owns 25% of the company you do not need to send beneficial owner
+        # information. See
+        # [FinCEN requirements](https://www.fincen.gov/sites/default/files/shared/CDD_Rev6.7_Sept_2017_Certificate.pdf)
+        # (Section I) for more background on individuals that should be included.
         beneficial_owner_individuals: nil,
+        # Information for business for which the account is being opened and KYB is being
+        # run.
         business_entity: nil,
+        # An individual with significant responsibility for managing the legal entity
+        # (e.g., a Chief Executive Officer, Chief Financial Officer, Chief Operating
+        # Officer, Managing Member, General Partner, President, Vice President, or
+        # Treasurer). This can be an executive, or someone who will have program-wide
+        # access to the cards that Lithic will provide. In some cases, this individual
+        # could also be a beneficial owner listed above. See
+        # [FinCEN requirements](https://www.fincen.gov/sites/default/files/shared/CDD_Rev6.7_Sept_2017_Certificate.pdf)
+        # (Section II) for more background.
         control_person: nil,
+        # A user provided id that can be used to link an account holder with an external
+        # system
         external_id: nil,
+        # Short description of the company's line of business (i.e., what does the company
+        # do?).
         nature_of_business: nil,
+        # Company website URL.
         website_url: nil,
+        # Information on the individual for whom the account is being opened and KYC is
+        # being run.
         individual: nil,
+        # Allowed for: KYC-Exempt, BYO-KYC, BYO-KYB.
         address: nil,
+        # Allowed for: KYC-Exempt, BYO-KYC. The token of the business account to which the
+        # account holder is associated.
         business_account_token: nil,
+        # Allowed for all Account Holders. Account holder's email address. The primary
+        # purpose of this field is for cardholder identification and verification during
+        # the digital wallet tokenization process.
         email: nil,
+        # Allowed for KYC-Exempt, BYO-KYC. Account holder's first name.
         first_name: nil,
+        # Allowed for KYC-Exempt, BYO-KYC. Account holder's last name.
         last_name: nil,
+        # Allowed for BYO-KYB. Legal business name of the account holder.
         legal_business_name: nil,
+        # Allowed for all Account Holders. Account holder's phone number, entered in E.164
+        # format. The primary purpose of this field is for cardholder identification and
+        # verification during the digital wallet tokenization process.
         phone_number: nil,
         request_options: {}
       ); end
@@ -286,12 +322,24 @@ module Lithic
             .returns(T.attached_class)
         end
         def self.new(
+          # Globally unique identifier for an entity.
           entity_token:,
+          # Business''s physical address - PO boxes, UPS drops, and FedEx drops are not
+          # acceptable; APO/FPO are acceptable.
           address: nil,
+          # Any name that the business operates under that is not its legal business name
+          # (if applicable).
           dba_business_name: nil,
+          # Government-issued identification number. US Federal Employer Identification
+          # Numbers (EIN) are currently supported, entered as full nine-digits, with or
+          # without hyphens.
           government_id: nil,
+          # Legal (formal) business name.
           legal_business_name: nil,
+          # Parent company name (if applicable).
           parent_company: nil,
+          # One or more of the business's phone number(s), entered as a list in E.164
+          # format.
           phone_numbers: nil
         ); end
         sig do
@@ -385,13 +433,26 @@ module Lithic
             .returns(T.attached_class)
         end
         def self.new(
+          # Globally unique identifier for an entity.
           entity_token:,
+          # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
+          # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
           address: nil,
+          # Individual's date of birth, as an RFC 3339 date.
           dob: nil,
+          # Individual's email address. If utilizing Lithic for chargeback processing, this
+          # customer email address may be used to communicate dispute status and resolution.
           email: nil,
+          # Individual's first name, as it appears on government-issued identity documents.
           first_name: nil,
+          # Government-issued identification number (required for identity verification and
+          # compliance with banking regulations). Social Security Numbers (SSN) and
+          # Individual Taxpayer Identification Numbers (ITIN) are currently supported,
+          # entered as full nine-digits, with or without hyphens
           government_id: nil,
+          # Individual's last name, as it appears on government-issued identity documents.
           last_name: nil,
+          # Individual's phone number, entered in E.164 format.
           phone_number: nil
         ); end
         sig do
@@ -479,12 +540,24 @@ module Lithic
             .returns(T.attached_class)
         end
         def self.new(
+          # Globally unique identifier for an entity.
           entity_token:,
+          # Business''s physical address - PO boxes, UPS drops, and FedEx drops are not
+          # acceptable; APO/FPO are acceptable.
           address: nil,
+          # Any name that the business operates under that is not its legal business name
+          # (if applicable).
           dba_business_name: nil,
+          # Government-issued identification number. US Federal Employer Identification
+          # Numbers (EIN) are currently supported, entered as full nine-digits, with or
+          # without hyphens.
           government_id: nil,
+          # Legal (formal) business name.
           legal_business_name: nil,
+          # Parent company name (if applicable).
           parent_company: nil,
+          # One or more of the business's phone number(s), entered as a list in E.164
+          # format.
           phone_numbers: nil
         ); end
         sig do
@@ -585,13 +658,26 @@ module Lithic
             .returns(T.attached_class)
         end
         def self.new(
+          # Globally unique identifier for an entity.
           entity_token:,
+          # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
+          # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
           address: nil,
+          # Individual's date of birth, as an RFC 3339 date.
           dob: nil,
+          # Individual's email address. If utilizing Lithic for chargeback processing, this
+          # customer email address may be used to communicate dispute status and resolution.
           email: nil,
+          # Individual's first name, as it appears on government-issued identity documents.
           first_name: nil,
+          # Government-issued identification number (required for identity verification and
+          # compliance with banking regulations). Social Security Numbers (SSN) and
+          # Individual Taxpayer Identification Numbers (ITIN) are currently supported,
+          # entered as full nine-digits, with or without hyphens
           government_id: nil,
+          # Individual's last name, as it appears on government-issued identity documents.
           last_name: nil,
+          # Individual's phone number, entered in E.164 format.
           phone_number: nil
         ); end
         sig do
@@ -687,13 +773,26 @@ module Lithic
             .returns(T.attached_class)
         end
         def self.new(
+          # Globally unique identifier for an entity.
           entity_token:,
+          # Individual's current address - PO boxes, UPS drops, and FedEx drops are not
+          # acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
           address: nil,
+          # Individual's date of birth, as an RFC 3339 date.
           dob: nil,
+          # Individual's email address. If utilizing Lithic for chargeback processing, this
+          # customer email address may be used to communicate dispute status and resolution.
           email: nil,
+          # Individual's first name, as it appears on government-issued identity documents.
           first_name: nil,
+          # Government-issued identification number (required for identity verification and
+          # compliance with banking regulations). Social Security Numbers (SSN) and
+          # Individual Taxpayer Identification Numbers (ITIN) are currently supported,
+          # entered as full nine-digits, with or without hyphens
           government_id: nil,
+          # Individual's last name, as it appears on government-issued identity documents.
           last_name: nil,
+          # Individual's phone number, entered in E.164 format.
           phone_number: nil
         ); end
         sig do

data/rbi/lib/lithic/models/account_holder_update_response.rbi

@@ -305,25 +305,85 @@ module Lithic
             .returns(T.attached_class)
         end
         def self.new(
+          # Globally unique identifier for the account holder.
           token: nil,
+          # Globally unique identifier for the account.
           account_token: nil,
+          # Deprecated.
           beneficial_owner_entities: nil,
+          # Only present when user_type == "BUSINESS". You must submit a list of all direct
+          # and indirect individuals with 25% or more ownership in the company. A maximum of
+          # 4 beneficial owners can be submitted. If no individual owns 25% of the company
+          # you do not need to send beneficial owner information. See
+          # [FinCEN requirements](https://www.fincen.gov/sites/default/files/shared/CDD_Rev6.7_Sept_2017_Certificate.pdf)
+          # (Section I) for more background on individuals that should be included.
           beneficial_owner_individuals: nil,
+          # Only applicable for customers using the KYC-Exempt workflow to enroll authorized
+          # users of businesses. Pass the account_token of the enrolled business associated
+          # with the AUTHORIZED_USER in this field.
           business_account_token: nil,
+          # Only present when user_type == "BUSINESS". Information about the business for
+          # which the account is being opened and KYB is being run.
           business_entity: nil,
+          # Only present when user_type == "BUSINESS".
+          #
+          # An individual with significant responsibility for managing the legal entity
+          # (e.g., a Chief Executive Officer, Chief Financial Officer, Chief Operating
+          # Officer,
+          #
+          # Managing Member, General Partner, President, Vice President, or Treasurer). This
+          # can be an executive, or someone who will have program-wide access
+          #
+          # to the cards that Lithic will provide. In some cases, this individual could also
+          # be a beneficial owner listed above.
           control_person: nil,
+          # Timestamp of when the account holder was created.
           created: nil,
+          # < Deprecated. Use control_person.email when user_type == "BUSINESS". Use
+          # individual.phone_number when user_type == "INDIVIDUAL".
+          #
+          # > Primary email of Account Holder.
           email: nil,
+          # The type of KYC exemption for a KYC-Exempt Account Holder. "None" if the account
+          # holder is not KYC-Exempt.
           exemption_type: nil,
+          # Customer-provided token that indicates a relationship with an object outside of
+          # the Lithic ecosystem.
           external_id: nil,
+          # Only present when user_type == "INDIVIDUAL". Information about the individual
+          # for which the account is being opened and KYC is being run.
           individual: nil,
+          # Only present when user_type == "BUSINESS". User-submitted description of the
+          # business.
           nature_of_business: nil,
+          # < Deprecated. Use control_person.phone_number when user_type == "BUSINESS". Use
+          # individual.phone_number when user_type == "INDIVIDUAL".
+          #
+          # > Primary phone of Account Holder, entered in E.164 format.
           phone_number: nil,
+          # Only present for "KYB_BASIC" and "KYC_ADVANCED" workflows. A list of documents
+          # required for the account holder to be approved.
           required_documents: nil,
+          # <Deprecated. Use verification_application.status instead>
+          #
+          # KYC and KYB evaluation states.
+          #
+          # Note: `PENDING_RESUBMIT` and `PENDING_DOCUMENT` are only applicable for the
+          # `ADVANCED` workflow.
           status: nil,
+          # <Deprecated. Use verification_application.status_reasons> Reason for the
+          # evaluation status.
           status_reasons: nil,
+          # The type of Account Holder. If the type is "INDIVIDUAL", the "individual"
+          # attribute will be present.
+          #
+          # If the type is "BUSINESS" then the "business_entity", "control_person",
+          # "beneficial_owner_individuals", "nature_of_business", and "website_url"
+          # attributes will be present.
           user_type: nil,
+          # Information about the most recent identity verification attempt
           verification_application: nil,
+          # Only present when user_type == "BUSINESS". Business's primary website.
           website_url: nil
         ); end
         sig do
@@ -429,15 +489,21 @@ module Lithic
               .returns(T.attached_class)
           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.
             address: nil,
+            # Individual's date of birth, as an RFC 3339 date.
             dob: nil,
+            # Individual's email address. If utilizing Lithic for chargeback processing, this
+            # customer email address may be used to communicate dispute status and resolution.
             email: nil,
+            # Individual's first name, as it appears on government-issued identity documents.
             first_name: nil,
+            # Individual's last name, as it appears on government-issued identity documents.
             last_name: nil,
+            # Individual's phone number, entered in E.164 format.
             phone_number: nil
-          )
-          end
-
+          ); end
           sig do
             override
               .returns(
@@ -498,8 +564,23 @@ module Lithic
               )
                 .returns(T.attached_class)
             end
-            def self.new(address1:, city:, country:, postal_code:, state:, address2: nil); end
-
+            def self.new(
+              # Valid deliverable address (no PO boxes).
+              address1:,
+              # Name of city.
+              city:,
+              # Valid country code. Only USA is currently supported, entered in uppercase ISO
+              # 3166-1 alpha-3 three-character format.
+              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
+            ); end
             sig do
               override
                 .returns(
@@ -600,15 +681,21 @@ module Lithic
               .returns(T.attached_class)
           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.
             address: nil,
+            # Individual's date of birth, as an RFC 3339 date.
             dob: nil,
+            # Individual's email address. If utilizing Lithic for chargeback processing, this
+            # customer email address may be used to communicate dispute status and resolution.
             email: nil,
+            # Individual's first name, as it appears on government-issued identity documents.
             first_name: nil,
+            # Individual's last name, as it appears on government-issued identity documents.
             last_name: nil,
+            # Individual's phone number, entered in E.164 format.
             phone_number: nil
-          )
-          end
-
+          ); end
           sig do
             override
               .returns(
@@ -669,8 +756,23 @@ module Lithic
               )
                 .returns(T.attached_class)
             end
-            def self.new(address1:, city:, country:, postal_code:, state:, address2: nil); end
-
+            def self.new(
+              # Valid deliverable address (no PO boxes).
+              address1:,
+              # Name of city.
+              city:,
+              # Valid country code. Only USA is currently supported, entered in uppercase ISO
+              # 3166-1 alpha-3 three-character format.
+              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
+            ); end
             sig do
               override
                 .returns(
@@ -787,15 +889,21 @@ module Lithic
               .returns(T.attached_class)
           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.
             address: nil,
+            # Individual's date of birth, as an RFC 3339 date.
             dob: nil,
+            # Individual's email address. If utilizing Lithic for chargeback processing, this
+            # customer email address may be used to communicate dispute status and resolution.
             email: nil,
+            # Individual's first name, as it appears on government-issued identity documents.
             first_name: nil,
+            # Individual's last name, as it appears on government-issued identity documents.
             last_name: nil,
+            # Individual's phone number, entered in E.164 format.
             phone_number: nil
-          )
-          end
-
+          ); end
           sig do
             override
               .returns(
@@ -856,8 +964,23 @@ module Lithic
               )
                 .returns(T.attached_class)
             end
-            def self.new(address1:, city:, country:, postal_code:, state:, address2: nil); end
-
+            def self.new(
+              # Valid deliverable address (no PO boxes).
+              address1:,
+              # Name of city.
+              city:,
+              # Valid country code. Only USA is currently supported, entered in uppercase ISO
+              # 3166-1 alpha-3 three-character format.
+              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
+            ); end
             sig do
               override
                 .returns(
@@ -1120,8 +1243,19 @@ module Lithic
             )
               .returns(T.attached_class)
           end
-          def self.new(created:, status:, status_reasons:, updated:); end
-
+          def self.new(
+            # Timestamp of when the application was created.
+            created:,
+            # KYC and KYB evaluation states.
+            #
+            # Note: `PENDING_RESUBMIT` and `PENDING_DOCUMENT` are only applicable for the
+            # `ADVANCED` workflow.
+            status:,
+            # Reason for the evaluation status.
+            status_reasons:,
+            # Timestamp of when the application was last updated.
+            updated:
+          ); end
           sig do
             override
               .returns(
@@ -1402,13 +1536,21 @@ module Lithic
             .returns(T.attached_class)
         end
         def self.new(
+          # The token for the account holder that was updated
           token: nil,
+          # The address for the account holder
           address: nil,
+          # The token for the business account that the account holder is associated with
           business_account_token: nil,
+          # The email for the account holder
           email: nil,
+          # The first name for the account holder
           first_name: nil,
+          # The last name for the account holder
           last_name: nil,
+          # The legal business name for the account holder
           legal_business_name: nil,
+          # The phone_number for the account holder
           phone_number: nil
         ); end
         sig do
@@ -1471,8 +1613,23 @@ module Lithic
             )
               .returns(T.attached_class)
           end
-          def self.new(address1:, city:, country:, postal_code:, state:, address2: nil); end
-
+          def self.new(
+            # Valid deliverable address (no PO boxes).
+            address1:,
+            # Name of city.
+            city:,
+            # Valid country code. Only USA is currently supported, entered in uppercase ISO
+            # 3166-1 alpha-3 three-character format.
+            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
+          ); end
           sig do
             override
               .returns(

data/rbi/lib/lithic/models/account_holder_upload_document_params.rbi

@@ -22,8 +22,13 @@ module Lithic
         )
           .returns(T.attached_class)
       end
-      def self.new(document_type:, entity_token:, request_options: {}); end
-
+      def self.new(
+        # The type of document to upload
+        document_type:,
+        # Globally unique identifier for the entity.
+        entity_token:,
+        request_options: {}
+      ); end
       sig do
         override
           .returns(

data/rbi/lib/lithic/models/account_list_params.rbi

@@ -57,15 +57,22 @@ module Lithic
           .returns(T.attached_class)
       end
       def self.new(
+        # Date string in RFC 3339 format. Only entries created after the specified time
+        # will be included. UTC time zone.
         begin_: nil,
+        # Date string in RFC 3339 format. Only entries created before the specified time
+        # will be included. UTC time zone.
         end_: nil,
+        # A cursor representing an item's token before which a page of results should end.
+        # Used to retrieve the previous page of results before this item.
         ending_before: nil,
+        # Page size (for pagination).
         page_size: nil,
+        # A cursor representing an item's token after which a page of results should
+        # begin. Used to retrieve the next page of results after this item.
         starting_after: nil,
         request_options: {}
-      )
-      end
-
+      ); end
       sig do
         override
           .returns(

data/rbi/lib/lithic/models/account_spend_limits.rbi

@@ -79,8 +79,17 @@ module Lithic
         attr_writer :monthly
 
         sig { params(daily: Integer, lifetime: Integer, monthly: Integer).returns(T.attached_class) }
-        def self.new(daily: nil, lifetime: nil, monthly: nil); end
-
+        def self.new(
+          # The available spend limit (in cents) relative to the daily limit configured on
+          # the Account (e.g. 100000 would be a $1,000 limit).
+          daily: nil,
+          # The available spend limit (in cents) relative to the lifetime limit configured
+          # on the Account.
+          lifetime: nil,
+          # The available spend limit (in cents) relative to the monthly limit configured on
+          # the Account.
+          monthly: nil
+        ); end
         sig { override.returns({daily: Integer, lifetime: Integer, monthly: Integer}) }
         def to_hash; end
       end
@@ -108,8 +117,14 @@ module Lithic
         attr_writer :monthly
 
         sig { params(daily: Integer, lifetime: Integer, monthly: Integer).returns(T.attached_class) }
-        def self.new(daily: nil, lifetime: nil, monthly: nil); end
-
+        def self.new(
+          # The configured daily spend limit (in cents) on the Account.
+          daily: nil,
+          # The configured lifetime spend limit (in cents) on the Account.
+          lifetime: nil,
+          # The configured monthly spend limit (in cents) on the Account.
+          monthly: nil
+        ); end
         sig { override.returns({daily: Integer, lifetime: Integer, monthly: Integer}) }
         def to_hash; end
       end
@@ -140,8 +155,17 @@ module Lithic
         attr_writer :monthly
 
         sig { params(daily: Integer, lifetime: Integer, monthly: Integer).returns(T.attached_class) }
-        def self.new(daily: nil, lifetime: nil, monthly: nil); end
-
+        def self.new(
+          # Current daily spend velocity (in cents) on the Account. Present if daily spend
+          # limit is set.
+          daily: nil,
+          # Current lifetime spend velocity (in cents) on the Account. Present if lifetime
+          # spend limit is set.
+          lifetime: nil,
+          # Current monthly spend velocity (in cents) on the Account. Present if monthly
+          # spend limit is set.
+          monthly: nil
+        ); end
         sig { override.returns({daily: Integer, lifetime: Integer, monthly: Integer}) }
         def to_hash; end
       end

data/rbi/lib/lithic/models/account_update_params.rbi

@@ -69,10 +69,26 @@ module Lithic
           .returns(T.attached_class)
       end
       def self.new(
+        # Amount (in cents) for the account's daily spend limit (e.g. 100000 would be a
+        # $1,000 limit). By default the daily spend limit is set to $1,250.
         daily_spend_limit: nil,
+        # Amount (in cents) for the account's lifetime spend limit (e.g. 100000 would be a
+        # $1,000 limit). Once this limit is reached, no transactions will be accepted on
+        # any card created for this account until the limit is updated. Note that a spend
+        # limit of 0 is effectively no limit, and should only be used to reset or remove a
+        # prior limit. Only a limit of 1 or above will result in declined transactions due
+        # to checks against the account limit. This behavior differs from the daily spend
+        # limit and the monthly spend limit.
         lifetime_spend_limit: nil,
+        # Amount (in cents) for the account's monthly spend limit (e.g. 100000 would be a
+        # $1,000 limit). By default the monthly spend limit is set to $5,000.
         monthly_spend_limit: nil,
+        # Account states.
         state: nil,
+        # Address used during Address Verification Service (AVS) checks during
+        # transactions if enabled via Auth Rules. This field is deprecated as AVS checks
+        # are no longer supported by Authorization Rules. The field will be removed from
+        # the schema in a future release.
         verification_address: nil,
         request_options: {}
       ); end

data/rbi/lib/lithic/models/address.rbi

@@ -46,8 +46,25 @@ module Lithic
         )
           .returns(T.attached_class)
       end
-      def self.new(address1:, city:, country:, postal_code:, state:, address2: nil); end
-
+      def self.new(
+        # Valid deliverable address (no PO boxes).
+        address1:,
+        # Name of city.
+        city:,
+        # Valid country code, entered in uppercase ISO 3166-1 alpha-3 three-character
+        # format. Only USA is currently supported for all workflows. KYC_EXEMPT supports
+        # CAN additionally.
+        country:,
+        # Valid postal code. USA postal codes (ZIP codes) are supported, entered as a
+        # five-digit postal code or nine-digit postal code (ZIP+4) using the format
+        # 12345-1234. KYC_EXEMPT supports Canadian postal codes.
+        postal_code:,
+        # Valid state code. USA state codes are supported, entered in uppercase ISO 3166-2
+        # two-character format. KYC_EXEMPT supports Canadian province codes.
+        state:,
+        # Unit or apartment number (if applicable).
+        address2: nil
+      ); end
       sig do
         override
           .returns(

data/rbi/lib/lithic/models/address_update.rbi

@@ -59,8 +59,23 @@ module Lithic
         )
           .returns(T.attached_class)
       end
-      def self.new(address1: nil, address2: nil, city: nil, country: nil, postal_code: nil, state: nil); end
-
+      def self.new(
+        # Valid deliverable address (no PO boxes).
+        address1: nil,
+        # Unit or apartment number (if applicable).
+        address2: nil,
+        # Name of city.
+        city: nil,
+        # Valid country code. Only USA is currently supported, entered in uppercase ISO
+        # 3166-1 alpha-3 three-character format.
+        country: nil,
+        # Valid postal code. Only USA ZIP codes are currently supported, entered as a
+        # five-digit ZIP or nine-digit ZIP+4.
+        postal_code: nil,
+        # Valid state code. Only USA state codes are currently supported, entered in
+        # uppercase ISO 3166-2 two-character format.
+        state: nil
+      ); end
       sig do
         override
           .returns(