WooCommerce
Victoriabank payment gateway plugin for WordPress and WooCommerce. Supports card payments, StarCard, StarPoints, and MIA QR.
Latest Release
Requirements
| Dependency | Version |
|---|---|
| WordPress | 5.8+ |
| WooCommerce | 6.0+ |
| PHP | 7.4+ |
| SSL Certificate | Required |
Installation
Option 1 — WP-CLI
wp plugin install https://plugins.dotteam.md/downloads/victoriabank-payment-1.0.2.zip --activate
Option 2 — Manual Upload
- Navigate to WordPress Admin → Plugins → Add New → Upload Plugin
- Choose the downloaded
.zipfile and click Install Now - Click Activate Plugin
- Go to WooCommerce → Settings → Payments
Setup
After activating the plugin, follow these steps to configure it properly.
Step 1 — Flush Permalinks
This is required for Pay-By-Link and MIA QR pages to work. Without this step, payment links will return a 404 error.
- Go to WordPress Admin → Settings → Permalinks
- Do not change anything — just click Save Changes
- This refreshes WordPress rewrite rules so the plugin’s custom URLs (
/pay/LINK_IDand/vbpay-mia-qr) are registered
If Pay-By-Link pages show a 404 error, this is almost always the fix. Go to Settings → Permalinks and click Save Changes without modifying anything.
Step 2 — Register and Authenticate
- Navigate to WooCommerce → Settings → Payments → Victoriabank Card → Manage
- Register with your email address or log in if you already have an account
- Verify your email via the OTP code sent to your inbox
- Enter your Merchant ID and Terminal ID provided by Victoriabank
- Generate your RSA key pair by clicking Generate Keys
Step 3 — Configure Payment Methods
Navigate to WooCommerce → Settings → Payments. You will see the following payment methods:
| Method | Description | Default |
|---|---|---|
| Victoriabank Card | Visa and Mastercard via VB gateway | Enabled |
| StarCard | Victoriabank loyalty card payments | Optional |
| StarPoints | Points-based payment (Puncte Star) | Optional |
| MIA QR | QR code payment via MIA mobile banking | Optional |
| Pay-By-Link | Shareable payment links via email, SMS, messenger | Enabled |
You need a Merchant ID and Terminal ID from Victoriabank to configure the plugin. Use Sandbox mode for testing before going live.
Merchant Credentials
| Setting | Description |
|---|---|
| Merchant ID | Your Victoriabank merchant identifier |
| Terminal ID | Your payment terminal identifier |
| Private Key | RSA-2048 — generate from plugin settings |
| Mode | sandbox or production |
Pay-By-Link
Generate payment links directly from your store and share them with customers via email, SMS, or messenger. The customer opens the link, sees an order summary, and pays securely through Victoriabank.
How it works:
- Merchant creates a payment link from the WooCommerce admin panel
- A unique URL is generated on your domain:
yourstore.com/pay/LINK_ID - Customer opens the link and sees the order details (amount, description, merchant name)
- Customer clicks “Pay” and is securely redirected to Victoriabank’s payment page
- After payment, the customer is returned to your store with a confirmation
Use cases:
- Invoice payments — send a payment link along with an invoice
- Phone orders — create an order manually and send the customer a link to pay
- Social commerce — share payment links on social media or messengers
- Email campaigns — embed payment links in marketing emails
If a customer opens a payment link and gets a 404 page, go to WordPress Admin → Settings → Permalinks and click Save Changes without modifying anything. This refreshes the rewrite rules that register the /pay/ URL.
Features
- Classic and block-based WooCommerce checkout support
- HPOS (High-Performance Order Storage) compatible
- Pay-By-Link — generate shareable payment links from admin
- Authorization and immediate capture modes
- Manual capture and refund from WooCommerce admin
- Multi-language payment page (Romanian, Russian, English)
- RSA-2048 encryption for all transactions
Changelog
v1.0.2 — March 25, 2026
- Added MIA QR checkout integration
- Added StarCard and StarPoints payment methods
- WooCommerce Blocks support for all payment methods
- Fixed transaction sync edge case on refunds
v1.0.1 — March 10, 2026
- Payment link generation from merchant domain
- Improved callback handling reliability
- Transaction synchronization improvements
v1.0.0 — February 28, 2026
- Initial release
- Card payment via Victoriabank e-commerce gateway
- Sandbox and production modes
- Merchant registration with OTP verification