fintoc 1.4.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 125043d067ac8281433e37d16a8376d3b25f581b3a4fc7f31b30e1b96623e570
-  data.tar.gz: 909b347cacb35dfd8e495be517e7c6320ce8aa9930c592215651cd813636e256
+  metadata.gz: 18a0e42f4e865dc3c9a5effb821f75cd8c0df2fd1cc74d438b70cb25197db7c3
+  data.tar.gz: d88a84f2581d693274770e4de27df625851116d896538f519eb4184f061e92aa
 SHA512:
-  metadata.gz: b4fe705e12286af83f27d6fbdae257f334f65b98122d16cb187b6d2c326b10c482356d30e4962faa2395e3e0199d83fc287b2d40a213cf8ff3f780eda714c7c7
-  data.tar.gz: 8ff1d5bb3d658081d9dc3086ab8a2c0b01051c7cd5a30776a150960365191c33879016f5fb2738e63e15c9ca767adc1a5ee48c915f92b40837351c284f988312
+  metadata.gz: 47a1a45fdd60049a311cc7aa6458c5942de82a4a2ae4a05139d3ebe92f96da5a2b8bdff7544d5195536575cc7fa209b54092cfaa3c5e0caf2a1e463b1389fed8
+  data.tar.gz: 7e8677a9c72a33803a98c44ac8adedc86ed835d9bfa99505f8c17c9e8d77e0b8b6c41bbe1ad5681feefff7e88c995eb6a710b61ad8d573af29696777e13f3fe2

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    fintoc (1.4.0)
+    fintoc (1.6.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/base_client.rb

@@ -46,6 +46,8 @@ module Fintoc
       proc do |resource, form: nil, **kwargs|
         parameters = form ? { form: build_form(form) } : params(method, **kwargs)
         response = make_request(method, resource, parameters, version:, use_jws:, idempotency_key:)
+        next nil if response.status.no_content?
+
         content = JSON.parse(response.body, symbolize_names: true)
 
         if response.status.client_error? || response.status.server_error?

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

@@ -1,8 +1,10 @@
 require 'fintoc/base_client'
 require 'fintoc/v2/managers/entities_manager'
+require 'fintoc/v2/managers/recipients_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'
 
@@ -13,6 +15,10 @@ module Fintoc
         @entities ||= Managers::EntitiesManager.new(self)
       end
 
+      def recipients
+        @recipients ||= Managers::RecipientsManager.new(self)
+      end
+
       def accounts
         @accounts ||= Managers::AccountsManager.new(self)
       end
@@ -25,6 +31,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/recipients_manager.rb

@@ -0,0 +1,47 @@
+require 'fintoc/v2/resources/recipient'
+
+module Fintoc
+  module V2
+    module Managers
+      class RecipientsManager
+        def initialize(client)
+          @client = client
+        end
+
+        def create(entity_id:, account_number:, holder_name:, idempotency_key: nil, **params)
+          data = @client.post(version: :v2, idempotency_key:).call(
+            'recipients', entity_id:, account_number:, holder_name:, **params
+          )
+          build_recipient(data)
+        end
+
+        def get(recipient_id)
+          data = @client.get(version: :v2).call("recipients/#{recipient_id}")
+          build_recipient(data)
+        end
+
+        def list(**params)
+          @client.get(version: :v2).call('recipients', **params).map do |data|
+            build_recipient(data)
+          end
+        end
+
+        def update(recipient_id, idempotency_key: nil, **params)
+          data = @client.patch(version: :v2, idempotency_key:)
+                        .call("recipients/#{recipient_id}", **params)
+          build_recipient(data)
+        end
+
+        def delete(recipient_id)
+          @client.delete(version: :v2).call("recipients/#{recipient_id}")
+        end
+
+        private
+
+        def build_recipient(data)
+          Fintoc::V2::Recipient.new(**data, client: @client)
+        end
+      end
+    end
+  end
+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/recipient.rb

@@ -0,0 +1,62 @@
+module Fintoc
+  module V2
+    class Recipient
+      attr_reader :id, :object, :account_number, :account_type, :alias, :created_at,
+                  :email, :holder_id, :holder_name, :holder_type, :updated_at, :institution
+
+      def initialize(
+        id:, object:, account_number:, account_type:, holder_name:, institution:,
+        created_at: nil, email: nil, holder_id: nil, holder_type: nil,
+        updated_at: nil, client: nil, **attributes
+      )
+        @id = id
+        @object = object
+        @account_number = account_number
+        @account_type = account_type
+        @alias = attributes[:alias]
+        @created_at = created_at
+        @email = email
+        @holder_id = holder_id
+        @holder_name = holder_name
+        @holder_type = holder_type
+        @updated_at = updated_at
+        @institution = institution
+        @client = client
+      end
+
+      def refresh
+        refresh_from_recipient(@client.recipients.get(@id))
+      end
+
+      def update(idempotency_key: nil, **params)
+        refresh_from_recipient(@client.recipients.update(@id, idempotency_key:, **params))
+      end
+
+      def delete
+        @client.recipients.delete(@id)
+      end
+
+      private
+
+      def refresh_from_recipient(recipient)
+        unless recipient.id == @id
+          raise ArgumentError, 'Recipient must be the same instance'
+        end
+
+        @object = recipient.object
+        @account_number = recipient.account_number
+        @account_type = recipient.account_type
+        @alias = recipient.alias
+        @created_at = recipient.created_at
+        @email = recipient.email
+        @holder_id = recipient.holder_id
+        @holder_name = recipient.holder_name
+        @holder_type = recipient.holder_type
+        @updated_at = recipient.updated_at
+        @institution = recipient.institution
+
+        self
+      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.6.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fintoc
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.6.0
 platform: ruby
 authors:
 - Juan Ca Sardin
@@ -100,7 +100,9 @@ files:
 - lib/fintoc/v2/managers/entities_manager.rb
 - lib/fintoc/v2/managers/movements_manager.rb
 - lib/fintoc/v2/managers/onboardings_manager.rb
+- lib/fintoc/v2/managers/recipients_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
@@ -109,7 +111,9 @@ files:
 - lib/fintoc/v2/resources/entity.rb
 - lib/fintoc/v2/resources/movement.rb
 - lib/fintoc/v2/resources/onboarding.rb
+- lib/fintoc/v2/resources/recipient.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