tappay_ruby 0.15.7 → 0.16.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a329206f8149dcee28160ef08fe91ff68105eb34a75a3d1c8472ed7f4cdc6a3e
-  data.tar.gz: 130d3c8f4733f126fc8ca6f548757583c0727a20b9c868a24d64bba1190202fb
+  metadata.gz: 15c44ff4750b4c720db7deb88827b0472dd40ee4c98ca1651bd4b54b25d31566
+  data.tar.gz: 199a823aa6332a3d12769bdf9b0ef32d938aba6594f3365d1d8a3212d3475837
 SHA512:
-  metadata.gz: 6a4a743872849f9d5963bc9a617a594677c47423bff870522f5a6dff650572bfc21cc7464c3ad8a39f3856a24fb04ab9650e2d320771e753f5ddf3f0c70dc14f
-  data.tar.gz: 8abbe504384923079ac7d813e409314e746e0b21ae72cb50f008fee2b0c69ba269791654ed569e8584e24a8af5b0657e244bf3332b59a41cd1f51b2c91d6e470
+  metadata.gz: 3c8730263b0071ebdcee35dc634eb5abd7f863a37ff4c2132511579ae0988496d22236a3467215365157fea82fac33aca99fc4825606020787b4591b4463a33d
+  data.tar.gz: '095757caf7c639691c14269e86bb246a01f90083cf1115a725381061da3a7daf23021c3861c6d1ca4e189e2b5ea48f52592013d3daa6a2628e2bfd5e075b001e'

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/client.rb

@@ -42,7 +42,9 @@ module Tappay
       case @response.code
       when 200
         data = parse_response
-        unless data['status'].zero?
+        status = data['status']
+        # For transaction queries, status 2 means no records found, which is a valid response
+        unless status.zero? || (status == 2 && @response.request.uri.path.include?('/tpc/transaction/query'))
           raise APIError.new(data['status'], data['msg'])
         end
       when 400

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
 
@@ -45,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.7"
+  VERSION = "0.16.1"
 end

metadata

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