starkinfra 0.0.2 → 0.0.3

data/lib/issuingbin/issuingbin.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require_relative('../utils/resource')
+require_relative('../utils/rest')
+require_relative('../utils/checks')
+
+module StarkInfra
+  # # IssuingBin object
+  #
+  # The IssuingBin object displays information of registered BINs to your Workspace.
+  # They represent a group of cards that begin with the same numbers (BIN) and offer the same product to end customers.
+  #
+  # ## Attributes (return-only):
+  # - id [string]: unique BIN number registered within the card network. ex: '53810200'
+  # - network [string]: card network flag. ex: 'mastercard'
+  # - settlement [string]: settlement type. ex: 'credit'
+  # - category [string]: purchase category. ex: 'prepaid'
+  # - client [string]: client type. ex: 'business'
+  # - created [DateTime]: creation datetime for the IssuingBin. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - updated [DateTime]: latest update datetime for the IssuingBin. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  class IssuingBin < StarkInfra::Utils::Resource
+    attr_reader :id, :network, :settlement, :category, :client, :updated, :created
+    def initialize(id: nil, network: nil, settlement: nil, category: nil, client: nil, updated: nil, created: nil)
+      super(id)
+      @network = network
+      @settlement = settlement
+      @category = category
+      @client = client
+      @updated = StarkInfra::Utils::Checks.check_datetime(updated)
+      @created = StarkInfra::Utils::Checks.check_datetime(created)
+    end
+
+    # # Retrieve the IssuingBin object
+    #
+    # Receive a generator of IssuingBin objects previously registered in the Stark Infra API
+    #
+    # ## Parameters (optional):
+    # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - generator of IssuingBin objects with updated attributes
+    def self.query(limit: nil, user: nil)
+      StarkInfra::Utils::Rest.get_stream(
+        limit: limit,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Retrieve paged IssuingBins
+    #
+    # Receive a list of up to 100 IssuingBin objects previously registered in the Stark Infra API and the cursor to the next page.
+    #
+    # ## Parameters (optional):
+    # - cursor [string, default nil]: cursor returned on the previous page function call.
+    # - limit [integer, default nil]: maximum number of objects to be retrieved. Max = 100. ex: 35
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - list of IssuingBin objects with updated attributes
+    # - cursor to retrieve the next page of IssuingBin objects
+    def self.page(cursor: nil, limit: nil, user: nil)
+      StarkInfra::Utils::Rest.get_page(
+        cursor: cursor,
+        limit: limit,
+        user: user,
+        **resource
+      )
+    end
+
+    def self.resource
+      {
+        resource_name: 'IssuingBin',
+        resource_maker: proc { |json|
+          IssuingBin.new(
+            id: json['id'],
+            network: json['network'],
+            settlement: json['settlement'],
+            category: json['category'],
+            client: json['client'],
+            updated: json['updated'],
+            created: json['created']
+          )
+        }
+      }
+    end
+  end
+end

data/lib/issuingcard/issuingcard.rb

@@ -0,0 +1,260 @@
+# frozen_string_literal: true
+
+require_relative('../utils/resource')
+require_relative('../utils/rest')
+require_relative('../utils/checks')
+
+module StarkInfra
+  # # IssuingCard object
+  #
+  # The IssuingCard object displays the information of the cards created in your Workspace.
+  # Sensitive information will only be returned when the 'expand' parameter is used, to avoid security concerns.
+  #
+  # ## Parameters (required):
+  # - holder_name [string]: card holder name. ex: 'Tony Stark'
+  # - holder_tax_id [string]: card holder tax ID. ex: '012.345.678-90'
+  # - holder_external_id [string] card holder unique id, generated by the user to avoid duplicated holders. ex: 'my-entity/123'
+  #
+  # ## Parameters (optional):
+  # - display_name [string, default nil]: card displayed name. ex: 'ANTHONY STARK'
+  # - rules [list of IssuingRule objects, default nil]: [EXPANDABLE] list of card spending rules.
+  # - bin_id [string, default nil]: BIN ID to which the card is bound. ex: '53810200'
+  # - tags [list of strings, default nil]: list of strings for tagging. ex: ['travel', 'food']
+  # - street_line_1 [string, default nil]: card holder main address. ex: 'Av. Paulista, 200'
+  # - street_line_2 [string, default nil]: card holder address complement. ex: 'Apto. 123'
+  # - district [string, default nil]: card holder address district / neighbourhood. ex: 'Bela Vista'
+  # - city [string, default nil]: card holder address city. ex: 'Rio de Janeiro'
+  # - state_code [string, default nil]: card holder address state. ex: 'GO'
+  # - zip_code [string, default nil]: card holder address zip code. ex: '01311-200'
+  #
+  # ## Attributes (return-only):
+  # - id [string]: unique id returned when IssuingCard is created. ex: '5656565656565656'
+  # - holder_id [string]: card holder unique id. ex: '5656565656565656'
+  # - type [string]: card type. ex: 'virtual'
+  # - status [string]: current IssuingCard status. ex: 'active', 'blocked', 'canceled', 'expired'.
+  # - number [string]: [EXPANDABLE] masked card number. Expand to unmask the value. ex: '123'.
+  # - security_code [string]: [EXPANDABLE] masked card verification value (cvv). Expand to unmask the value. ex: '123'.
+  # - expiration [string]: [EXPANDABLE] masked card expiration datetime. Expand to unmask the value. ex: '2032-02-29T23:59:59.999999+00:00'.
+  # - created [DateTime]: creation datetime for the IssuingCard. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - updated [DateTime]: latest update datetime for the IssuingCard. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  class IssuingCard < StarkInfra::Utils::Resource
+    attr_reader :id, :holder_id, :holder_name, :holder_tax_id, :holder_external_id, :type, :display_name, :status,
+      :rules, :bin_id, :street_line_1, :street_line_2, :district, :city, :state_code, :zip_code, :tags, :number,
+      :security_code, :expiration, :created, :updated
+    def initialize(
+      holder_name:, holder_tax_id:, holder_external_id:, id: nil, holder_id: nil, type: nil,
+      display_name: nil, status: nil, rules: nil, bin_id: nil, street_line_1: nil, street_line_2: nil, district: nil,
+      city: nil, state_code: nil, zip_code: nil, tags: nil, number: nil, security_code: nil, expiration: nil,
+      created: nil, updated: nil
+    )
+      super(id)
+      @holder_name = holder_name
+      @holder_tax_id = holder_tax_id
+      @holder_external_id = holder_external_id
+      @holder_id = holder_id
+      @type = type
+      @display_name = display_name
+      @status = status
+      @rules = StarkInfra::IssuingRule.parse_rules(rules)
+      @bin_id = bin_id
+      @street_line_1 = street_line_1
+      @street_line_2 = street_line_2
+      @district = district
+      @city = city
+      @state_code = state_code
+      @zip_code = zip_code
+      @tags = tags
+      @number = number
+      @security_code = security_code
+      @expiration = expiration
+      @created = StarkInfra::Utils::Checks.check_datetime(created)
+      @updated = StarkInfra::Utils::Checks.check_datetime(updated)
+    end
+
+    # # Create IssuingCards
+    #
+    # Send a list of IssuingCard objects for creation in the Stark Infra API
+    #
+    # ## Parameters (required):
+    # - cards [list of IssuingCard objects]: list of IssuingCard objects to be created in the API
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - list of IssuingCard objects with updated attributes
+    def self.create(cards:, expand: nil, user: nil)
+      StarkInfra::Utils::Rest.post(entities: cards, expand: expand, user: user, **resource)
+    end
+
+    # # Retrieve a specific IssuingCard
+    #
+    # Receive a single IssuingCard object previously created in the Stark Infra API by its id
+    #
+    # ## Parameters (required):
+    # - id [string]: object unique id. ex: '5656565656565656'
+    #
+    # ## Parameters (optional):
+    # - expand [list of strings, default nil]: fields to expand information. ex: ['rules', 'securityCode', 'number', 'expiration']
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - IssuingCard object with updated attributes
+    def self.get(id, expand: nil, user: nil)
+      StarkInfra::Utils::Rest.get_id(id: id, expand: expand, user: user, **resource)
+    end
+
+    # # Retrieve IssuingCards
+    #
+    # Receive a generator of IssuingCards objects previously created in the Stark Infra API
+    #
+    # ## Parameters (optional):
+    # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+    # - after [DateTime or string, default nil] date filter for objects created only after specified date. ex: DateTime.new(2020, 3, 10)
+    # - before [DateTime or string, default nil] date filter for objects created only before specified date. ex: DateTime.new(2020, 3, 10)
+    # - status [list of strings, default nil]: filter for status of retrieved objects. ex: ['active', 'blocked', 'canceled', 'expired']
+    # - types [list of strings, default nil]: card type. ex: ['virtual']
+    # - holder_ids [list of strings]: card holder IDs. ex: ['5656565656565656', '4545454545454545']
+    # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
+    # - expand [list of strings, default []]: fields to expand information. ex: ['rules', 'security_code', 'number', 'expiration']
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - generator of IssuingCards objects with updated attributes
+    def self.query(limit: nil, ids: nil, after: nil, before: nil, status: nil, types: nil, holder_ids: nil, tags: nil,
+                   expand: nil, user: nil)
+      after = StarkInfra::Utils::Checks.check_date(after)
+      before = StarkInfra::Utils::Checks.check_date(before)
+      StarkInfra::Utils::Rest.get_stream(
+        limit: limit,
+        ids: ids,
+        after: after,
+        before: before,
+        status: status,
+        types: types,
+        holder_ids: holder_ids,
+        tags: tags,
+        expand: expand,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Retrieve paged IssuingCards
+    #
+    # Receive a list of IssuingCards objects previously created in the Stark Infra API and the cursor to the next page.
+    #
+    # ## Parameters (optional):
+    # - cursor [string, default nil]: cursor returned on the previous page function call.
+    # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+    # - after [DateTime or string, default nil] date filter for objects created only after specified date. ex: DateTime.new(2020, 3, 10)
+    # - before [DateTime or string, default nil] date filter for objects created only before specified date. ex: DateTime.new(2020, 3, 10)
+    # - status [list of strings, default nil]: filter for status of retrieved objects. ex: ['active', 'blocked', 'canceled', 'expired']
+    # - types [list of strings, default nil]: card type. ex: ['virtual']
+    # - holder_ids [list of strings]: card holder IDs. ex: ['5656565656565656', '4545454545454545']
+    # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
+    # - expand [list of strings, default []]: fields to expand information. ex: ['rules', 'security_code', 'number', 'expiration']
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - list of IssuingCards objects with updated attributes
+    # - cursor to retrieve the next page of IssuingCards objects
+    def self.page(cursor: nil, limit: nil, ids: nil, after: nil, before: nil, status: nil, types: nil, holder_ids: nil,
+                  tags: nil, expand: nil, user: nil)
+      after = StarkInfra::Utils::Checks.check_date(after)
+      before = StarkInfra::Utils::Checks.check_date(before)
+      StarkInfra::Utils::Rest.get_page(
+        cursor: cursor,
+        limit: limit,
+        ids: ids,
+        after: after,
+        before: before,
+        status: status,
+        types: types,
+        holder_ids: holder_ids,
+        tags: tags,
+        expand: expand,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Update IssuingCard entity
+    #
+    # Update an IssuingCard by passing id.
+    #
+    # ## Parameters (required):
+    # - id [string]: IssuingCard unique id. ex: '5656565656565656'
+    #
+    # ## Parameters (optional):
+    # - status [string, default nil]: You may block the IssuingCard by passing 'blocked' or activate by passing 'active' in the status
+    # - display_name [string, default nil]: card displayed name
+    # - rules [list of IssuingRule objects, default nil]: [EXPANDABLE] list of card spending rules.
+    # - tags [list of strings, default nil]: list of strings for tagging
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
+    #
+    # ## Return:
+    # - target IssuingCard with updated attributes
+    def self.update(id, status: nil, display_name: nil, rules: nil, tags: nil, user: nil)
+      StarkInfra::Utils::Rest.patch_id(
+        id: id,
+        status: status,
+        display_name: display_name,
+        rules: rules,
+        tags: tags,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Cancel an IssuingCard entity
+    #
+    # Cancel an IssuingCard entity previously created in the Stark Infra API
+    #
+    # ## Parameters (required):
+    # - id [string]: IssuingCard unique id. ex: '5656565656565656'
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - canceled IssuingCard object
+    def self.cancel(id, user: nil)
+      StarkInfra::Utils::Rest.delete_id(id: id, user: user, **resource)
+    end
+
+    def self.resource
+      {
+        resource_name: 'IssuingCard',
+        resource_maker: proc { |json|
+          IssuingCard.new(
+            id: json['id'],
+            holder_id: json['holder_id'],
+            holder_name: json['holder_name'],
+            holder_tax_id: json['holder_tax_id'],
+            holder_external_id: json['holder_external_id'],
+            type: json['type'],
+            display_name: json['display_name'],
+            status: json['status'],
+            rules: json['rules'],
+            bin_id: json['bin_id'],
+            street_line_1: json['street_line_1'],
+            street_line_2: json['street_line_2'],
+            district: json['district'],
+            city: json['city'],
+            state_code: json['state_code'],
+            zip_code: json['zip_code'],
+            tags: json['tags'],
+            number: json['number'],
+            security_code: json['security_code'],
+            expiration: json['expiration'],
+            created: json['created'],
+            updated: json['updated']
+          )
+        }
+      }
+    end
+  end
+end

data/lib/issuingcard/log.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+require_relative('../utils/resource')
+require_relative('../utils/rest')
+require_relative('../utils/checks')
+require_relative('issuingcard')
+
+module StarkInfra
+  class IssuingCard
+    # # IssuingCard::Log object
+    #
+    # Every time an IssuingCard entity is updated, a corresponding issuing card.Log is generated for the entity. This log
+    # is never generated by the user, but it can be retrieved to check additional information on the IssuingCard.
+    #
+    # ## Attributes:
+    # - id [string]: unique id returned when the log is created. ex: '5656565656565656'
+    # - created [DateTime]: creation datetime for the log. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+    # - type [string]: type of the IssuingCard event which triggered the log creation. ex: 'processing' or 'success'
+    # - card [IssuingCard]: IssuingCard entity to which the log refers to.
+    class Log < StarkInfra::Utils::Resource
+      attr_reader :id, :created, :type, :card
+      def initialize(id:, created:, type:, card:)
+        super(id)
+        @type = type
+        @card = card
+        @created = StarkInfra::Utils::Checks.check_datetime(created)
+      end
+
+      # # Retrieve a specific Log
+      #
+      # Receive a single Log object previously created by the Stark Infra API by passing its id
+      #
+      # ## Parameters (required):
+      # - id [string]: object unique id. ex: '5656565656565656'
+      #
+      # ## Parameters (optional):
+      # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+      #
+      # ## Return:
+      # - Log object with updated attributes
+      def self.get(id, user: nil)
+        StarkInfra::Utils::Rest.get_id(id: id, user: user, **resource)
+      end
+
+      # # Retrieve Logs
+      #
+      # Receive a generator of Log objects previously created in the Stark Infra API
+      #
+      # ## Parameters (optional):
+      # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+      # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
+      # - after [Date or string, default nil] date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
+      # - before [Date or string, default nil] date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
+      # - types [list of strings, default nil]: filter for log event types. ex: ['blocked', 'canceled', 'created', 'expired', 'unblocked', 'updated']
+      # - card_ids [list of strings, default nil]: list of IssuingCard ids to filter logs. ex: ['5656565656565656', '4545454545454545']
+      # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
+      #
+      # ## Return:
+      # - generator of Log objects with updated attributes
+      def self.query(limit: nil, after: nil, before: nil, types: nil, card_ids: nil, user: nil)
+        after = StarkInfra::Utils::Checks.check_date(after)
+        before = StarkInfra::Utils::Checks.check_date(before)
+        StarkInfra::Utils::Rest.get_stream(
+          limit: limit,
+          after: after,
+          before: before,
+          types: types,
+          card_ids: card_ids,
+          user: user,
+          **resource
+        )
+      end
+
+      # # Retrieve paged Logs
+      #
+      # Receive a list of up to 100 Log objects previously created in the Stark Infra API and the cursor to the next page.
+      # Use this function instead of query if you want to manually page your logs.
+      #
+      # ## Parameters (optional):
+      # - cursor [string, default nil]: cursor returned on the previous page function call
+      # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+      # - limit [integer, default nil]: maximum number of objects to be retrieved. Max = 100. ex: 35
+      # - after [Date or string, default nil] date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
+      # - before [Date or string, default nil] date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
+      # - types [list of strings, default nil]: filter for log event types. ex: ['blocked', 'canceled', 'created', 'expired', 'unblocked', 'updated']
+      # - card_ids [list of strings, default nil]: list of IssuingCard ids to filter logs. ex: ['5656565656565656', '4545454545454545']
+      # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
+      #
+      # ## Return:
+      # - list of Log objects with updated attributes
+      # - Cursor to retrieve the next page of Log objects
+      def self.page(cursor: nil, limit: nil, after: nil, before: nil, types: nil, card_ids: nil, user: nil)
+        after = StarkInfra::Utils::Checks.check_date(after)
+        before = StarkInfra::Utils::Checks.check_date(before)
+        StarkInfra::Utils::Rest.get_page(
+          cursor: cursor,
+          limit: limit,
+          after: after,
+          before: before,
+          types: types,
+          card_ids: card_ids,
+          user: user,
+          **resource
+        )
+      end
+
+      def self.resource
+        request_maker = StarkInfra::IssuingCard.resource[:resource_maker]
+        {
+          resource_name: 'IssuingCardLog',
+          resource_maker: proc { |json|
+            Log.new(
+              id: json['id'],
+              created: json['created'],
+              type: json['type'],
+              card: StarkInfra::Utils::API.from_api_json(request_maker, json['card'])
+            )
+          }
+        }
+      end
+    end
+  end
+end

data/lib/issuingholder/issuingholder.rb

@@ -0,0 +1,206 @@
+# frozen_string_literal: true
+
+require_relative('../utils/resource')
+require_relative('../utils/rest')
+require_relative('../utils/checks')
+
+module StarkInfra
+  # # IssuingHolder object
+  #
+  # The IssuingHolder describes a card holder that may group several cards.
+  #
+  # ## Parameters (required):
+  # - name [string]: card holder name.
+  # - tax_id [string]: card holder tax ID
+  # - external_id [string] card holder external ID
+  #
+  # ## Parameters (optional):
+  # - rules [list of IssuingRule objects, default nil]: [EXPANDABLE] list of holder spending rules.
+  # - tags [list of strings, default []]: list of strings for tagging. ex: ['travel', 'food']
+  #
+  # ## Attributes (return-only):
+  # - id [string]: unique id returned when IssuingHolder is created. ex: '5656565656565656'
+  # - status [string]: current IssuingHolder status. ex: 'active', 'blocked', 'canceled'
+  # - updated [DateTime]: latest update datetime for the IssuingHolder. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - created [DateTime]: creation datetime for the log. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  class IssuingHolder < StarkInfra::Utils::Resource
+    attr_reader :id, :name, :tax_id, :external_id, :status, :rules, :tags, :updated, :created
+    def initialize(
+      name:, tax_id:, external_id:, id: nil, status: nil, rules: nil, tags: nil, updated: nil, created: nil
+    )
+      super(id)
+      @name = name
+      @tax_id = tax_id
+      @external_id = external_id
+      @status = status
+      @rules = StarkInfra::IssuingRule.parse_rules(rules)
+      @tags = tags
+      @created = StarkInfra::Utils::Checks.check_datetime(created)
+      @updated = StarkInfra::Utils::Checks.check_datetime(updated)
+    end
+
+    # # Create IssuingHolders
+    #
+    # Send a list of IssuingHolder objects for creation in the Stark Infra API
+    #
+    # ## Parameters (required):
+    # - holders [list of IssuingHolder objects]: list of IssuingHolder objects to be created in the API
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - list of IssuingHolder objects with updated attributes
+    def self.create(holders:, user: nil)
+      StarkInfra::Utils::Rest.post(entities: holders, user: user, **resource)
+    end
+
+    # # Retrieve a specific IssuingHolder
+    #
+    # Receive a single IssuingHolder object previously created in the Stark Infra API by its id
+    #
+    # ## Parameters (required):
+    # - id [string]: object unique id. ex: '5656565656565656'
+    #
+    # ## Parameters (optional):
+    # - expand [list of strings, default nil]: fields to expand information. ex: ['rules']
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
+    #
+    # ## Return:
+    # - IssuingHolder object with updated attributes
+    def self.get(id, expand: nil, user: nil)
+      StarkInfra::Utils::Rest.get_id(id: id, expand: expand, user: user, **resource)
+    end
+
+    # # Retrieve IssuingHolders
+    #
+    # Receive a generator of IssuingHolder objects previously created in the Stark Infra API
+    #
+    # ## Parameters (optional):
+    # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+    # - after [Date or string, default nil] date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
+    # - before [Date or string, default nil] date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
+    # - status [list of strings, default nil]: filter for status of retrieved objects. ex: ['active', 'blocked', 'canceled']
+    # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
+    # - expand [string, default nil]: fields to expand information. ex: ['rules']
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
+    #
+    # ## Return:
+    # - generator of IssuingHolders objects with updated attributes
+    def self.query(limit: nil, ids: nil, after: nil, before: nil, status: nil, tags: nil, expand: nil, user: nil)
+      after = StarkInfra::Utils::Checks.check_date(after)
+      before = StarkInfra::Utils::Checks.check_date(before)
+      StarkInfra::Utils::Rest.get_stream(
+        limit: limit,
+        ids: ids,
+        after: after,
+        before: before,
+        status: status,
+        tags: tags,
+        expand: expand,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Retrieve paged IssuingHolders
+    #
+    # Receive a list of IssuingHolder objects previously created in the Stark Infra API and the cursor to the next page.
+    #
+    # ## Parameters (optional):
+    # - cursor [string, default nil]: cursor returned on the previous page function call.
+    # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+    # - after [Date or string, default nil] date filter for objects created only after specified date. ex: Date.new(2020, 3, 10)
+    # - before [Date or string, default nil] date filter for objects created only before specified date. ex: Date.new(2020, 3, 10)
+    # - status [list of strings, default nil]: filter for status of retrieved objects. ex: ['active', 'blocked', 'canceled']
+    # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
+    # - expand [string, default nil]: fields to expand information. ex: ['rules']
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
+    #
+    # ## Return:
+    # - list of IssuingHolders objects with updated attributes
+    # - cursor to retrieve the next page of IssuingHolders objects
+    def self.page(cursor: nil, limit: nil, ids: nil, after: nil, before: nil, status: nil, tags: nil, expand: nil,
+                  user: nil)
+      after = StarkInfra::Utils::Checks.check_date(after)
+      before = StarkInfra::Utils::Checks.check_date(before)
+      StarkInfra::Utils::Rest.get_page(
+        cursor: cursor,
+        limit: limit,
+        ids: ids,
+        after: after,
+        before: before,
+        status: status,
+        tags: tags,
+        expand: expand,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Update IssuingHolder entity
+    #
+    # Update an IssuingHolder by passing id, if it hasn't been paid yet.
+    #
+    # ## Parameters (required):
+    # - id [string]: IssuingHolder id. ex: '5656565656565656'
+    #
+    # ## Parameters (optional):
+    # - status [string, default nil]: You may block the IssuingHolder by passing 'blocked' in the status
+    # - name [string, default nil]: card holder name.
+    # - tags [list of strings, default nil]: list of strings for tagging
+    # - rules [list of IssuingRule objects, default nil]: list of objects that represent the holder's spending rules.
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
+    #
+    # ## Return:
+    # - target IssuingHolder with updated attributes
+    def self.update(id, status: nil, name: nil, tags: nil, rules: nil, user: nil)
+      StarkInfra::Utils::Rest.patch_id(
+        id: id,
+        status: status,
+        name: name,
+        tags: tags,
+        rules: rules,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Cancel an IssuingHolder entity
+    #
+    # Cancel an IssuingHolder entity previously created in the Stark Infra API
+    #
+    # ## Parameters (required):
+    # - id [string]: IssuingHolder unique id. ex: '5656565656565656'
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
+    #
+    # ## Return:
+    # - canceled IssuingHolder object
+    def self.cancel(id, user: nil)
+      StarkInfra::Utils::Rest.delete_id(id: id, user: user, **resource)
+    end
+
+    def self.resource
+      {
+        resource_name: 'IssuingHolder',
+        resource_maker: proc { |json|
+          IssuingHolder.new(
+            id: json['id'],
+            name: json['name'],
+            tax_id: json['tax_id'],
+            external_id: json['external_id'],
+            status: json['status'],
+            rules: json['rules'],
+            tags: json['tags'],
+            updated: json['updated'],
+            created: json['created']
+          )
+        }
+      }
+    end
+  end
+end