fintoc 1.4.0 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 125043d067ac8281433e37d16a8376d3b25f581b3a4fc7f31b30e1b96623e570
-  data.tar.gz: 909b347cacb35dfd8e495be517e7c6320ce8aa9930c592215651cd813636e256
+  metadata.gz: 34910f21240b0f76d808c9ab4f22b8ea4a904c9280b11e3bb1d39eee6660a0b6
+  data.tar.gz: ce6b1ca7100789cb27067aaeccd80324e089cbaf7b819317f35472f1fd3dad6d
 SHA512:
-  metadata.gz: b4fe705e12286af83f27d6fbdae257f334f65b98122d16cb187b6d2c326b10c482356d30e4962faa2395e3e0199d83fc287b2d40a213cf8ff3f780eda714c7c7
-  data.tar.gz: 8ff1d5bb3d658081d9dc3086ab8a2c0b01051c7cd5a30776a150960365191c33879016f5fb2738e63e15c9ca767adc1a5ee48c915f92b40837351c284f988312
+  metadata.gz: 963c67d86b28ec2a1215720a6ddc69ff102f2f4368bc32871167750418d49e0e1b46ad95ebb6406862be93bd80034ea9398eac3622b9ced2a8b13719c7f7a519
+  data.tar.gz: fb45a851b1ce805c9bfd31d9eeefb21646c0acccdff4e0a3be04e541e57778af090f553892127638ef2ebd623319c17c430f9a09168875fe1b94ec99392f25f5

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    fintoc (1.4.0)
+    fintoc (1.5.0)
       http
       money-rails
       tabulate

data/README.md

@@ -31,6 +31,7 @@ Do yourself a favor: go grab some ice cubes by installing this refreshing librar
       - [Accounts](#accounts)
       - [Account Numbers](#account-numbers)
       - [Transfers](#transfers)
+      - [Transfer Batches](#transfer-batches)
       - [Simulate](#simulate)
       - [Account Verifications](#account-verifications)
     - [Entity onboardings API Examples](#entity-onboardings-api-examples)
@@ -139,6 +140,15 @@ transfer = client.v2.transfers.create(
 )
 client.v2.transfers.return('transfer_id')
 
+# Transfer Batches
+transfer_batches = client.v2.transfer_batches.list
+transfer_batch = client.v2.transfer_batches.get('transfer_batch_id')
+transfer_batch = client.v2.transfer_batches.create(
+  description: 'Supplier payments',
+  currency: 'MXN',
+  transfers: [{...}]
+)
+
 # Simulate
 simulated_transfer = client.v2.simulate.receive_transfer(
   account_number_id: 'account_number_id',
@@ -360,6 +370,42 @@ transfers = client.v2.transfers.list
 returned_transfer = client.v2.transfers.return('transfer_id')
 ```
 
+#### Transfer Batches
+
+```ruby
+require 'fintoc'
+
+client = Fintoc::Client.new('api_key', jws_private_key: 'jws_private_key')
+
+# Create a transfer batch. Each transfer has the same shape as `transfers.create`, without `currency`
+transfer_batch = client.v2.transfer_batches.create(
+  description: 'Supplier payments',
+  currency: 'MXN',
+  transfers: [
+    {
+      account_id: 'account_id',
+      amount: 10000,
+      comment: 'Invoice 1234',
+      reference_id: '123456',
+      counterparty: { account_number: '735969000000203297' }
+    }
+  ]
+)
+
+# Get a specific transfer batch
+transfer_batch = client.v2.transfer_batches.get('transfer_batch_id')
+
+# List transfer batches, optionally filtered by status and creation date
+transfer_batches = client.v2.transfer_batches.list(
+  'status[]': %w[succeeded partially_succeeded],
+  since: '2026-10-01T00:00:00Z',
+  until: '2026-10-31T23:59:59Z'
+)
+
+# List the transfers of a batch
+transfers = client.v2.transfers.list(transfer_batch_id: 'transfer_batch_id')
+```
+
 #### Simulate
 
 ```ruby

data/lib/fintoc/errors.rb

@@ -66,6 +66,9 @@ module Fintoc
     class InvalidInstallmentsCurrencyError < FintocError; end
     class InvalidClabeError < FintocError; end
     class MismatchTransferAccountCurrencyError < FintocError; end
+    class InvalidTransfersError < FintocError; end
+    class InvalidTransfersSizeError < FintocError; end
+    class InvalidDescriptionSizeError < FintocError; end
 
     # 401 Unauthorized Errors
     class AuthenticationError < FintocError; end
@@ -124,6 +127,7 @@ module Fintoc
     class InvalidTransferDirectionError < FintocError; end
     class AccountNumberLimitReachedError < FintocError; end
     class AccountCannotBeBlockedError < FintocError; end
+    class InvalidSenderAccountsError < FintocError; end
 
     # 422 Unprocessable Entity Errors
     class InvalidOtpCodeError < FintocError; end
@@ -150,6 +154,9 @@ module Fintoc
     class UnrecognizedRequestError < FintocError; end
     class CoreResponseError < FintocError; end
 
+    # 501 Not Implemented Errors
+    class OperationNotImplementedError < FintocError; end
+
     # Webhook Errors
     class WebhookSignatureError < FintocError; end
 

data/lib/fintoc/v2/client/client.rb

@@ -3,6 +3,7 @@ require 'fintoc/v2/managers/entities_manager'
 require 'fintoc/v2/managers/accounts_manager'
 require 'fintoc/v2/managers/account_numbers_manager'
 require 'fintoc/v2/managers/transfers_manager'
+require 'fintoc/v2/managers/transfer_batches_manager'
 require 'fintoc/v2/managers/simulate_manager'
 require 'fintoc/v2/managers/account_verifications_manager'
 
@@ -25,6 +26,10 @@ module Fintoc
         @transfers ||= Managers::TransfersManager.new(self)
       end
 
+      def transfer_batches
+        @transfer_batches ||= Managers::TransferBatchesManager.new(self)
+      end
+
       def simulate
         @simulate ||= Managers::SimulateManager.new(self)
       end

data/lib/fintoc/v2/managers/transfer_batches_manager.rb

@@ -0,0 +1,47 @@
+require 'fintoc/v2/resources/transfer_batch'
+
+module Fintoc
+  module V2
+    module Managers
+      class TransferBatchesManager
+        def initialize(client)
+          @client = client
+        end
+
+        def create(description:, currency:, transfers:, idempotency_key: nil)
+          data = _create_transfer_batch(description:, currency:, transfers:, idempotency_key:)
+          build_transfer_batch(data)
+        end
+
+        def get(transfer_batch_id)
+          data = _get_transfer_batch(transfer_batch_id)
+          build_transfer_batch(data)
+        end
+
+        def list(**params)
+          _list_transfer_batches(**params).map { |data| build_transfer_batch(data) }
+        end
+
+        private
+
+        def _create_transfer_batch(description:, currency:, transfers:, idempotency_key: nil)
+          @client
+            .post(version: :v2, use_jws: true, idempotency_key:)
+            .call('transfer_batches', description:, currency:, transfers:)
+        end
+
+        def _get_transfer_batch(transfer_batch_id)
+          @client.get(version: :v2).call("transfer_batches/#{transfer_batch_id}")
+        end
+
+        def _list_transfer_batches(**params)
+          @client.get(version: :v2).call('transfer_batches', **params)
+        end
+
+        def build_transfer_batch(data)
+          Fintoc::V2::TransferBatch.new(**data, client: @client)
+        end
+      end
+    end
+  end
+end

data/lib/fintoc/v2/resources/transfer_batch.rb

@@ -0,0 +1,114 @@
+require 'money'
+
+module Fintoc
+  module V2
+    class TransferBatch
+      attr_reader :id, :object, :mode, :description, :status, :currency, :transfer_count,
+                  :amount, :succeeded_count, :settled_amount, :created_at, :authorized_at,
+                  :rejected_at, :expired_at, :succeeded_at, :partially_succeeded_at
+
+      def initialize( # rubocop:disable Metrics/MethodLength
+        id:,
+        object:,
+        mode:,
+        status:,
+        currency:,
+        transfer_count:,
+        amount:,
+        description: nil,
+        succeeded_count: nil,
+        settled_amount: nil,
+        created_at: nil,
+        authorized_at: nil,
+        rejected_at: nil,
+        expired_at: nil,
+        succeeded_at: nil,
+        partially_succeeded_at: nil,
+        client: nil,
+        **
+      )
+        @id = id
+        @object = object
+        @mode = mode
+        @description = description
+        @status = status
+        @currency = currency
+        @transfer_count = transfer_count
+        @amount = amount
+        @succeeded_count = succeeded_count
+        @settled_amount = settled_amount
+        @created_at = created_at
+        @authorized_at = authorized_at
+        @rejected_at = rejected_at
+        @expired_at = expired_at
+        @succeeded_at = succeeded_at
+        @partially_succeeded_at = partially_succeeded_at
+        @client = client
+      end
+
+      def to_s
+        amount_str = Money.from_cents(@amount, @currency).format
+        "📦 #{amount_str} (#{@id}) - #{@status}"
+      end
+
+      def refresh
+        fresh_transfer_batch = @client.transfer_batches.get(@id)
+        refresh_from_transfer_batch(fresh_transfer_batch)
+      end
+
+      def pending_authorization?
+        @status == 'pending_authorization'
+      end
+
+      def in_progress?
+        @status == 'in_progress'
+      end
+
+      def rejected?
+        @status == 'rejected'
+      end
+
+      def expired?
+        @status == 'expired'
+      end
+
+      def succeeded?
+        @status == 'succeeded'
+      end
+
+      def partially_succeeded?
+        @status == 'partially_succeeded'
+      end
+
+      def failed?
+        @status == 'failed'
+      end
+
+      private
+
+      def refresh_from_transfer_batch(transfer_batch) # rubocop:disable Metrics/MethodLength
+        unless transfer_batch.id == @id
+          raise ArgumentError, 'Transfer batch must be the same instance'
+        end
+
+        @object = transfer_batch.object
+        @mode = transfer_batch.mode
+        @description = transfer_batch.description
+        @status = transfer_batch.status
+        @currency = transfer_batch.currency
+        @transfer_count = transfer_batch.transfer_count
+        @amount = transfer_batch.amount
+        @succeeded_count = transfer_batch.succeeded_count
+        @settled_amount = transfer_batch.settled_amount
+        @created_at = transfer_batch.created_at
+        @authorized_at = transfer_batch.authorized_at
+        @rejected_at = transfer_batch.rejected_at
+        @expired_at = transfer_batch.expired_at
+        @succeeded_at = transfer_batch.succeeded_at
+        @partially_succeeded_at = transfer_batch.partially_succeeded_at
+
+        self
+      end
+    end
+  end
+end

data/lib/fintoc/version.rb

@@ -1,3 +1,3 @@
 module Fintoc
-  VERSION = '1.4.0'
+  VERSION = '1.5.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fintoc
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.0
 platform: ruby
 authors:
 - Juan Ca Sardin
@@ -101,6 +101,7 @@ files:
 - lib/fintoc/v2/managers/movements_manager.rb
 - lib/fintoc/v2/managers/onboardings_manager.rb
 - lib/fintoc/v2/managers/simulate_manager.rb
+- lib/fintoc/v2/managers/transfer_batches_manager.rb
 - lib/fintoc/v2/managers/transfers_manager.rb
 - lib/fintoc/v2/resources/account.rb
 - lib/fintoc/v2/resources/account_number.rb
@@ -110,6 +111,7 @@ files:
 - lib/fintoc/v2/resources/movement.rb
 - lib/fintoc/v2/resources/onboarding.rb
 - lib/fintoc/v2/resources/transfer.rb
+- lib/fintoc/v2/resources/transfer_batch.rb
 - lib/fintoc/version.rb
 - lib/fintoc/webhook_signature.rb
 - lib/tasks/simplecov_config.rb