starkbank 2.8.0 → 2.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a3493b760a1ff8ec3af45fbe6a7df82d3457f543c210857866db6b6d83ac393
-  data.tar.gz: 75a9e0260201fccd4fa39374bb671b8e93cc248e1e2d4b34d207ff5bdba66095
+  metadata.gz: 1b3c14df2e63024dc300445af57b93d5d7c03fbe7e40efc79f4b130684982118
+  data.tar.gz: 621f032aa81a0c42d8d8df9491d5c66dfa1938207a9f68920d0f4abe7356cdef
 SHA512:
-  metadata.gz: 4f238645203432793eb681b6e2292cbae27e75ba672ec08e157c5c5f2888924a3db0165d3be55154cd850091746f0c2e78d6fc9d667b619acc3b484708e9d975
-  data.tar.gz: 11e0dfc9d6568767f42b2b37641f822deb64b23c9845bdf1ab56f0c99f8b3a2c8c772dc6932490c4609f98b04feeb0332a8031d80e45c8d9de0b5d2fdf2d8fbd
+  metadata.gz: 8e8317904c404ed9a8051169e0079d705224bbea35cf7c735b3f164c955cf212494c76fb3fbfbc74f0f75b89c7b55194ffac31e0efde0b2002ddb886029930b6
+  data.tar.gz: 6f9c6037b10ae646945aa1163b5e64fb7ac70303767a12976a91ffa167bd8453dd7b0f7b32fece994bc6b976632ee67a5860c24a215135129ea4b535d354cdff

data/lib/card_method/cardmethod.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require('starkcore')
+require_relative('../utils/rest')
+
+module StarkBank
+  # # CardMethod object
+  #
+  # CardMethod's codes are used to define method filters in CorporateRules.
+  #
+  # ## Parameters (required):
+  # - code [string]: method's code. Options: 'chip', 'token', 'server', 'manual', 'magstripe', 'contactless'
+  #
+  # Attributes (return-only):
+  # - name [string]: method's name. ex: 'token'
+  # - number [string]: method's number. ex: '81'
+  class CardMethod < StarkCore::Utils::SubResource
+    attr_reader :code, :name, :number
+    def initialize(code:, name: nil, number: nil)
+      @code = code
+      @name = name
+      @number = number
+    end
+
+    # # Retrieve CardMethods
+    #
+    # Receive a generator of CardMethod objects available in the Stark Bank API
+    #
+    # ## Parameters (optional):
+    # - search [string, default nil]: keyword to search for code, name, number or short_code
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if starkbank.user was set before function call
+    #
+    # ## Return:
+    # - generator of CardMethod objects with updated attributes
+    def self.query(search: nil, user: nil)
+      StarkBank::Utils::Rest.get_stream(
+        search: search,
+        user: user,
+        **resource
+      )
+    end
+
+    def self.resource
+      {
+        resource_name: 'CardMethod',
+        resource_maker: proc { |json|
+          CardMethod.new(
+            code: json['code'],
+            name: json['name'],
+            number: json['number']
+          )
+        }
+      }
+    end
+  end
+end

data/lib/corporate_balance/corporatebalance.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require('starkcore')
+require_relative('../utils/rest')
+
+module StarkBank
+  # # CorporateBalance object
+  #
+  # The CorporateBalance object displays the current corporate balance of the Workspace, which is the result of the sum of
+  # all transactions within this Workspace. The balance is never generated by the user, but it can be retrieved to see
+  # the available information.
+  #
+  # ## Attributes (return-only):
+  # - id [string]: unique id returned when CorporateBalance is created. ex: '5656565656565656'
+  # - amount [integer]: current corporate balance amount of the Workspace in cents. ex: 200 (= R$ 2.00)
+  # - limit [integer]: the maximum negative balance allowed by the user. ex: 10000 (= R$ 100.00)
+  # - max_limit [integer]: the maximum negative balance allowed by StarkBank. ex: 100000 (= R$ 1000.00)
+  # - currency [string]: currency of the current Workspace. Expect others to be added eventually. ex: 'BRL'
+  # - updated [DateTime]: latest update datetime for the CorporateBalance. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  class CorporateBalance < StarkCore::Utils::Resource
+    attr_reader :amount, :limit, :max_limit, :currency, :updated, :id
+    def initialize(amount: nil, limit: nil, max_limit: nil, currency: nil, updated: nil, id: nil)
+      super(id)
+      @amount = amount
+      @limit = limit
+      @max_limit = max_limit
+      @currency = currency
+      @updated = StarkCore::Utils::Checks.check_datetime(updated)
+    end
+
+    # # Retrieve the CorporateBalance object
+    #
+    # Receive the CorporateBalance object linked to your Workspace in the Stark Infrq API
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkBank.user was set before function call
+    #
+    # ## Return:
+    # - CorporateBalance object with updated attributes
+    def self.get(user: nil)
+      StarkBank::Utils::Rest.get_stream(user: user, **resource).next
+    end
+
+    def self.resource
+      {
+        resource_name: 'CorporateBalance',
+        resource_maker: proc { |json|
+          CorporateBalance.new(
+            id: json['id'],
+            amount: json['amount'],
+            limit: json['limit'],
+            max_limit: json['max_limit'],
+            currency: json['currency'],
+            updated: json['updated']
+          )
+        }
+      }
+    end
+  end
+end

data/lib/corporate_card/corporatecard.rb

@@ -0,0 +1,259 @@
+# frozen_string_literal: true
+
+require('starkcore')
+require_relative('../utils/rest')
+
+module StarkBank
+  # # CorporateCard object
+  #
+  # The CorporateCard 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.
+  #
+  # When you initialize a CorporateCard, the entity will not be automatically
+  # created in the Stark Bank API. The 'create' function sends the objects
+  # to the Stark Bank API and returns the created object.
+  #
+  # ## Parameters (required):
+  # - holder_id [string]: card holder tax ID. ex: '012.345.678-90'
+  #
+  # ## Attributes (return-only):
+  # - id [string]: unique id returned when CorporateCard is created. ex: '5656565656565656'
+  # - holder_name [string, default nil]: card holder name. ex: 'Tony Stark'
+  # - display_name [string, default nil]: card displayed name. ex: 'ANTHONY STARK'
+  # - rules [list of CorporateRule objects, default nil]: [EXPANDABLE] list of card spending rules.
+  # - 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'
+  # - city [string, default sub-issuer city]: card holder address city. ex: 'Rio de Janeiro'
+  # - state_code [string, default sub-issuer state code]: card holder address state. ex: 'GO'
+  # - zip_code [string, default sub-issuer zip code]: card holder address zip code. ex: '01311-200'
+  # - type [string]: card type. ex: 'virtual'
+  # - status [string]: current CorporateCard 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 [DateTime]: [EXPANDABLE] masked card expiration datetime. Expand to unmask the value. ex: DateTime.new(2032, 3, 10, 10, 30, 0, 0)
+  # - created [DateTime]: creation datetime for the CorporateCard. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  # - updated [DateTime]: latest update datetime for the CorporateCard. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+  class CorporateCard < StarkCore::Utils::Resource
+    attr_reader :holder_id, :id, :holder_name, :display_name, :rules, :tags,
+                :street_line_1, :street_line_2, :district, :city, :state_code, :zip_code,
+                :type, :status, :number, :security_code, :expiration, :created, :updated
+    def initialize(
+      holder_id:, holder_name: nil, display_name: nil, rules: nil, tags: nil,
+      street_line_1: nil, street_line_2: nil, district: nil, city: nil, state_code: nil, zip_code: nil, id: nil,
+      type: nil, status: nil, number: nil, security_code: nil, expiration: nil, created: nil, updated: nil
+    )
+      super(id)
+      @holder_id = holder_id
+      @holder_name = holder_name
+      @display_name = display_name
+      @rules = StarkBank::CorporateRule.parse_rules(rules)
+      @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
+      @type = type
+      @status = status
+      @number = number
+      @security_code = security_code
+      expiration = nil if !expiration.nil? && expiration.include?('*')
+      @expiration = StarkCore::Utils::Checks.check_datetime(expiration)
+      @created = StarkCore::Utils::Checks.check_datetime(created)
+      @updated = StarkCore::Utils::Checks.check_datetime(updated)
+    end
+
+    # # Create CorporateCards
+    #
+    # Send a CorporateCard object for creation in the Stark Bank API
+    #
+    # ## Parameters (required):
+    # - card [CorporateCard object]: CorporateCard object to be created in the API
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkBank.user was set before function call
+    #
+    # ## Return:
+    # - CorporateCard object with updated attributes
+    def self.create(card:, expand: nil, user: nil)
+      path =  StarkCore::Utils::API.endpoint(resource[:resource_name]) + '/token'
+      payload = StarkCore::Utils::API.api_json(card)
+      json = StarkBank::Utils::Rest.post_raw(path: path, payload: payload, expand: expand, user: user)
+      entity_json = json[StarkCore::Utils::API.last_name(resource[:resource_name])]
+      StarkCore::Utils::API.from_api_json(resource[:resource_maker], entity_json)
+    end
+
+    # # Retrieve a specific CorporateCard
+    #
+    # Receive a single CorporateCard object previously created in the Stark Bank 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 StarkBank.user was set before function call
+    #
+    # ## Return:
+    # - CorporateCard object with updated attributes
+    def self.get(id, expand: nil, user: nil)
+      StarkBank::Utils::Rest.get_id(id: id, expand: expand, user: user, **resource)
+    end
+
+    # # Retrieve CorporateCards
+    #
+    # Receive a generator of CorporateCard objects previously created in the Stark Bank 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: ['active', 'blocked', 'canceled', 'expired']
+    # - types [list of strings, default nil]: card type. ex: ['virtual']
+    # - 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 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 StarkBank.user was set before function call
+    #
+    # ## Return:
+    # - generator of CorporateCards 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 = StarkCore::Utils::Checks.check_date(after)
+      before = StarkCore::Utils::Checks.check_date(before)
+      StarkBank::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 CorporateCards
+    #
+    # Receive a list of up to 100 CorporateCard objects previously created in the Stark Bank 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)
+    # - 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, 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 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 StarkBank.user was set before function call
+    #
+    # ## Return:
+    # - list of CorporateCard objects with updated attributes
+    # - cursor to retrieve the next page of CorporateCards 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 = StarkCore::Utils::Checks.check_date(after)
+      before = StarkCore::Utils::Checks.check_date(before)
+      StarkBank::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 CorporateCard entity
+    #
+    # Update a CorporateCard by passing id.
+    #
+    # ## Parameters (required):
+    # - id [string]: CorporateCard unique id. ex: '5656565656565656'
+    #
+    # ## Parameters (optional):
+    # - status [string, default nil]: You may block the CorporateCard 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 purchase.
+    # - display_name [string, default nil]: card displayed name. ex: "ANTHONY EDWARD"
+    # - rules [list of CorporateRule 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 starkbank.user was set before function call
+    #
+    # ## Return:
+    # - target CorporateCard with updated attributes
+    def self.update(id, status: nil, display_name: nil,pin: nil, rules: nil, tags: nil, user: nil)
+      StarkBank::Utils::Rest.patch_id(
+        id: id,
+        status: status,
+        pin: pin,
+        display_name: display_name,
+        rules: rules,
+        tags: tags,
+        user: user,
+        **resource
+      )
+    end
+
+    # # Cancel a CorporateCard entity
+    #
+    # Cancel a CorporateCard entity previously created in the Stark Bank API
+    #
+    # ## Parameters (required):
+    # - id [string]: CorporateCard unique id. ex: '5656565656565656'
+    #
+    # ## Parameters (optional):
+    # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkBank.user was set before function call
+    #
+    # ## Return:
+    # - canceled CorporateCard object
+    def self.cancel(id, user: nil)
+      StarkBank::Utils::Rest.delete_id(id: id, user: user, **resource)
+    end
+
+    def self.resource
+      {
+        resource_name: 'CorporateCard',
+        resource_maker: proc { |json|
+          CorporateCard.new(
+            holder_id: json['holder_id'],
+            id: json['id'],
+            holder_name: json['holder_name'],
+            display_name: json['display_name'],
+            rules: json['rules'],
+            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'],
+            type: json['type'],
+            status: json['status'],
+            number: json['number'],
+            security_code: json['security_code'],
+            expiration: json['expiration'],
+            created: json['created'],
+            updated: json['updated']
+          )
+        }
+      }
+    end
+  end
+end

data/lib/corporate_card/log.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+require('starkcore')
+require_relative('corporatecard')
+require_relative('../utils/rest')
+
+module StarkBank
+  class CorporateCard
+    # # CorporateCard::Log object
+    #
+    # Every time a CorporateCard entity is updated, a corresponding CorporateCard::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 CorporateCard.
+    #
+    # ## Attributes (return-only):
+    # - id [string]: unique id returned when the log is created. ex: '5656565656565656'
+    # - card [CorporateCard]: CorporateCard entity to which the log refers to.
+    # - type [string]: type of the CorporateCard event which triggered the log creation. ex: "blocked", "canceled", "created", "expired", "unblocked", "updated"
+    # - created [DateTime]: creation datetime for the log. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
+    class Log < StarkCore::Utils::Resource
+      attr_reader :id, :created, :type, :card
+      def initialize(id:, created:, type:, card:)
+        super(id)
+        @type = type
+        @card = card
+        @created = StarkCore::Utils::Checks.check_datetime(created)
+      end
+
+      # # Retrieve a specific CorporateCard::Log
+      #
+      # Receive a single CorporateCard::Log object previously created by the Stark Bank 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 StarkBank.user was set before function call
+      #
+      # ## Return:
+      # - CorporateCard::Log object with updated attributes
+      def self.get(id, user: nil)
+        StarkBank::Utils::Rest.get_id(id: id, user: user, **resource)
+      end
+
+      # # Retrieve CorporateCard::Logs
+      #
+      # Receive a generator of CorporateCard::Log objects previously created in the Stark Bank 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: ['blocked', 'canceled', 'created', 'expired', 'unblocked', 'updated']
+      # - card_ids [list of strings, default nil]: list of CorporateCard ids to filter logs. ex: ['5656565656565656', '4545454545454545']
+      # - 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 starkbank.user was set before function call
+      #
+      # ## Return:
+      # - generator of CorporateCard::Log objects with updated attributes
+      def self.query(limit: nil, after: nil, before: nil, types: nil, card_ids: nil, user: nil)
+        after = StarkCore::Utils::Checks.check_date(after)
+        before = StarkCore::Utils::Checks.check_date(before)
+        StarkBank::Utils::Rest.get_stream(
+          limit: limit,
+          after: after,
+          before: before,
+          types: types,
+          card_ids: card_ids,
+          user: user,
+          **resource
+        )
+      end
+
+      # # Retrieve paged CorporateCard::Logs
+      #
+      # Receive a list of up to 100 CorporateCard::Log objects previously created in the Stark Bank 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
+      # - 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: ['blocked', 'canceled', 'created', 'expired', 'unblocked', 'updated']
+      # - card_ids [list of strings, default nil]: list of CorporateCard ids to filter logs. ex: ['5656565656565656', '4545454545454545']
+      # - 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 starkbank.user was set before function call
+      #
+      # ## Return:
+      # - list of CorporateCard::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 = StarkCore::Utils::Checks.check_date(after)
+        before = StarkCore::Utils::Checks.check_date(before)
+        StarkBank::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 = StarkBank::CorporateCard.resource[:resource_maker]
+        {
+          resource_name: 'CorporateCardLog',
+          resource_maker: proc { |json|
+            Log.new(
+              id: json['id'],
+              created: json['created'],
+              type: json['type'],
+              card: StarkCore::Utils::API.from_api_json(request_maker, json['card'])
+            )
+          }
+        }
+      end
+    end
+  end
+end