xF2 Add-on Crypoverse - Cryptocurrency Payment Gateway [BTC, LTC, ETH] v3.0.1

✅ Crypoverse v3.0.1 - Update Complete
🐛 Critical Bug Fixed
Issue: Undefined constant XF\Payment\CallbackState :: PAYMENT_PENDING
Error Location: CryptoProvider.php:791
Impact: Server errors when underpaid/unknown payment statuses received
Cause: Used non-existent PAYMENT_PENDING constant (doesn't exist in XenForo)
Solution:
Removed all CallbackState :: PAYMENT_PENDING usage
For pending payments: Don't set paymentResult (let XenForo handle)
For errors: Use CallbackState :: PAYMENT_ERROR
✨ New Feature: Underpaid Transaction Handling
Added comprehensive "underpaid" status support:
case 'underpaid':
$state->paymentResult = CallbackState :: PAYMENT_ERROR;
$state->logType = 'error';
$state->logMessage = 'Payment underpaid - Expected: 0.000261 Bitcoin, Received: 0.000228 Bitcoin...';
$state->logDetails = [
'expected_amount' => '0.000261',
'received_amount' => '0.000228',
'shortfall' => '0.000033'
];
Benefits:
✅ Proper logging to Payment Provider Logs (not server errors)
✅ Detailed underpayment information
✅ Automatic shortfall calculation
✅ Clear transaction tracking
📊 Enhanced Status Handling
Now Supports:
✅ completed → Payment received
✅ pending → Awaiting confirmation
✅ underpaid → Payment error with details
✅ expired / timed-out → Cancelled
✅ failed / error → Payment error
✅ Unknown statuses → Logged with full raw data
📝 Files Modified
addon.json
Version: 3.0.0 → 3.0.1
Version ID: 3000000 → 3000100
Payment/CryptoProvider.php
Fixed PAYMENT_PENDING error (lines 575, 791)
Added underpaid status handling (lines 779-807)
Added expired/failed status handling (lines 809-826)
Improved unknown status logging (lines 828-838)
Updated version comments to 3.0.1
_data/hashes.json
Updated addon.json hash: c88457495c36b178945018837f29d641
Updated CryptoProvider.php hash: a102902523067305b91edf87ad95da09
CHANGELOG.md (NEW)
Complete version history
Detailed 3.0.1 changes
Upgrade instructions

✅ Ready For Distribution
All files updated and ready for:
XenForo marketplace upload
Customer distribution
Production deployment
Version: 3.0.1 Status: Production Ready Date: October 4, 2025