starkinfra 0.1.0 → 0.3.0

data/lib/individualdocument/log.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+require_relative('../utils/rest')
+require_relative('../utils/checks')
+require_relative('IndividualDocument')
+require_relative('../utils/resource')
+
+module StarkInfra
+  class IndividualDocument
+    # # IndividualDocument::Log object
+    #
+    # Every time an IndividualDocument entity is updated, a corresponding IndividualDocument::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 IndividualDocument.
+    #
+    # ## Attributes (return-only):
+    # - id [string]: unique id returned when the log is created. ex: '5656565656565656'
+    # - document [IndividualDocument]: IndividualDocument entity to which the log refers to.
+    # - errors [list of strings]: list of errors linked to this IndividualDocument event
+    # - type [string]: type of the IndividualDocument event which triggered the log creation. ex: 'approved', 'canceled', 'confirmed', 'denied', 'reversed', 'voided'.
+    # - created [DateTime]: creation datetime for the log. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+    class Log < StarkInfra::Utils::Resource
+      attr_reader :id, :document, :errors, :type, :created
+      def initialize(id: nil, document: nil, errors: nil, type: nil, created: nil)
+        super(id)
+        @document = document
+        @errors = errors
+        @type = type
+        @created = StarkInfra::Utils::Checks.check_datetime(created)
+      end
+
+      # # Retrieve a specific IndividualDocument::Log
+      #
+      # Receive a single IndividualDocument::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:
+      # - IndividualDocument::Log object with updated attributes
+      def self.get(id, user: nil)
+        StarkInfra::Utils::Rest.get_id(id: id, user: user, **resource)
+      end
+
+      # # Retrieve IndividualDocument::Logs
+      #
+      # Receive a generator of IndividualDocument::Log 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
+      # - 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: ['created', 'canceled', 'processing', 'failed', 'success']
+      # - document_ids [list of strings, default nil]: list of IndividualDocument 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 IndividualDocument::Log objects with updated attributes
+      def self.query(ids: nil, limit: nil, after: nil, before: nil, types: nil, document_ids: nil, user: nil)
+        after = StarkInfra::Utils::Checks.check_date(after)
+        before = StarkInfra::Utils::Checks.check_date(before)
+        StarkInfra::Utils::Rest.get_stream(
+          ids: ids,
+          limit: limit,
+          after: after,
+          before: before,
+          types: types,
+          document_ids: document_ids,
+          user: user,
+          **resource
+        )
+      end
+
+      # # Retrieve paged IndividualDocument::Logs
+      #
+      # Receive a list of up to 100 IndividualDocument::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 documents.
+      #
+      # ## Parameters (optional):
+      # - cursor [string, default nil]: cursor returned on the previous page function call
+      # - limit [integer, default 100]: 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: ['created', 'canceled', 'processing', 'failed', 'success']
+      # - document_ids [list of strings, default nil]: list of document 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 IndividualDocument::Log objects with updated attributes
+      # - cursor to retrieve the next page of Log objects
+      def self.page(cursor: nil, ids: nil, limit: nil, after: nil, before: nil, types: nil, document_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,
+          document_ids: document_ids,
+          user: user,
+          **resource
+        )
+      end
+
+      def self.resource
+        request_maker = StarkInfra::IndividualDocument.resource[:resource_maker]
+        {
+          resource_name: 'IndividualDocumentLog',
+          resource_maker: proc { |json|
+            Log.new(
+              id: json['id'],
+              document: StarkInfra::Utils::API.from_api_json(request_maker, json['document']),
+              errors: json['errors'],
+              type: json['type'],
+              created: json['created']
+            )
+          }
+        }
+      end
+    end
+  end
+end

data/lib/individualidentity/individualidentity.rb

@@ -0,0 +1,193 @@
+# frozen_string_literal: true
+
+require_relative('../utils/rest')
+require_relative('../utils/parse')
+require_relative('../utils/checks')
+require_relative('../utils/resource')
+
+module StarkInfra
+  # # IndividualIdentity object
+  #
+  # An IndividualDocument represents an individual to be validated. It can have several individual documents attached
+  # to it, which are used to validate the identity of the individual. Once an individual identity is created, individual
+  # documents must be attached to it using the created method of the individual document resource. When all the required
+  # individual documents are attached to an individual identity it can be sent to validation by patching its status to 
+  # processing.
+  #
+  # When you initialize a IndividualIdentity, the entity will not be automatically
+  # created in the Stark Infra API. The 'create' function sends the objects
+  # to the Stark Infra API and returns the list of created objects.
+  #
+  # ## Parameters (required):
+  # - name [string]: individual's full name. ex: "Edward Stark".
+  # - tax_id [string]: individual's tax ID (CPF). ex: "594.739.480-42"
+  #
+  # ## Parameters (optional):
+  # - tags [list of strings, default nil]: list of strings for reference when searching for IndividualIdentities. ex: ["employees", "monthly"]
+  #
+  # ## Attributes (return-only):
+  # - id [string]: unique id returned when the IndividualIdentity is created. ex: "5656565656565656"
+  # - status [string]: current status of the IndividualIdentity. Options: "created", "canceled", "processing", "failed", "success"
+  # - created [DateTime]: creation datetime for the IndividualIdentity. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  class IndividualIdentity < StarkInfra::Utils::Resource
+    attr_reader :name, :tax_id, :tags, :id, :status, :created
+    def initialize(name:, tax_id:, tags: nil, id: nil, status: nil, created: nil)
+      super(id)
+      @name = name
+      @tax_id = tax_id
+      @tags = tags
+      @status = status
+      @created = StarkInfra::Utils::Checks.check_datetime(created)
+    end
+
+    # # Create IndividualIdentities
+    #
+    # Send a list of IndividualIdentity objects for creation at the Stark Infra API
+    #
+    # ## Parameters (required):
+    # - identities [list of IndividualIdentity objects]: list of IndividualIdentity 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 IndividualIdentity objects with updated attributes
+    def self.create(identities, user: nil)
+      StarkInfra::Utils::Rest.post(entities: identities, user: user, **resource)
+    end
+
+    # # Retrieve a specific IndividualIdentity
+    #
+    # Receive a single IndividualIdentity object previously created in the Stark Infra API by 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:
+    # - IndividualIdentity object with updated attributes
+    def self.get(uuid, user: nil)
+      StarkInfra::Utils::Rest.get_id(id: uuid, user: user, **resource)
+    end
+
+    # # Retrieve IndividualIdentities
+    #
+    # Receive a generator of IndividualIdentity 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
+    # - 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: ["created", "canceled", "processing", "failed", "success"]
+    # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. 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 IndividualIdentity objects with updated attributes
+    def self.query(limit: nil, after: nil, before: nil, status: nil, tags: nil, 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,
+        status: status,
+        tags: tags,
+        ids: ids,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Retrieve paged IndividualIdentities
+    #
+    # Receive a list of up to 100 IndividualIdentity 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 requests.
+    #
+    # ## Parameters (optional):
+    # - cursor [string, default nil]: cursor returned on the previous page function call
+    # - limit [integer, default 100]: 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)
+    # - status [list of strings, default nil]: filter for status of retrieved objects. ex: ["created", "canceled", "processing", "failed", "success"]
+    # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. 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 IndividualIdentity objects with updated attributes
+    # - cursor to retrieve the next page of IndividualIdentity objects
+    def self.page(cursor: nil, limit: nil, after: nil, before: nil, status: nil, tags: nil, 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,
+        status: status,
+        tags: tags,
+        ids: ids,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Update IndividualIdentity entity
+    #
+    # Update an IndividualIdentity by passing id.
+    #
+    # ## Parameters (required):
+    # - id [string]: IndividualIdentity unique id. ex: '5656565656565656'
+    # - status [string]: You may send IndividualDocuments to validation by passing 'processing' in the status
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkinfra.user was set before function call
+    #
+    # ## Return:
+    # - target IndividualIdentity with updated attributes
+    def self.update(id, status:, user: nil)
+      StarkInfra::Utils::Rest.patch_id(
+        id: id,
+        status: status,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Cancel an IndividualIdentity entity
+    #
+    # Cancel an IndividualIdentity entity previously created in the Stark Infra API
+    #
+    # ## Parameters (required):
+    # - id [string]: IndividualIdentity 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 IndividualIdentity object
+    def self.cancel(id, user: nil)
+      StarkInfra::Utils::Rest.delete_id(id: id, user: user, **resource)
+    end
+
+    def self.resource
+      {
+        resource_name: 'IndividualIdentity',
+        resource_maker: proc { |json|
+          IndividualIdentity.new(
+            name: json['name'],
+            tax_id: json['tax_id'],
+            tags: json['tags'],
+            id: json['id'],
+            status: json['status'],
+            created: json['created']
+          )
+        }
+      }
+    end
+  end
+end

data/lib/individualidentity/log.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+require_relative('../utils/rest')
+require_relative('../utils/checks')
+require_relative('IndividualIdentity')
+require_relative('../utils/resource')
+
+module StarkInfra
+  class IndividualIdentity
+    # # IndividualIdentity::Log object
+    #
+    # Every time an IndividualIdentity entity is updated, a corresponding IndividualIdentity::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 IndividualIdentity.
+    #
+    # ## Attributes (return-only):
+    # - id [string]: unique id returned when the log is created. ex: '5656565656565656'
+    # - identity [IndividualIdentity]: IndividualIdentity entity to which the log refers to.
+    # - errors [list of strings]: list of errors linked to this IndividualIdentity event
+    # - type [string]: type of the IndividualIdentity event which triggered the log creation. ex: "created", "canceled", "processing", "failed", "success"
+    # - created [DateTime]: creation datetime for the log. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+    class Log < StarkInfra::Utils::Resource
+      attr_reader :id, :identity, :errors, :type, :created
+      def initialize(id: nil, identity: nil, errors: nil, type: nil, created: nil)
+        super(id)
+        @identity = identity
+        @errors = errors
+        @type = type
+        @created = StarkInfra::Utils::Checks.check_datetime(created)
+      end
+
+      # # Retrieve a specific IndividualIdentity::Log
+      #
+      # Receive a single IndividualIdentity::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:
+      # - IndividualIdentity::Log object with updated attributes
+      def self.get(id, user: nil)
+        StarkInfra::Utils::Rest.get_id(id: id, user: user, **resource)
+      end
+
+      # # Retrieve IndividualIdentity::Logs
+      #
+      # Receive a generator of IndividualIdentity::Log 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
+      # - 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: "created", "canceled", "processing", "failed", "success"
+      # - identity_ids [list of strings, default nil]: list of identity 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 IndividualIdentity::Log objects with updated attributes
+      def self.query(limit: nil, after: nil, before: nil, types: nil, identity_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,
+          identity_ids: identity_ids,
+          user: user,
+          **resource
+        )
+      end
+
+      # # Retrieve paged IndividualIdentity::Logs
+      #
+      # Receive a list of up to 100 IndividualIdentity::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 identities.
+      #
+      # ## Parameters (optional):
+      # - cursor [string, default nil]: cursor returned on the previous page function call
+      # - limit [integer, default 100]: 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: "created", "canceled", "processing", "failed", "success"
+      # - identity_ids [list of strings, default nil]: list of identity 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 IndividualIdentity::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, identity_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,
+          identity_ids: identity_ids,
+          user: user,
+          **resource
+        )
+      end
+
+      def self.resource
+        request_maker = StarkInfra::IndividualIdentity.resource[:resource_maker]
+        {
+          resource_name: 'IndividualIdentityLog',
+          resource_maker: proc { |json|
+            Log.new(
+              id: json['id'],
+              identity: StarkInfra::Utils::API.from_api_json(request_maker, json['identity']),
+              errors: json['errors'],
+              type: json['type'],
+              created: json['created']
+            )
+          }
+        }
+      end
+    end
+  end
+end

data/lib/issuingbalance/issuingbalance.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
-require_relative('../utils/resource')
 require_relative('../utils/rest')
 require_relative('../utils/checks')
+require_relative('../utils/resource')
 
 module StarkInfra
   # # IssuingBalance object
@@ -13,7 +13,7 @@ module StarkInfra
   #
   # ## Attributes (return-only):
   # - id [string]: unique id returned when IssuingBalance is created. ex: '5656565656565656'
-  # - amount [integer]: current balance amount of the Workspace in cents. ex: 200 (= R$ 2.00)
+  # - amount [integer]: current issuing balance amount of the Workspace in cents. ex: 200 (= R$ 2.00)
   # - currency [string]: currency of the current Workspace. Expect others to be added eventually. ex: 'BRL'
   # - updated [DateTime]: latest update datetime for the IssuingBalance. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   class IssuingBalance < StarkInfra::Utils::Resource
@@ -43,10 +43,10 @@ module StarkInfra
         resource_name: 'IssuingBalance',
         resource_maker: proc { |json|
           IssuingBalance.new(
+            id: json['id'],
             amount: json['amount'],
             currency: json['currency'],
-            updated: json['updated'],
-            id: json['id']
+            updated: json['updated']
           )
         }
       }

data/lib/issuingcard/issuingcard.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
-require_relative('../utils/resource')
 require_relative('../utils/rest')
 require_relative('../utils/checks')
+require_relative('../utils/resource')
 
 module StarkInfra
   # # IssuingCard object
@@ -17,9 +17,9 @@ module StarkInfra
   #
   # ## Parameters (optional):
   # - display_name [string, default nil]: card displayed name. ex: 'ANTHONY STARK'
-  # - rules [list of IssuingRule objects, default []]: [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 []]: list of strings for tagging. ex: ['travel', 'food']
+  # - rules [list of IssuingRule objects, default nil]: [EXPANDABLE] list of card spending rules.
+  # - product_id [string, default nil]: card product 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 sub-issuer street line 1]: card holder main address. ex: 'Av. Paulista, 200'
   # - street_line_2 [string, default sub-issuer street line 2]: card holder address complement. ex: 'Apto. 123'
   # - district [string, default sub-issuer district]: card holder address district / neighbourhood. ex: 'Bela Vista'
@@ -38,32 +38,31 @@ module StarkInfra
   # - 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
+    attr_reader :id, :holder_name, :holder_tax_id, :holder_external_id, :display_name, :rules, :product_id, :tags,
+                :street_line_1, :street_line_2, :district, :city, :state_code, :zip_code, :holder_id,
+                :type, :status, :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
+      holder_name: , holder_tax_id: , holder_external_id: , display_name: nil, rules: nil, product_id: nil, tags: nil,
+      street_line_1: nil, street_line_2: nil, district: nil, city: nil, state_code: nil, zip_code: nil, id: nil,
+      holder_id: nil, type: nil, status: 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
+      @product_id = product_id
+      @tags = tags
       @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
+      @holder_id = holder_id
+      @type = type
+      @status = status
       @number = number
       @security_code = security_code
       expiration = nil if !expiration.nil? && expiration.include?('*')
@@ -111,14 +110,14 @@ module StarkInfra
     #
     # ## 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)
+    # - 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', 'expired']
     # - types [list of strings, default nil]: card type. ex: ['virtual']
-    # - holder_ids [list of strings]: card holder IDs. ex: ['5656565656565656', '4545454545454545']
+    # - holder_ids [list of strings, default nil]: 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']
+    # - expand [list of strings, default nil]: fields to expand information. ex: ['rules', 'security_code', 'number', 'expiration']
+    # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
     # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
     #
     # ## Return:
@@ -144,23 +143,24 @@ module StarkInfra
 
     # # Retrieve paged IssuingCards
     #
-    # Receive a list of IssuingCards objects previously created in the Stark Infra API and the cursor to the next page.
+    # Receive a list of up to 100 IssuingCard 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 identities.
     #
     # ## Parameters (optional):
     # - cursor [string, default nil]: cursor returned on the previous page function call.
     # - limit [integer, default 100]: maximum number of objects to be retrieved. Max = 100. 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)
+    # - 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', 'expired']
     # - types [list of strings, default nil]: card type. ex: ['virtual']
-    # - holder_ids [list of strings]: card holder IDs. ex: ['5656565656565656', '4545454545454545']
+    # - holder_ids [list of strings, default nil]: 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']
+    # - expand [list of strings, default nil]: 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
+    # - list of IssuingCard 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)
@@ -191,6 +191,7 @@ module StarkInfra
     #
     # ## Parameters (optional):
     # - status [string, default nil]: You may block the IssuingCard by passing 'blocked' or activate by passing 'active' in the status
+    # - pin [string, default nil]: You may unlock your physical card by passing its PIN. This is also the PIN you use to authorize a purhcase.
     # - 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
@@ -198,10 +199,11 @@ module StarkInfra
     #
     # ## Return:
     # - target IssuingCard with updated attributes
-    def self.update(id, status: nil, display_name: nil, rules: nil, tags: nil, user: nil)
+    def self.update(id, status: nil, display_name: nil, pin: nil, rules: nil, tags: nil, user: nil)
       StarkInfra::Utils::Rest.patch_id(
         id: id,
         status: status,
+        pin: pin,
         display_name: display_name,
         rules: rules,
         tags: tags,
@@ -232,22 +234,22 @@ module StarkInfra
         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'],
+            product_id: json['product_id'],
+            tags: json['tags'],
             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'],
+            holder_id: json['holder_id'],
+            type: json['type'],
+            status: json['status'],
             number: json['number'],
             security_code: json['security_code'],
             expiration: json['expiration'],