starkinfra 0.0.3 → 0.2.0

data/lib/issuingrule/issuingrule.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
   # # IssuingRule object
@@ -12,47 +12,91 @@ module StarkInfra
   # ## Parameters (required):
   # - name [string]: rule name. ex: 'Travel' or 'Food'
   # - amount [integer]: maximum amount that can be spent in the informed interval. ex: 200000 (= R$ 2000.00)
-  # - interval [string]: interval after which the rule amount counter will be reset to 0. ex: 'instant', 'day', 'week', 'month', 'year' or 'lifetime'
+  #
   # ## Parameters (optional):
+  # - id [string, default nil]: unique id returned when an IssuingRule is created, used to update a specific IssuingRule. ex: '5656565656565656'
+  # - interval [string, default 'lifetime']: interval after which the rule amount counter will be reset to 0. ex: 'instant', 'day', 'week', 'month', 'year' or 'lifetime'
   # - currency_code [string, default 'BRL']: code of the currency that the rule amount refers to. ex: 'BRL' or 'USD'
-  # - categories [list of strings, default []]: merchant categories accepted by the rule. ex: ['eatingPlacesRestaurants', 'travelAgenciesTourOperators']
-  # - countries [list of strings, default []]: countries accepted by the rule. ex: ['BRA', 'USA']
-  # - methods [list of strings, default []]: card purchase methods accepted by the rule. ex: ['chip', 'token', 'server', 'manual', 'magstripe', 'contactless']
+  # - categories [list of MerchantCategories, default nil]: merchant categories accepted by the rule. ex: [MerchantCategory(code='fastFoodRestaurants')]
+  # - countries [list of MerchantCountries, default nil]: countries accepted by the rule. ex: [MerchantCountry(code='BRA')]
+  # - methods [list of CardMethods, default nil]: card purchase methods accepted by the rule. ex: [CardMethod(code='magstripe')]
+  #
   # ## Attributes (expanded return-only):
   # - counter_amount [integer]: current rule spent amount. ex: 1000
   # - currency_symbol [string]: currency symbol. ex: 'R$'
   # - currency_name [string]: currency name. ex: 'Brazilian Real'
-  # ## Attributes (return-only):
-  # - id [string]: unique id returned when Rule is created. ex: '5656565656565656'
   class IssuingRule < StarkInfra::Utils::Resource
-    attr_reader :name, :interval, :amount, :currency_code, :counter_amount, :currency_name, :currency_symbol, :categories, :countries, :methods
-    def initialize(name:, interval:, amount:, currency_code: nil, counter_amount: nil, currency_name: nil,
-      currency_symbol: nil, categories: nil, countries: nil, methods: nil
+    attr_reader :name, :interval, :amount, :currency_code, :counter_amount, :currency_name, :currency_symbol,
+                :categories, :countries, :methods
+    def initialize(
+      name:, amount:, id: nil, interval: nil, currency_code: nil, categories: nil, countries: nil, methods: nil,
+      counter_amount: nil, currency_symbol: nil, currency_name: nil
     )
       super(id)
       @name = name
-      @interval = interval
       @amount = amount
+      @interval = interval
       @currency_code = currency_code
+      @categories = IssuingRule.parse_categories(categories)
+      @countries = IssuingRule.parse_categories(countries)
+      @methods = IssuingRule.parse_categories(methods)
       @counter_amount = counter_amount
-      @currency_name = currency_name
       @currency_symbol = currency_symbol
-      @categories = categories
-      @countries = countries
-      @methods = methods
+      @currency_name = currency_name
+    end
+
+    def self.parse_categories(categories)
+      resource_maker = StarkInfra::MerchantCategory.resource[:resource_maker]
+      return categories if categories.nil?
+
+      parsed_categories = []
+      categories.each do |category|
+        unless category.is_a? MerchantCategory
+          category = StarkInfra::Utils::API.from_api_json(resource_maker, category)
+        end
+        parsed_categories << category
+      end
+      parsed_categories
+    end
+
+    def self.parse_countries(countries)
+      resource_maker = StarkInfra::MerchantCountry.resource[:resource_maker]
+      return countries if countries.nil?
+
+      parsed_countries = []
+      countries.each do |country|
+        unless country.is_a? MerchantCountry
+          country = StarkInfra::Utils::API.from_api_json(resource_maker, country)
+        end
+        parsed_countries << country
+      end
+      parsed_countries
+    end
+
+    def self.parse_methods(methods)
+      resource_maker = StarkInfra::CardMethod.resource[:resource_maker]
+      return methods if methods.nil?
+
+      parsed_methods = []
+      methods.each do |method|
+        unless method.is_a? CardMethod
+          method = StarkInfra::Utils::API.from_api_json(resource_maker, method)
+        end
+        parsed_methods << method
+      end
+      parsed_methods
     end
 
     def self.parse_rules(rules)
-      parsed_rules = []
       rule_maker = StarkInfra::IssuingRule.resource[:resource_maker]
       return rules if rules.nil?
 
+      parsed_rules = []
       rules.each do |rule|
-        if rule.is_a? IssuingRule
-          parsed_rules.append(rule)
-          next
+        unless rule.is_a? IssuingRule
+          rule = StarkInfra::Utils::API.from_api_json(rule_maker, rule)
         end
-        parsed_rules.append(StarkInfra::Utils::API.from_api_json(rule_maker, rule))
+        parsed_rules << rule
       end
       parsed_rules
     end
@@ -62,16 +106,16 @@ module StarkInfra
         resource_name: 'IssuingRule',
         resource_maker: proc { |json|
           IssuingRule.new(
-            name: json[:name],
-            interval: json[:interval],
-            amount: json[:amount],
-            currency_code: json[:currency_code],
-            counter_amount: json[:counter_amount],
-            currency_name: json[:currency_name],
-            currency_symbol: json[:currency_symbol],
-            categories: json[:categories],
-            countries: json[:countries],
-            methods: json[:methods]
+            name: json['name'],
+            amount: json['amount'],
+            interval: json['interval'],
+            currency_code: json['currency_code'],
+            categories: json['categories'],
+            countries: json['countries'],
+            methods: json['methods'],
+            counter_amount: json['counter_amount'],
+            currency_symbol: json['currency_symbol'],
+            currency_name: json['currency_name']
           )
         }
       }

data/lib/issuingtransaction/issuingtransaction.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
   # # IssuingTransaction object
@@ -20,9 +20,7 @@ module StarkInfra
   class IssuingTransaction < StarkInfra::Utils::Resource
     attr_reader :id, :amount, :balance, :description, :source, :tags, :created
 
-    def initialize(
-      id: nil, amount: nil, balance: nil, description: nil, source: nil, tags: nil, created: nil
-    )
+    def initialize(id: nil, amount: nil, balance: nil, description: nil, source: nil, tags: nil, created: nil)
       super(id)
       @amount = amount
       @balance = balance
@@ -54,11 +52,11 @@ module StarkInfra
     #
     # ## Parameters (optional):
     # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
-    # - external_ids [list of strings, default []]: external IDs. ex: ['5656565656565656', '4545454545454545']
+    # - external_ids [list of strings, default nil]: external IDs. 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 [string, default nil]: filter for status of retrieved objects. ex: 'approved', 'canceled', 'denied', 'confirmed' or 'voided'
-    # - ids [list of strings, default [], default nil]: purchase IDs
+    # - ids [list of strings, default nil]: purchase IDs
     # - 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
     #
@@ -87,12 +85,12 @@ module StarkInfra
     # ## Parameters (optional):
     # - cursor [string, default nil]: cursor returned on the previous page function call.
     # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
-    # - external_ids [list of strings, default nil: external IDs. ex: ['5656565656565656', '4545454545454545']
+    # - external_ids [list of strings, default nil]: external IDs. 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 [string, default nil]: filter for status of retrieved objects. ex: 'approved', 'canceled', 'denied', 'confirmed' or 'voided'
     # - ids [list of strings, default nil]: purchase IDs
-    # - limit [integer, default nil]: maximum number of objects to be retrieved. Max = 100. ex: 35
+    # - limit [integer, default 100]: 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:

data/lib/issuingwithdrawal/issuingwithdrawal.rb

@@ -1,21 +1,25 @@
 # frozen_string_literal: true
 
-require_relative('../utils/resource')
 require_relative('../utils/rest')
 require_relative('../utils/checks')
+require_relative('../utils/resource')
 
 module StarkInfra
   # # IssuingWithdrawal object
   #
   # The IssuingWithdrawal objects created in your Workspace return cash from your Issuing balance to your Banking balance.
   #
+  # When you initialize a IssuingWithdrawal, 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 created object.
+  #
   # ## Parameters (required):
   # - amount [integer]: IssuingWithdrawal value in cents. Minimum = 0 (any value will be accepted). ex: 1234 (= R$ 12.34)
   # - external_id [string] IssuingWithdrawal external ID. ex: '12345'
   # - description [string]: IssuingWithdrawal description. ex: 'sending money back'
   #
   # ## Parameters (optional):
-  # - tags [list of strings, default []]: list of strings for tagging. ex: ['tony', 'stark']
+  # - tags [list of strings, default nil]: list of strings for tagging. ex: ['tony', 'stark']
   #
   # ## Attributes (return-only):
   # - id [string]: unique id returned when IssuingWithdrawal is created. ex: '5656565656565656'
@@ -36,8 +40,8 @@ module StarkInfra
       @tags = tags
       @transaction_id = transaction_id
       @issuing_transaction_id = issuing_transaction_id
-      @created = StarkInfra::Utils::Checks.check_datetime(created)
       @updated = StarkInfra::Utils::Checks.check_datetime(updated)
+      @created = StarkInfra::Utils::Checks.check_datetime(created)
     end
 
     # # Create an IssuingWithdrawal
@@ -78,7 +82,7 @@ module StarkInfra
     #
     # ## Parameters (optional):
     # - limit [integer, default nil]: maximum number of objects to be retrieved. Unlimited if nil. ex: 35
-    # - external_ids [list of strings, default []]: external IDs. ex: ['5656565656565656', '4545454545454545']
+    # - external_ids [list of strings, default nil]: external IDs. 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)
     # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
@@ -106,8 +110,8 @@ module StarkInfra
     #
     # ## 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
-    # - external_ids [list of strings, default []]: external IDs. ex: ['5656565656565656', '4545454545454545']
+    # - limit [integer, default 100]: maximum number of objects to be retrieved. Max = 100. ex: 35
+    # - external_ids [list of strings, default nil]: external IDs. 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)
     # - tags [list of strings, default nil]: tags to filter retrieved objects. ex: ['tony', 'stark']
@@ -136,11 +140,11 @@ module StarkInfra
         resource_name: 'IssuingWithdrawal',
         resource_maker: proc { |json|
           IssuingWithdrawal.new(
+            id: json['id'],
             amount: json['amount'],
             external_id: json['external_id'],
             description: json['description'],
             tags: json['tags'],
-            id: json['id'],
             transaction_id: json['transaction_id'],
             issuing_transaction_id: json['issuing_transaction_id'],
             updated: json['updated'],

data/lib/merchantcategory/merchantcategory.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require_relative('../utils/rest')
+require_relative('../utils/sub_resource')
+
+module StarkInfra
+  # # MerchantCategory object
+  #
+  # MerchantCategory's codes and types are used to define categories filters in IssuingRules.
+  #
+  # A MerchantCategory filter must define exactly one parameter between code and type.
+  # A type, such as 'food', 'services', etc., defines an entire group of merchant codes,
+  # whereas a code only specifies a specific MCC.
+  #
+  # ## Parameters (conditionally required):
+  # - code [string, default nil]: category's code. ex: 'veterinaryServices', 'fastFoodRestaurants'
+  # - type [string, default nil]: category's type. ex: 'pets', 'food'
+  #
+  # Attributes (return-only):
+  # - name [string]: category's name. ex: 'Veterinary services', 'Fast food restaurants'
+  # - number [string]: category's number. ex: '742', '5814'
+  class MerchantCategory < StarkInfra::Utils::SubResource
+    attr_reader :code, :type, :name, :number
+    def initialize(code:, type:, name: nil, number: nil)
+      @code = code
+      @type = type
+      @name = name
+      @number = number
+    end
+
+    # # Retrieve MerchantCategories
+    #
+    # Receive a generator of MerchantCategory objects available in the Stark Infra 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 starkinfra.user was set before function call
+    #
+    # ## Return:
+    # - generator of MerchantCategory objects with updated attributes
+    def self.query(search: nil, user: nil)
+      StarkInfra::Utils::Rest.get_stream(
+        search: search,
+        user: user,
+        **resource
+      )
+    end
+
+    def self.resource
+      {
+        resource_name: 'MerchantCategory',
+        resource_maker: proc { |json|
+          MerchantCategory.new(
+            code: json['code'],
+            type: json['type'],
+            name: json['name'],
+            number: json['number']
+          )
+        }
+      }
+    end
+  end
+end

data/lib/merchantcountry/merchantcountry.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require_relative('../utils/rest')
+require_relative('../utils/sub_resource')
+
+module StarkInfra
+  # # MerchantCountry object
+  #
+  # MerchantCountry's codes are used to define countries filters in IssuingRules.
+  #
+  # ## Parameters (required):
+  # - code [string]: country's code. ex: 'BRA'
+  #
+  # Attributes (return-only):
+  # - name [string]: country's name. ex: 'Brazil'
+  # - number [string]: country's number. ex: '076'
+  # - short_code [string]: country's short code. ex: 'BR'
+  class MerchantCountry < StarkInfra::Utils::SubResource
+    attr_reader :code, :short_code, :name, :number
+    def initialize(code:, name: nil, number: nil, short_code: nil)
+      @code = code
+      @name = name
+      @number = number
+      @short_code = short_code
+    end
+
+    # # Retrieve MerchantCountries
+    #
+    # Receive a generator of MerchantCountry objects available in the Stark Infra 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 starkinfra.user was set before function call
+    #
+    # ## Return:
+    # - generator of MerchantCountry objects with updated attributes
+    def self.query(search: nil, user: nil)
+      StarkInfra::Utils::Rest.get_stream(
+        search: search,
+        user: user,
+        **resource
+      )
+    end
+
+    def self.resource
+      {
+        resource_name: 'MerchantCountry',
+        resource_maker: proc { |json|
+          MerchantCountry.new(
+            code: json['code'],
+            name: json['name'],
+            number: json['number'],
+            short_code: json['short_code']
+          )
+        }
+      }
+    end
+  end
+end

data/lib/pixbalance/pixbalance.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
   # # PixBalance object
@@ -18,8 +18,8 @@ module StarkInfra
   # - currency [string]: currency of the current workspace. Expect others to be added eventually. ex: 'BRL'
   # - updated [DateTime]: latest update datetime for the balance. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   class PixBalance < StarkInfra::Utils::Resource
-    attr_reader :amount, :currency, :updated, :id
-    def initialize(amount: nil, currency: nil, updated: nil, id: nil)
+    attr_reader :id, :amount, :currency, :updated
+    def initialize(id: nil, amount: nil, currency: nil, updated: nil)
       super(id)
       @amount = amount
       @currency = currency
@@ -44,10 +44,10 @@ module StarkInfra
         resource_name: 'PixBalance',
         resource_maker: proc { |json|
           PixBalance.new(
+            id: json['id'],
             amount: json['amount'],
             currency: json['currency'],
-            updated: json['updated'],
-            id: json['id']
+            updated: json['updated']
           )
         }
       }

data/lib/pixchargeback/log.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-require_relative('../utils/resource')
+require_relative('pixchargeback')
 require_relative('../utils/rest')
 require_relative('../utils/checks')
-require_relative('pixchargeback')
+require_relative('../utils/resource')
 
 module StarkInfra
   class PixChargeback
@@ -44,7 +44,7 @@ module StarkInfra
       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

data/lib/pixchargeback/pixchargeback.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
   # # PixChargeback object
@@ -10,8 +10,10 @@ module StarkInfra
   # A Pix chargeback can be created when fraud is detected on a transaction or a system malfunction
   # results in an erroneous transaction.
   # It notifies another participant of your request to reverse the payment they have received.
+  #
   # When you initialize a PixChargeback, 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 created object.
   #
   # ## Parameters (required):
   # - amount [integer]: amount in cents to be reversed. ex: 11234 (= R$ 112.34)
@@ -20,40 +22,41 @@ module StarkInfra
   #
   # ## Parameters (optional):
   # - description [string, default nil]: description for the PixChargeback. ex: 'Payment for service #1234'
+  # - tags [list of strings, default nil]:  list of strings for tagging. ex: ['travel', 'food']
   #
   # ## Attributes (return-only):
-  # - id [string]: unique id returned when PixChargeback is created. ex: '5656565656565656'
+  # - id [string]: unique id returned when the PixChargeback is created. ex: '5656565656565656'
   # - analysis [string]: analysis that led to the result.
-  # - bacen_id [string]: central bank's unique UUID that identifies the PixChargeback.
   # - sender_bank_code [string]: bank_code of the Pix participant that created the PixChargeback. ex: '20018183'
   # - receiver_bank_code [string]: bank_code of the Pix participant that received the PixChargeback. ex: '20018183'
   # - rejection_reason [string]: reason for the rejection of the Pix chargeback. Options: 'noBalance', 'accountClosed', 'unableToReverse'
   # - reversal_reference_id [string]: return id of the reversal transaction. ex: 'D20018183202202030109X3OoBHG74wo'.
-  # - id [string]: unique id returned when the PixChargeback is created. ex: '5656565656565656'
   # - result [string]: result after the analysis of the PixChargeback by the receiving party. Options: 'rejected', 'accepted', 'partiallyAccepted'
+  # - flow [string]: direction of the Pix Chargeback. Options: 'in' for received chargebacks, 'out' for chargebacks you requested
   # - status [string]: current PixChargeback status. Options: 'created', 'failed', 'delivered', 'closed', 'canceled'.
   # - created [DateTime]: creation datetime for the PixChargeback. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   # - updated [DateTime]: latest update datetime for the PixChargeback. ex: DateTime.new(2020, 3, 10, 10, 30, 0, 0)
   class PixChargeback < StarkInfra::Utils::Resource
-    attr_reader :amount, :reference_id, :reason, :description, :id, :analysis, :bacen_id, :sender_bank_code,
-                :receiver_bank_code, :rejection_reason, :reversal_reference_id, :result, :status, :created, :updated
+    attr_reader :amount, :reference_id, :reason, :description, :tags, :id, :analysis, :sender_bank_code,
+                :receiver_bank_code, :rejection_reason, :reversal_reference_id, :result, :flow, :status, :created, :updated
     def initialize(
-      amount:, reference_id:, reason:, description: nil, id: nil, analysis: nil, bacen_id: nil,
-      sender_bank_code: nil, receiver_bank_code: nil, rejection_reason: nil, reversal_reference_id: nil,
-      result: nil, status: nil, created: nil, updated: nil
+      amount:, reference_id:, reason:, description: nil, tags: nil, id: nil, analysis: nil, sender_bank_code: nil,
+      receiver_bank_code: nil, rejection_reason: nil, reversal_reference_id: nil, result: nil, flow: nil, status: nil,
+      created: nil, updated: nil
     )
       super(id)
       @amount = amount
       @reference_id = reference_id
       @reason = reason
       @description = description
+      @tags = tags
       @analysis = analysis
-      @bacen_id = bacen_id
       @sender_bank_code = sender_bank_code
       @receiver_bank_code = receiver_bank_code
       @rejection_reason = rejection_reason
       @reversal_reference_id = reversal_reference_id
       @result = result
+      @flow = flow
       @status = status
       @created = StarkInfra::Utils::Checks.check_datetime(created)
       @updated = StarkInfra::Utils::Checks.check_datetime(updated)
@@ -61,10 +64,10 @@ module StarkInfra
 
     # # Create PixChargebacks
     #
-    # Send a list of PixChargeback objects for creation in the Stark Infra API
+    # Create PixChargebacks in the Stark Infra API
     #
     # ## Parameters (required):
-    # - chargebacks [list of PixChargeback objects]: list of PixChargeback objects to be created in the API. ex: [PixChargeback.new()]
+    # - chargebacks [list of PixChargeback objects]: list of PixChargeback 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
@@ -75,9 +78,9 @@ module StarkInfra
       StarkInfra::Utils::Rest.post(entities: chargebacks, user: user, **resource)
     end
 
-    # # Retrieve a specific PixChargeback
+    # # Retrieve a PixChargeback object
     #
-    # Receive a single PixChargeback object previously created in the Stark Infra API by passing its id
+    # Retrieve a PixChargeback object linked to your Workspace in the Stark Infra API using its id.
     #
     # ## Parameters (required):
     # - id [string]: object unique id. ex: '5656565656565656'
@@ -101,11 +104,13 @@ module StarkInfra
     # - before [Date or string, default nil]: date filter for objects created or updated only before specified date. ex: Date.new(2020, 3, 10)
     # - status [string, default nil]: filter for status of retrieved objects. ex: 'success' or 'failed'
     # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+    # - flow [string, default nil]: direction of the Pix Chargeback. Options: 'in' for received chargebacks, 'out' for chargebacks you requested
+    # - tags [list of strings, default nil]: filter for tags of retrieved objects. ex: ['travel', 'food']
     # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
     #
     # ## Return:
     # - generator of PixChargeback objects with updated attributes
-    def self.query(limit: nil, after: nil, before: nil, status: nil, ids: nil, user: nil)
+    def self.query(limit: nil, after: nil, before: nil, status: nil, ids: nil, flow: nil, tags: nil, user: nil)
       after = StarkInfra::Utils::Checks.check_date(after)
       before = StarkInfra::Utils::Checks.check_date(before)
       StarkInfra::Utils::Rest.get_stream(
@@ -114,6 +119,8 @@ module StarkInfra
         before: before,
         status: status,
         ids: ids,
+        flow: flow,
+        tags: tags,
         user: user,
         **resource
       )
@@ -131,12 +138,14 @@ module StarkInfra
     # - before [Date or string, default nil]: date filter for objects created or updated only before specified date. ex: Date.new(2020, 3, 10)
     # - status [string, default nil]: filter for status of retrieved objects. ex: 'success' or 'failed'
     # - ids [list of strings, default nil]: list of ids to filter retrieved objects. ex: ['5656565656565656', '4545454545454545']
+    # - flow [string, default nil]: direction of the Pix Chargeback. Options: 'in' for received chargebacks, 'out' for chargebacks you requested
+    # - tags [list of strings, default nil]: filter for tags of retrieved objects. ex: ['travel', 'food']
     # - user [Organization/Project object, default nil]: Organization or Project object. Not necessary if StarkInfra.user was set before function call
     #
     # ## Return:
     # - list of PixChargeback objects with updated attributes
     # - cursor to retrieve the next page of PixChargeback objects
-    def self.page(cursor: nil, limit: nil, after: nil, before: nil, status: nil, ids: nil, user: nil)
+    def self.page(cursor: nil, limit: nil, after: nil, before: nil, status: nil, ids: nil, flow: nil, tags: nil, user: nil)
       after = StarkInfra::Utils::Checks.check_date(after)
       before = StarkInfra::Utils::Checks.check_date(before)
       StarkInfra::Utils::Rest.get_page(
@@ -146,6 +155,8 @@ module StarkInfra
         before: before,
         status: status,
         ids: ids,
+        flow: flow,
+        tags: tags,
         user: user,
         **resource
       )
@@ -157,7 +168,7 @@ module StarkInfra
     #
     # ## Parameters (required):
     # - id [string]: PixChargeback unique id. ex: '5656565656565656'
-    # - result [string]: result of the PixChargeback. Options: 'rejected', 'accepted', 'partiallyAccepted'.
+    # - result [string]: result after the analysis of the PixChargeback. Options: 'rejected', 'accepted', 'partiallyAccepted'.
     #
     # ## Parameters (conditionally required):
     # - rejection_reason [string, default nil]: if the PixChargeback is rejected a reason is required. Options: 'noBalance', 'accountClosed', 'unableToReverse',
@@ -174,8 +185,8 @@ module StarkInfra
         id: id,
         result: result,
         rejection_reason: rejection_reason,
-        analysis: analysis,
         reversal_reference_id: reversal_reference_id,
+        analysis: analysis,
         user: user,
         **resource
       )
@@ -202,18 +213,19 @@ module StarkInfra
         resource_name: 'PixChargeback',
         resource_maker: proc { |json|
           PixChargeback.new(
+            id: json['id'],
             amount: json['amount'],
             reference_id: json['reference_id'],
             reason: json['reason'],
             description: json['description'],
-            id: json['id'],
+            tags: json['tags'],
             analysis: json['analysis'],
-            bacen_id: json['bacen_id'],
             sender_bank_code: json['sender_bank_code'],
             receiver_bank_code: json['receiver_bank_code'],
             rejection_reason: json['rejection_reason'],
             reversal_reference_id: json['reversal_reference_id'],
             result: json['result'],
+            flow: json['flow'],
             status: json['status'],
             created: json['created'],
             updated: json['updated']