zai_payment 2.6.0 → 2.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c0f57b605f7a885cb3fcbb0e8b4554d782fd298444d49b57732d0214b0a8a14
-  data.tar.gz: 014e39994a1d9051b28d90deaec6407cd638de2ed7995509c0196ec25da6805a
+  metadata.gz: 21a2f54b50cab4893520a396d33149bd53daf27aa6023fcc2b720fd2c2100e89
+  data.tar.gz: 736516f787ba6acb1d3c40222530606dae8be04e0c2ac222d2f5a367815ad26d
 SHA512:
-  metadata.gz: 24b3058ec5ee8e06b06f9444175a6a86e455a3ba08b2a5f40df990f5ab7beae812d05225e62802b1fd2e69acc37f9364f33d1dc89f37fb045c150c52ae18fd04
-  data.tar.gz: a2e4715f2f8e8630fe4ea03d13ad83318acf4fd09737266de497ecc889af22af84fc7edd0b8d6846658ebc50d4c49ed8d36ae0144190a0d79aeae88d6e398bce
+  metadata.gz: 0c05de5aa53f36e794f65e0dfb421b997db67c039700b9ea62d96d38abace81d44f6bd7f22e2b98ed2885365c78c3c8ebdb2fde14a737844784379a3f64874d6
+  data.tar.gz: 3731f8af6454bf2ae233e47a8716e06c1290912989a2ba4d9a728341845ebb5d01d0a9e7d903e0fd6f07c38cbbccd9a3931f56d6b1cb84f3e20cb5c0d50f2307

data/changelog.md

@@ -1,5 +1,31 @@
 ## [Released]
 
+## [2.6.1] - 2025-11-03
+
+### Changed
+- **Wallet Accounts Response Structure**: Updated to match actual API response format 🔄
+  - Response now properly returns nested `wallet_accounts` object with complete structure
+  - Added `wallet_accounts` to `Response#data` automatic extraction
+  - The `Response#data` method now automatically extracts the `wallet_accounts` object for cleaner API usage
+  - Updated response includes: `id`, `active`, `created_at`, `updated_at`, `balance`, `currency`
+  - Enhanced `links` structure with: `self`, `users`, `batch_transactions`, `transactions`, `bpay_details`, `npp_details`, `virtual_accounts`
+
+### Improved
+- **API Consistency**: `response.data` now works consistently across all resources
+  - Before: `response.data['wallet_accounts']['balance']` (manual extraction)
+  - After: `response.data['balance']` (automatic extraction)
+- **Documentation**: Updated all wallet_account documentation and examples
+  - Updated `docs/users.md` with complete wallet account response structure
+  - Added note about automatic data extraction in Response class
+  - Updated code examples in `lib/zai_payment/resources/user.rb`
+- **Test Coverage**: Enhanced wallet_account test suite
+  - Split tests into focused examples for better maintainability
+  - Added comprehensive validation for all wallet account fields
+  - Tests for active status, timestamps, and all link fields
+  - All tests comply with RuboCop standards
+
+**Full Changelog**: https://github.com/Sentia/zai-payment/compare/v2.6.0...v2.6.1
+
 ## [2.6.0] - 2025-11-03
 
 ### Added

data/docs/users.md

@@ -168,12 +168,51 @@ Show the user's wallet account using a given user ID.
 ```ruby
 response = ZaiPayment.users.wallet_account('user_id')
 
+# Access wallet account details (automatically extracted from response)
 wallet = response.data
-puts wallet['id']
-puts wallet['balance']
-puts wallet['currency']
+puts "Wallet Account ID: #{wallet['id']}"
+puts "Active: #{wallet['active']}"
+puts "Balance: #{wallet['balance']}"
+puts "Currency: #{wallet['currency']}"
+puts "Created At: #{wallet['created_at']}"
+puts "Updated At: #{wallet['updated_at']}"
+
+# Access related resource links
+puts "Self URL: #{wallet['links']['self']}"
+puts "Users URL: #{wallet['links']['users']}"
+puts "Batch Transactions URL: #{wallet['links']['batch_transactions']}"
+puts "Transactions URL: #{wallet['links']['transactions']}"
+puts "BPay Details URL: #{wallet['links']['bpay_details']}"
+puts "NPP Details URL: #{wallet['links']['npp_details']}"
+puts "Virtual Accounts URL: #{wallet['links']['virtual_accounts']}"
 ```
 
+**Response Structure:**
+
+```ruby
+{
+  "wallet_accounts" => {
+    "id" => "5c1c6b10-4c56-0137-8cd7-0242ac110002",
+    "active" => true,
+    "created_at" => "2019-04-29T02:42:31.536Z",
+    "updated_at" => "2020-05-03T12:01:02.254Z",
+    "balance" => 663337,
+    "currency" => "AUD",
+    "links" => {
+      "self" => "/transactions/aed45af0-6f63-0138-901c-0a58a9feac03/wallet_accounts",
+      "users" => "/wallet_accounts/5c1c6b10-4c56-0137-8cd7-0242ac110002/users",
+      "batch_transactions" => "/wallet_accounts/5c1c6b10-4c56-0137-8cd7-0242ac110002/batch_transactions",
+      "transactions" => "/wallet_accounts/5c1c6b10-4c56-0137-8cd7-0242ac110002/transactions",
+      "bpay_details" => "/wallet_accounts/5c1c6b10-4c56-0137-8cd7-0242ac110002/bpay_details",
+      "npp_details" => "/wallet_accounts/5c1c6b10-4c56-0137-8cd7-0242ac110002/npp_details",
+      "virtual_accounts" => "/wallet_accounts/5c1c6b10-4c56-0137-8cd7-0242ac110002/virtual_accounts"
+    }
+  }
+}
+```
+
+**Note:** The `response.data` method automatically extracts the `wallet_accounts` object from the response, so you can access the wallet account fields directly without needing to access `response.data['wallet_accounts']`.
+
 ### List User Items
 
 Retrieve an ordered and paginated list of existing items the user is associated with.

data/lib/zai_payment/resources/user.rb

@@ -277,7 +277,13 @@ module ZaiPayment
       # @example
       #   users = ZaiPayment::Resources::User.new
       #   response = users.wallet_account("user_id")
-      #   response.data # => {"id" => "...", "balance" => ..., ...}
+      #   # The response.data method automatically extracts the wallet_accounts object
+      #   wallet = response.data
+      #   wallet["id"] # => "5c1c6b10-4c56-0137-8cd7-0242ac110002"
+      #   wallet["balance"] # => 663337
+      #   wallet["currency"] # => "AUD"
+      #   wallet["active"] # => true
+      #   wallet["links"]["transactions"] # => "/wallet_accounts/.../transactions"
       #
       # @see https://developer.hellozai.com/reference/showuserwalletaccounts
       def wallet_account(user_id)

data/lib/zai_payment/response.rb

@@ -8,7 +8,7 @@ module ZaiPayment
     RESPONSE_DATA_KEYS = %w[
       webhooks users items fees transactions
       batch_transactions bpay_accounts bank_accounts card_accounts
-      routing_number
+      wallet_accounts routing_number
     ].freeze
 
     def initialize(faraday_response)

data/lib/zai_payment/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ZaiPayment
-  VERSION = '2.6.0'
+  VERSION = '2.6.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zai_payment
 version: !ruby/object:Gem::Version
-  version: 2.6.0
+  version: 2.6.1
 platform: ruby
 authors:
 - Eddy Jaga