pinelabs 0.1.0

data/lib/pinelabs/payouts/types/update_scheduled_payout_request.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinelabs
+  module Payouts
+    module Types
+      class UpdateScheduledPayoutRequest < Internal::Types::Model
+        field :payment_reference_id, -> { String }, optional: false, nullable: false, api_name: "paymentReferenceId"
+        field :schedule_at, -> { String }, optional: true, nullable: false, api_name: "scheduleAt"
+      end
+    end
+  end
+end

data/lib/pinelabs/refunds/client.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Pinelabs
+  module Refunds
+    class Client
+      # @param client [Pinelabs::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # Creates a refund against a completed order.
+      #
+      # **Important notes:**
+      # - For a full refund, all IMEI numbers associated with products are automatically blocked.
+      # - For a partial refund, you must specify the IMEI number that needs to be blocked.
+      # - Refunds of less than ₹1 are not supported.
+      # - For a given day, the total sale amount must be greater than or equal to the total refund amount.
+      #
+      # @param request_options [Hash]
+      # @param params [Pinelabs::Refunds::Types::CreateRefundRequest]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :order_id
+      #
+      # @return [Pinelabs::Types::RefundResponse]
+      def create_refund(request_options: {}, **params)
+        params = Pinelabs::Internal::Types::Utils.normalize_keys(params)
+        request_data = Pinelabs::Refunds::Types::CreateRefundRequest.new(params).to_h
+        non_body_param_names = ["order_id"]
+        body = request_data.except(*non_body_param_names)
+
+        request = Pinelabs::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "api/pay/v1/refunds/#{URI.encode_uri_component(params[:order_id].to_s)}",
+          body: body,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Pinelabs::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Pinelabs::Types::RefundResponse.load(response.body)
+        else
+          error_class = Pinelabs::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+    end
+  end
+end

data/lib/pinelabs/refunds/types/create_refund_request.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Pinelabs
+  module Refunds
+    module Types
+      class CreateRefundRequest < Internal::Types::Model
+        field :order_id, -> { String }, optional: false, nullable: false
+        field :merchant_order_reference, -> { String }, optional: false, nullable: false
+        field :order_amount, -> { Pinelabs::Refunds::Types::CreateRefundRequestOrderAmount }, optional: false, nullable: false
+        field :merchant_metadata, -> { Internal::Types::Hash[String, String] }, optional: true, nullable: false
+        field :products, -> { Internal::Types::Array[Pinelabs::Refunds::Types::CreateRefundRequestProductsItem] }, optional: true, nullable: false
+        field :split_info, -> { Pinelabs::Refunds::Types::CreateRefundRequestSplitInfo }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/pinelabs/refunds/types/create_refund_request_order_amount.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinelabs
+  module Refunds
+    module Types
+      # The refund amount details.
+      class CreateRefundRequestOrderAmount < Internal::Types::Model
+        field :value, -> { Integer }, optional: false, nullable: false
+        field :currency, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/pinelabs/refunds/types/create_refund_request_products_item.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinelabs
+  module Refunds
+    module Types
+      class CreateRefundRequestProductsItem < Internal::Types::Model
+        field :product_code, -> { String }, optional: true, nullable: false
+        field :imei_number, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/pinelabs/refunds/types/create_refund_request_split_info.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinelabs
+  module Refunds
+    module Types
+      # Split settlement information for refunds involving split payments.
+      class CreateRefundRequestSplitInfo < Internal::Types::Model
+        field :split_type, -> { String }, optional: true, nullable: false
+        field :split_details, -> { Internal::Types::Array[Pinelabs::Refunds::Types::CreateRefundRequestSplitInfoSplitDetailsItem] }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/pinelabs/refunds/types/create_refund_request_split_info_split_details_item.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinelabs
+  module Refunds
+    module Types
+      class CreateRefundRequestSplitInfoSplitDetailsItem < Internal::Types::Model
+        field :split_merchant_id, -> { String }, optional: true, nullable: false
+        field :merchant_settlement_reference, -> { String }, optional: true, nullable: false
+        field :amount, -> { Pinelabs::Refunds::Types::CreateRefundRequestSplitInfoSplitDetailsItemAmount }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/pinelabs/refunds/types/create_refund_request_split_info_split_details_item_amount.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinelabs
+  module Refunds
+    module Types
+      class CreateRefundRequestSplitInfoSplitDetailsItemAmount < Internal::Types::Model
+        field :value, -> { Integer }, optional: true, nullable: false
+        field :currency, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/pinelabs/settlements/client.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+module Pinelabs
+  module Settlements
+    class Client
+      # @param client [Pinelabs::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # Retrieves all settlements within a specified date range.
+      #
+      # **Notes:**
+      # - Maximum date range for retrieving settlement data is 60 days.
+      # - API supports a maximum of 10 records per page, one page at a time.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :start_date
+      # @option params [String] :end_date
+      # @option params [String, nil] :page
+      # @option params [String, nil] :per_page
+      #
+      # @return [Pinelabs::Types::ListSettlementsResponse]
+      def get_all_settlements(request_options: {}, **params)
+        params = Pinelabs::Internal::Types::Utils.normalize_keys(params)
+        query_param_names = %i[start_date end_date page per_page]
+        query_params = {}
+        query_params["start_date"] = params[:start_date] if params.key?(:start_date)
+        query_params["end_date"] = params[:end_date] if params.key?(:end_date)
+        query_params["page"] = params[:page] if params.key?(:page)
+        query_params["per_page"] = params[:per_page] if params.key?(:per_page)
+        params.except(*query_param_names)
+
+        request = Pinelabs::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "api/settlements/v1/list",
+          query: query_params,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Pinelabs::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Pinelabs::Types::ListSettlementsResponse.load(response.body)
+        else
+          error_class = Pinelabs::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Retrieves detailed settlement information for a specific UTR (Unique Transaction Reference).
+      #
+      # **Notes:**
+      # - Maximum date range for retrieving settlement data is 60 days.
+      # - API supports a maximum of 10 records per page, one page at a time.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :utr
+      # @option params [String, nil] :page
+      # @option params [String, nil] :per_page
+      #
+      # @return [Pinelabs::Types::SettlementByUtrResponse]
+      def get_settlements_by_utr(request_options: {}, **params)
+        params = Pinelabs::Internal::Types::Utils.normalize_keys(params)
+        query_param_names = %i[page per_page]
+        query_params = {}
+        query_params["page"] = params[:page] if params.key?(:page)
+        query_params["per_page"] = params[:per_page] if params.key?(:per_page)
+        params = params.except(*query_param_names)
+
+        request = Pinelabs::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "api/settlements/v1/detail/#{URI.encode_uri_component(params[:utr].to_s)}",
+          query: query_params,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Pinelabs::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Pinelabs::Types::SettlementByUtrResponse.load(response.body)
+        else
+          error_class = Pinelabs::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+    end
+  end
+end

data/lib/pinelabs/settlements/types/get_all_settlements_request.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Pinelabs
+  module Settlements
+    module Types
+      class GetAllSettlementsRequest < Internal::Types::Model
+        field :start_date, -> { String }, optional: false, nullable: false
+        field :end_date, -> { String }, optional: false, nullable: false
+        field :page, -> { String }, optional: true, nullable: false
+        field :per_page, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/pinelabs/settlements/types/get_settlements_by_utr_request.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinelabs
+  module Settlements
+    module Types
+      class GetSettlementsByUtrRequest < Internal::Types::Model
+        field :utr, -> { String }, optional: false, nullable: false
+        field :page, -> { String }, optional: true, nullable: false
+        field :per_page, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/pinelabs/split_settlements/client.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module Pinelabs
+  module SplitSettlements
+    class Client
+      # @param client [Pinelabs::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # Releases a held split settlement for a specific order.
+      #
+      # **Notes:**
+      # - This API can only be used for orders with split settlements.
+      # - Use the Create Orders API to create a split settlement order.
+      #
+      # @param request_options [Hash]
+      # @param params [Pinelabs::SplitSettlements::Types::ReleaseSettlementRequest]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :order_id
+      # @option params [String] :settlement_id
+      #
+      # @return [Pinelabs::Types::SplitSettlementResponse]
+      def release_settlement(request_options: {}, **params)
+        params = Pinelabs::Internal::Types::Utils.normalize_keys(params)
+        request_data = Pinelabs::SplitSettlements::Types::ReleaseSettlementRequest.new(params).to_h
+        non_body_param_names = %w[orderId settlementId]
+        body = request_data.except(*non_body_param_names)
+
+        request = Pinelabs::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "PATCH",
+          path: "api/pay/v1/orders/#{URI.encode_uri_component(params[:order_id].to_s)}/settlementId/#{URI.encode_uri_component(params[:settlement_id].to_s)}/release",
+          body: body,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Pinelabs::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Pinelabs::Types::SplitSettlementResponse.load(response.body)
+        else
+          error_class = Pinelabs::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Cancels a held split settlement for a specific order.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :order_id
+      # @option params [String] :settlement_id
+      #
+      # @return [Pinelabs::Types::SplitSettlementResponse]
+      def cancel_settlement(request_options: {}, **params)
+        params = Pinelabs::Internal::Types::Utils.normalize_keys(params)
+        request = Pinelabs::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "PATCH",
+          path: "api/pay/v1/orders/#{URI.encode_uri_component(params[:order_id].to_s)}/settlementId/#{URI.encode_uri_component(params[:settlement_id].to_s)}/cancel",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Pinelabs::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Pinelabs::Types::SplitSettlementResponse.load(response.body)
+        else
+          error_class = Pinelabs::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+    end
+  end
+end

data/lib/pinelabs/split_settlements/types/cancel_settlement_request.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Pinelabs
+  module SplitSettlements
+    module Types
+      class CancelSettlementRequest < Internal::Types::Model
+        field :order_id, -> { String }, optional: false, nullable: false, api_name: "orderId"
+        field :settlement_id, -> { String }, optional: false, nullable: false, api_name: "settlementId"
+      end
+    end
+  end
+end

data/lib/pinelabs/split_settlements/types/release_settlement_request.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinelabs
+  module SplitSettlements
+    module Types
+      class ReleaseSettlementRequest < Internal::Types::Model
+        field :order_id, -> { String }, optional: false, nullable: false, api_name: "orderId"
+        field :settlement_id, -> { String }, optional: false, nullable: false, api_name: "settlementId"
+        field :release_amount, -> { Pinelabs::SplitSettlements::Types::ReleaseSettlementRequestReleaseAmount }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/pinelabs/split_settlements/types/release_settlement_request_release_amount.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Pinelabs
+  module SplitSettlements
+    module Types
+      # The amount to release from the held settlement.
+      class ReleaseSettlementRequestReleaseAmount < Internal::Types::Model
+        field :value, -> { Integer }, optional: false, nullable: false
+        field :currency, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end