tappay_ruby 0.15.6 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 698fedb546a5dbd45b8892bb0af16c052e0ebf8fa04c108e6d7694da8ef7fa27
-  data.tar.gz: 91ef921ee685b23b8abc55939dc982dc80e1dc896cca1180e819f64a639f4bbb
+  metadata.gz: 6f3adfe744edc8cb643d061174b024eb6c97a6da31adab49fb8bc9248dc06182
+  data.tar.gz: cadd30812520dfc51f99c6efbd8c1dae7eaee132c8899d71723f6dd21c5726b8
 SHA512:
-  metadata.gz: 460626eaf846e577ddcb5337d650baef56eefaf03774c591a57689f211cce33e769a0123f85c33ba68d71b6bd8b1f4fe3a370a0937480ee4c2172827e6dea887
-  data.tar.gz: 114325d5d941c3f90b7ee48b145ae14ccabacedcbcfe83e109ce2801257f70284f16a5595ba96424106121503d2ddc384c90f42b034ceef82215c0bfd8cdb605
+  metadata.gz: e75a79fba3503a549125f7b380c796a5f9333466b6cbb1b88938f9ecb22700be27a357c6b3a90d62387fc6ae6266db0c9ec0d8a614d4ec3858719449d5816db5
+  data.tar.gz: f5d171f41699ebe5dad2820e1e60ab3a8c5dfb72d784d0befcf4a10c0571cf8c5e70935e6de3185123f5857dd3a680d332ba4fd2789202950e2f9c87df77979d

data/README.md

@@ -186,6 +186,36 @@ payment = Tappay::JkoPay::Pay.new(payment_options)
 result = payment.execute
 ```
 
+### Transaction Query
+
+Query transaction records with required time range:
+
+```ruby
+# Query transactions within a specific time range
+result = Tappay::Transaction::Query.new(
+  time: {
+    start_time: 1706198400,  # Unix timestamp for start time
+    end_time: 1706284800     # Unix timestamp for end time
+  },
+  order_number: 'ORDER123',  # Optional: filter by order number
+  records_per_page: 50,      # Optional: default is 50
+  page: 0,                   # Optional: default is 0
+  order_by: {               # Optional: sort results
+    attribute: 'time',
+    is_descending: true
+  }
+).execute
+
+# Access the results
+result[:trade_records].each do |record|
+  puts "Transaction ID: #{record[:rec_trade_id]}"
+  puts "Amount: #{record[:amount]}"
+  puts "Status: #{record[:record_status]}"
+end
+```
+
+Note: The `time` parameter with both `start_time` and `end_time` is required for querying transactions.
+
 ### Error Handling
 
 The gem provides comprehensive error handling:

data/lib/tappay/transaction/query.rb

@@ -3,11 +3,11 @@
 module Tappay
   module Transaction
     class Query
-      def initialize(order_number:, records_per_page: 50, page: 0, time: nil, order_by: nil)
+      def initialize(time:, order_number: nil, records_per_page: 50, page: 0, order_by: nil)
+        @time = validate_time!(time)
         @order_number = order_number
         @records_per_page = records_per_page
         @page = page
-        @time = time
         @order_by = order_by
       end
 
@@ -30,6 +30,7 @@ module Tappay
 
       def request_params
         {
+          partner_key: Tappay.configuration.partner_key,
           records_per_page: @records_per_page,
           page: @page,
           filters: filters,
@@ -44,6 +45,22 @@ module Tappay
         }.compact
       end
 
+      def validate_time!(time)
+        unless time.is_a?(Hash) && time[:start_time] && time[:end_time]
+          raise Tappay::ValidationError, "time parameter must include start_time and end_time"
+        end
+
+        unless time[:start_time].is_a?(Integer) && time[:end_time].is_a?(Integer)
+          raise Tappay::ValidationError, "start_time and end_time must be Unix timestamps (integers)"
+        end
+
+        if time[:start_time] > time[:end_time]
+          raise Tappay::ValidationError, "start_time cannot be later than end_time"
+        end
+
+        time
+      end
+
       def parse_trade_records(records)
         return [] unless records&.any?
 

data/lib/tappay/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tappay
-  VERSION = "0.15.6"
+  VERSION = "0.16.0"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: tappay_ruby
 version: !ruby/object:Gem::Version
-  version: 0.15.6
+  version: 0.16.0
 platform: ruby
 authors:
 - Zac
 bindir: exe
 cert_chain: []
-date: 2025-01-23 00:00:00.000000000 Z
+date: 2025-01-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty