payabli 2.1.5 → 2.2.15

data/lib/payabli/export/client.rb

@@ -28,7 +28,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_applications(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -76,7 +76,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_batch_details(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -124,7 +124,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_batch_details_org(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -172,7 +172,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_batches(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -220,7 +220,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_batches_org(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -268,7 +268,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_batches_out(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -316,7 +316,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_batches_out_org(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -364,7 +364,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_bills(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -412,7 +412,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_bills_org(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -460,7 +460,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_chargebacks(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -508,7 +508,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_chargebacks_org(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -556,7 +556,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_customers(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -604,7 +604,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_customers_org(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -652,7 +652,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_invoices(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -700,7 +700,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_invoices_org(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -748,7 +748,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_organizations(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -796,7 +796,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_payout(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -844,7 +844,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_payout_org(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -892,7 +892,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_paypoints(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -940,7 +940,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_settlements(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -988,7 +988,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_settlements_org(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -1036,7 +1036,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_subscriptions(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -1084,7 +1084,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_subscriptions_org(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -1133,7 +1133,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_transactions(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -1182,7 +1182,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_transactions_org(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -1232,7 +1232,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_transfer_details(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters sort_by]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -1281,7 +1281,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_transfers(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters sort_by]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -1330,7 +1330,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_vendors(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)
@@ -1378,7 +1378,7 @@ module Payabli
       #
       # @return [Hash[String, Object]]
       def export_vendors_org(request_options: {}, **params)
-        params = Payabli::Internal::Types::Utils.symbolize_keys(params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         query_param_names = %i[columns_export from_record limit_record parameters]
         query_params = {}
         query_params["columnsExport"] = params[:columns_export] if params.key?(:columns_export)

data/lib/payabli/hosted_payment_pages/client.rb

@@ -25,6 +25,7 @@ module Payabli
       #
       # @return [Payabli::Types::PayabliPages]
       def load_page(request_options: {}, **params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "GET",
@@ -62,13 +63,18 @@ module Payabli
       #
       # @return [Payabli::Types::PayabliApiResponse00Responsedatanonobject]
       def new_page(request_options: {}, **params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         path_param_names = %i[entry]
         body_params = params.except(*path_param_names)
 
+        headers = {}
+        headers["idempotencyKey"] = params[:idempotency_key] if params[:idempotency_key]
+
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "POST",
           path: "Paypoint/#{params[:entry]}",
+          headers: headers,
           body: Payabli::Types::PayabliPages.new(body_params).to_h,
           request_options: request_options
         )
@@ -100,6 +106,7 @@ module Payabli
       #
       # @return [Payabli::Types::PayabliApiResponse00Responsedatanonobject]
       def save_page(request_options: {}, **params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         request = Payabli::Internal::JSON::Request.new(
           base_url: request_options[:base_url],
           method: "PUT",

data/lib/payabli/import/client.rb

@@ -24,6 +24,7 @@ module Payabli
       #
       # @return [Payabli::Types::PayabliApiResponseImport]
       def import_bills(request_options: {}, **params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         body = Internal::Multipart::FormData.new
 
         body.add_part(params[:file].to_form_data_part(name: "file")) if params[:file]
@@ -64,6 +65,7 @@ module Payabli
       #
       # @return [Payabli::Types::PayabliApiResponseImport]
       def import_customer(request_options: {}, **params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         body = Internal::Multipart::FormData.new
 
         body.add_part(params[:file].to_form_data_part(name: "file")) if params[:file]
@@ -103,6 +105,7 @@ module Payabli
       #
       # @return [Payabli::Types::PayabliApiResponseImport]
       def import_vendor(request_options: {}, **params)
+        params = Payabli::Internal::Types::Utils.normalize_keys(params)
         body = Internal::Multipart::FormData.new
 
         body.add_part(params[:file].to_form_data_part(name: "file")) if params[:file]

data/lib/payabli/internal/http/base_request.rb

@@ -22,6 +22,12 @@ module Payabli
           @request_options = request_options
         end
 
+        # @return [Hash] The query parameters merged with additional query parameters from request options.
+        def encode_query
+          additional_query = @request_options&.dig(:additional_query_parameters) || @request_options&.dig("additional_query_parameters") || {}
+          @query.merge(additional_query)
+        end
+
         # Child classes should implement:
         # - encode_headers: Returns the encoded HTTP request headers.
         # - encode_body: Returns the encoded HTTP request body.

data/lib/payabli/internal/http/raw_client.rb

@@ -5,6 +5,18 @@ module Payabli
     module Http
       # @api private
       class RawClient
+        # Default HTTP status codes that trigger a retry
+        RETRYABLE_STATUSES = [408, 429, 500, 502, 503, 504, 521, 522, 524].freeze
+        # Initial delay between retries in seconds
+        INITIAL_RETRY_DELAY = 0.5
+        # Maximum delay between retries in seconds
+        MAX_RETRY_DELAY = 60.0
+        # Jitter factor for randomizing retry delays (20%)
+        JITTER_FACTOR = 0.2
+
+        # @return [String] The base URL for requests
+        attr_reader :base_url
+
         # @param base_url [String] The base url for the request.
         # @param max_retries [Integer] The number of times to retry a failed request, defaults to 2.
         # @param timeout [Float] The timeout for the request, defaults to 60.0 seconds.
@@ -24,30 +36,106 @@ module Payabli
         # @return [HTTP::Response] The HTTP response.
         def send(request)
           url = build_url(request)
+          attempt = 0
+          response = nil
 
-          http_request = build_http_request(
-            url:,
-            method: request.method,
-            headers: request.encode_headers,
-            body: request.encode_body
-          )
+          loop do
+            http_request = build_http_request(
+              url:,
+              method: request.method,
+              headers: request.encode_headers,
+              body: request.encode_body
+            )
+
+            conn = connect(url)
+            conn.open_timeout = @timeout
+            conn.read_timeout = @timeout
+            conn.write_timeout = @timeout
+            conn.continue_timeout = @timeout
+
+            response = conn.request(http_request)
 
-          conn = connect(url)
-          conn.open_timeout = @timeout
-          conn.read_timeout = @timeout
-          conn.write_timeout = @timeout
-          conn.continue_timeout = @timeout
+            break unless should_retry?(response, attempt)
 
-          conn.request(http_request)
+            delay = retry_delay(response, attempt)
+            sleep(delay)
+            attempt += 1
+          end
+
+          response
+        end
+
+        # Determines if a request should be retried based on the response status code.
+        # @param response [Net::HTTPResponse] The HTTP response.
+        # @param attempt [Integer] The current retry attempt (0-indexed).
+        # @return [Boolean] Whether the request should be retried.
+        def should_retry?(response, attempt)
+          return false if attempt >= @max_retries
+
+          status = response.code.to_i
+          RETRYABLE_STATUSES.include?(status)
+        end
+
+        # Calculates the delay before the next retry attempt using exponential backoff with jitter.
+        # Respects Retry-After header if present.
+        # @param response [Net::HTTPResponse] The HTTP response.
+        # @param attempt [Integer] The current retry attempt (0-indexed).
+        # @return [Float] The delay in seconds before the next retry.
+        def retry_delay(response, attempt)
+          # Check for Retry-After header (can be seconds or HTTP date)
+          retry_after = response["Retry-After"]
+          if retry_after
+            delay = parse_retry_after(retry_after)
+            return [delay, MAX_RETRY_DELAY].min if delay&.positive?
+          end
+
+          # Exponential backoff with jitter: base_delay * 2^attempt
+          base_delay = INITIAL_RETRY_DELAY * (2**attempt)
+          add_jitter([base_delay, MAX_RETRY_DELAY].min)
+        end
+
+        # Parses the Retry-After header value.
+        # @param value [String] The Retry-After header value (seconds or HTTP date).
+        # @return [Float, nil] The delay in seconds, or nil if parsing fails.
+        def parse_retry_after(value)
+          # Try parsing as integer (seconds)
+          seconds = Integer(value, exception: false)
+          return seconds.to_f if seconds
+
+          # Try parsing as HTTP date
+          begin
+            retry_time = Time.httpdate(value)
+            delay = retry_time - Time.now
+            delay.positive? ? delay : nil
+          rescue ArgumentError
+            nil
+          end
+        end
+
+        # Adds random jitter to a delay value.
+        # @param delay [Float] The base delay in seconds.
+        # @return [Float] The delay with jitter applied.
+        def add_jitter(delay)
+          jitter = delay * JITTER_FACTOR * (rand - 0.5) * 2
+          [delay + jitter, 0].max
         end
 
         # @param request [Payabli::Internal::Http::BaseRequest] The HTTP request.
         # @return [URI::Generic] The URL.
         def build_url(request)
+          encoded_query = request.encode_query
+
+          # If the path is already an absolute URL, use it directly
+          if request.path.start_with?("http://", "https://")
+            url = request.path
+            url = "#{url}?#{encode_query(encoded_query)}" if encoded_query&.any?
+            return URI.parse(url)
+          end
+
           path = request.path.start_with?("/") ? request.path[1..] : request.path
           base = request.base_url || @base_url
           url = "#{base.chomp("/")}/#{path}"
-          url = "#{url}?#{encode_query(request.query)}" if request.query&.any?
+          url = "#{url}?#{encode_query(encoded_query)}" if encoded_query&.any?
           URI.parse(url)
         end
 
@@ -92,7 +180,9 @@ module Payabli
 
           http = Net::HTTP.new(url.host, port)
           http.use_ssl = is_https
-          http.max_retries = @max_retries
+          # NOTE: We handle retries at the application level with HTTP status code awareness,
+          # so we set max_retries to 0 to disable Net::HTTP's built-in network-level retries.
+          http.max_retries = 0
           http
         end
 

data/lib/payabli/internal/types/model.rb

@@ -161,7 +161,7 @@ module Payabli
         end
 
         def to_h
-          self.class.fields.merge(self.class.extra_fields).each_with_object({}) do |(name, field), acc|
+          result = self.class.fields.merge(self.class.extra_fields).each_with_object({}) do |(name, field), acc|
             # If there is a value present in the data, use that value
             # If there is a `nil` value present in the data, and it is optional but NOT nullable, exclude key altogether
             # If there is a `nil` value present in the data, and it is optional and nullable, use the nil value
@@ -178,6 +178,14 @@ module Payabli
 
             acc[field.api_name] = value
           end
+
+          # Inject union discriminant if this instance was coerced from a discriminated union
+          # and the discriminant key is not already present in the result
+          discriminant_key = instance_variable_get(:@_fern_union_discriminant_key)
+          discriminant_value = instance_variable_get(:@_fern_union_discriminant_value)
+          result[discriminant_key] = discriminant_value if discriminant_key && discriminant_value && !result.key?(discriminant_key)
+
+          result
         end
 
         def ==(other)

data/lib/payabli/internal/types/union.rb

@@ -63,11 +63,27 @@ module Payabli
         # @return [Class]
         private def resolve_member(value)
           if discriminated? && value.is_a?(::Hash)
-            discriminant_value = value.fetch(@discriminant, nil)
+            # Try both symbol and string keys for the discriminant
+            discriminant_value = value.fetch(@discriminant, nil) || value.fetch(@discriminant.to_s, nil)
 
             return if discriminant_value.nil?
 
-            members.to_h[discriminant_value]&.call
+            # Convert to string for consistent comparison
+            discriminant_str = discriminant_value.to_s
+
+            # First try exact match
+            members_hash = members.to_h
+            result = members_hash[discriminant_str]&.call
+            return result if result
+
+            # Try case-insensitive match as fallback
+            discriminant_lower = discriminant_str.downcase
+            matching_keys = members_hash.keys.select { |k| k.to_s.downcase == discriminant_lower }
+
+            # Only use case-insensitive match if exactly one key matches (avoid ambiguity)
+            return members_hash[matching_keys.first]&.call if matching_keys.length == 1
+
+            nil
           else
             # First try exact type matching
             result = members.find do |_key, mem|
@@ -117,7 +133,19 @@ module Payabli
             raise Errors::TypeError, "could not resolve to member of union #{self}"
           end
 
-          Utils.coerce(type, value, strict: strict)
+          coerced = Utils.coerce(type, value, strict: strict)
+
+          # For discriminated unions, store the discriminant info on the coerced instance
+          # so it can be injected back during serialization (to_h)
+          if discriminated? && value.is_a?(::Hash) && coerced.is_a?(Model)
+            discriminant_value = value.fetch(@discriminant, nil) || value.fetch(@discriminant.to_s, nil)
+            if discriminant_value
+              coerced.instance_variable_set(:@_fern_union_discriminant_key, @discriminant.to_s)
+              coerced.instance_variable_set(:@_fern_union_discriminant_value, discriminant_value)
+            end
+          end
+
+          coerced
         end
 
         # Parse JSON string and coerce to the correct union member type

data/lib/payabli/internal/types/utils.rb

@@ -76,8 +76,8 @@ module Payabli
           in Module
             case type
             in ->(t) {
-                 t.singleton_class.included_modules.include?(Enum) ||
-                   t.singleton_class.included_modules.include?(Union)
+                 t.singleton_class.include?(Enum) ||
+                   t.singleton_class.include?(Union)
                }
               return type.coerce(value, strict: strict)
             else
@@ -95,6 +95,21 @@ module Payabli
         def self.symbolize_keys(hash)
           hash.transform_keys(&:to_sym)
         end
+
+        # Converts camelCase keys to snake_case symbols
+        # This allows SDK methods to accept both snake_case and camelCase keys
+        # e.g., { refundMethod: ... } becomes { refund_method: ... }
+        #
+        # @param hash [Hash]
+        # @return [Hash]
+        def self.normalize_keys(hash)
+          hash.transform_keys do |key|
+            key_str = key.to_s
+            # Convert camelCase to snake_case
+            snake_case = key_str.gsub(/([a-z\d])([A-Z])/, '\1_\2').downcase
+            snake_case.to_sym
+          end
+        end
       end
     end
   end