update versions and changelogs

Author: eddyjaga

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    zai_payment (2.7.0)
+    zai_payment (2.8.0)
       base64 (~> 0.3.0)
       faraday (~> 2.0)
       openssl (~> 3.3)

changelog.md

@@ -1,5 +1,80 @@
 ## [Released]
 
+## [2.8.0] - 2025-11-07
+
+### Added
+- **Virtual Accounts Resource**: Complete virtual account management for Australian payments 🏦
+  - `ZaiPayment.virtual_accounts.list(wallet_account_id)` - List all virtual accounts for a wallet account
+  - `ZaiPayment.virtual_accounts.show(virtual_account_id)` - Get virtual account details
+  - `ZaiPayment.virtual_accounts.create(wallet_account_id, account_name:, aka_names:)` - Create virtual account for a wallet account
+  - `ZaiPayment.virtual_accounts.update_aka_names(virtual_account_id, aka_names)` - Update AKA names (0-3 items)
+  - `ZaiPayment.virtual_accounts.update_account_name(virtual_account_id, account_name)` - Update account name (used in CoP lookups)
+  - `ZaiPayment.virtual_accounts.update_status(virtual_account_id, status)` - Close a virtual account (status: 'closed')
+  - Support for AKA names for account aliases
+  - Support for Confirmation of Payee (CoP) lookups via account names
+  - Validation for account names (max 140 characters)
+  - Validation for AKA names (0-3 items)
+  - Full RSpec test suite with 65+ test examples
+  - Comprehensive documentation in `docs/virtual_accounts.md`
+  - Practical examples in `examples/virtual_accounts.md`
+
+- **PayID Resource**: PayID registration management for Australian NPP payments 💳
+  - `ZaiPayment.pay_ids.create(virtual_account_id, pay_id:, type:, details:)` - Register a PayID for a virtual account
+  - `ZaiPayment.pay_ids.show(pay_id_id)` - Get PayID details including status
+  - `ZaiPayment.pay_ids.update_status(pay_id_id, status)` - Deregister a PayID (status: 'deregistered')
+  - Support for EMAIL PayID type
+  - Validation for PayID format (max 256 characters)
+  - Validation for details (pay_id_name and owner_legal_name, 1-140 characters each)
+  - Asynchronous status update with 202 Accepted response
+  - Full RSpec test suite with 35+ test examples
+  - Comprehensive documentation in `docs/pay_ids.md`
+  - Practical examples in `examples/pay_ids.md`
+
+### Documentation
+- **Virtual Accounts Guide** (`docs/virtual_accounts.md`):
+  - Complete guide for all 6 virtual account endpoints
+  - Detailed workflow for account creation and management
+  - AKA names for account aliases
+  - Account name updates for CoP lookups
+  - Status updates for closing accounts
+  - Error handling patterns
+  - Comprehensive use cases
+
+- **Virtual Accounts Examples** (`examples/virtual_accounts.md`):
+  - List virtual accounts examples
+  - Show virtual account examples
+  - Create virtual account examples
+  - Update AKA names examples
+  - Update account name examples
+  - Update status (close account) examples
+  - Complete workflow patterns
+  - Rails integration examples
+
+- **PayID Guide** (`docs/pay_ids.md`):
+  - Complete guide for all 3 PayID endpoints
+  - PayID registration with EMAIL type
+  - PayID format validation rules
+  - Status updates for deregistration
+  - Integration with virtual accounts
+  - Error handling patterns
+  - Comprehensive use cases
+
+- **PayID Examples** (`examples/pay_ids.md`):
+  - Register PayID examples
+  - Show PayID examples
+  - Update status (deregister) examples
+  - Complete workflow patterns
+  - Rails integration examples
+
+### Enhanced
+- **README.md**: 
+  - Added Virtual Accounts to features section
+  - Added PayID to features section
+  - Added documentation links to virtual accounts and PayID guides
+  - Updated roadmap to mark Virtual Accounts and PayID as Done
+
+**Full Changelog**: https://github.com/Sentia/zai-payment/compare/v2.7.0...v2.8.0
+
 ## [2.7.0] - 2025-11-04
 
 ### Added

lib/zai_payment/version.rb

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

readme.md

@@ -24,6 +24,8 @@ A lightweight and extensible Ruby client for the **Zai (AssemblyPay)** API — s
 - 🏦 **Bank Account Management** - Complete CRUD + validation for AU/UK bank accounts  
 - 💳 **BPay Account Management** - Manage BPay accounts for Australian bill payments  
 - 💼 **Wallet Account Management** - Show wallet accounts, check balances, and pay bills via BPay  
+- 🏦 **Virtual Accounts** - Complete virtual account management with PayTo and BPay support  
+- 💳 **PayID Management** - Create and manage PayIDs for Australian NPP payments  
 - 🎫 **Token Auth** - Generate secure tokens for bank and card account data collection  
 - 🪝 **Webhooks** - Full CRUD + secure signature verification (HMAC SHA256)  
 - 🧪 **Batch Transactions** - Prelive-only endpoints for testing batch transaction flows  
@@ -160,6 +162,23 @@ if payment_response.success?
 end
 ```
 
+### Virtual Accounts
+
+Manage virtual accounts with support for AKA names and Confirmation of Payee (CoP) lookups.
+
+**📚 Documentation:**
+- 📖 [Virtual Account Management Guide](docs/virtual_accounts.md) - Complete guide for virtual accounts
+- 💡 [Virtual Account Examples](examples/virtual_accounts.md) - Real-world patterns and workflows
+- 🔗 [Zai: Virtual Accounts API Reference](https://developer.hellozai.com/reference/overview-va)
+
+### PayID
+
+Register and manage PayIDs (EMAIL type) for Australian NPP (New Payments Platform) payments.
+
+**📚 Documentation:**
+- 📖 [PayID Management Guide](docs/pay_ids.md) - Complete guide for PayID registration
+- 💡 [PayID Examples](examples/pay_ids.md) - Real-world patterns and workflows
+
 ### Token Auth
 
 Generate secure tokens for collecting bank and card account information.
@@ -246,7 +265,8 @@ end
 | ✅ Token Auth                   | Generate bank/card tokens         | Done           |
 | ✅ Batch Transactions (Prelive) | Simulate batch processing flows   | Done           |
 | ✅ Payments                     | Single and recurring payments     | Done           |
-| 🏦 Virtual Accounts (VA / PIPU) | Manage virtual accounts & PayTo   | ⏳ Planned      |
+| ✅ Virtual Accounts             | Manage virtual accounts & PayTo   | Done           |
+| ✅ PayID                        | Create and manage PayIDs          | Done           |
 
 ## 🧪 Development
 
@@ -305,6 +325,8 @@ Everyone interacting in the ZaiPayment project's codebases, issue trackers, chat
 - [**Bank Account Guide**](docs/bank_accounts.md) - Managing bank accounts for AU/UK users
 - [**BPay Account Guide**](docs/bpay_accounts.md) - Managing BPay accounts for Australian bill payments
 - [**Wallet Account Guide**](docs/wallet_accounts.md) - Managing wallet accounts, checking balances, and paying bills
+- [**Virtual Account Guide**](docs/virtual_accounts.md) - Managing virtual accounts with PayTo and BPay support
+- [**PayID Guide**](docs/pay_ids.md) - Creating and managing PayIDs for Australian NPP payments
 - [**Webhook Examples**](examples/webhooks.md) - Complete webhook usage guide
 - [**Documentation Index**](docs/readme.md) - Full documentation navigation
 
@@ -314,6 +336,8 @@ Everyone interacting in the ZaiPayment project's codebases, issue trackers, chat
 - [Bank Account Examples](examples/bank_accounts.md) - Bank account integration patterns
 - [BPay Account Examples](examples/bpay_accounts.md) - BPay account integration patterns
 - [Wallet Account Examples](examples/wallet_accounts.md) - Wallet account and bill payment workflows
+- [Virtual Account Examples](examples/virtual_accounts.md) - Virtual account management and PayTo workflows
+- [PayID Examples](examples/pay_ids.md) - PayID creation and management workflows
 - [Token Auth Examples](examples/token_auths.md) - Secure token generation and integration
 - [Webhook Examples](examples/webhooks.md) - Webhook integration patterns
 - [Batch Transaction Examples](examples/batch_transactions.md) - Testing batch transaction flows (prelive only)