VÚB eCard Payment Plugin for VirtueMart

Features

• Joomla 4/5/6 Compatible - Modern PHP 8.x support with strict types
• VirtueMart 4.x Support - Full integration with VirtueMart 4
• 3D Secure - NestPay 3D Pay Hosting integration
• Multi-language - Slovak, English, Czech, German, Hungarian, Polish, Russian
• Secure - SSL verification, XSS protection, SQL injection prevention
• Easy Installation - Standard Joomla plugin installation

Requirements

• Joomla 4.x, 5.x, or 6.x
• VirtueMart 4.x
• PHP 8.0 or higher
• VÚB bank eCard merchant account

Installation

1. Download the latest release ZIP file
2. In Joomla admin, go to System > Install > Extensions
3. Upload and install the ZIP file
4. Go to VirtueMart > Payment Methods
5. Create a new payment method and select VÚB eCard
6. Configure your Client ID and Store Key from VÚB bank

Configuration

| Setting | Description |
|---------|-------------|
| Client ID | Your merchant Client ID from VÚB bank |
| Store Key | Your Store Key from VÚB bank |
| Sandbox Mode | Enable for testing with test credentials |
| Payment Currency | Select the currency for payments (EUR) |
| Debug Mode | Enable detailed logging for troubleshooting |

Supported Languages

The payment gateway automatically uses your Joomla site language:

• sk - Sloven?ina (Slovak)
• en - English
• cz - ?eština (Czech)
• de - Deutsch (German)
• hu - Magyar (Hungarian)
• pl - Polski (Polish)
• ru - ??????? (Russian)

Security Features

• SSL/TLS Verification - All communication with the bank is encrypted and verified
• XSS Protection - All output is properly escaped
• SQL Injection Prevention - Parameterized queries using Joomla's database API
• Hash Verification - SHA-512 hash validation for all transactions
• Strict Types - PHP strict type checking enabled

Troubleshooting

"Wrong security code" Error (3D-1004)

This usually indicates a hash mismatch. Check:
1. Store Key is correctly entered (no extra spaces)
2. You're using the correct mode (test vs production)
3. Enable Debug Mode and check the logs

Payment Gateway in Wrong Language

The language is set automatically based on your Joomla site language. Make sure your site language is set correctly in Joomla's Language settings.

Version History

v2.0.9

• Fixed payment gateway language not being set correctly
• Language now properly follows Joomla site language

v2.0.8

• Fixed double HTML escaping causing hash mismatch
• Fixed URL generation for hash compatibility

v2.0.7

• Fixed currency handling for backward compatibility

v2.0.0

• Complete modernization for Joomla 4/5/6
• PHP 8.x support with strict types
• Enhanced security features
• Modern code architecture with namespaces

License

This plugin is licensed under the GNU General Public License v2.0 or later.