WooCommerce

Victoriabank payment gateway plugin for WordPress and WooCommerce. Supports card payments, StarCard, StarPoints, and MIA QR.

Latest Release

v1.0.2 Stable March 25, 2026
victoriabank-payment-1.0.2.zip 331 KB

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

  1. Navigate to WordPress AdminPluginsAdd NewUpload Plugin
  2. Choose the downloaded .zip file and click Install Now
  3. Click Activate Plugin
  4. Go to WooCommerceSettingsPayments

Setup

After activating the plugin, follow these steps to configure it properly.

This is required for Pay-By-Link and MIA QR pages to work. Without this step, payment links will return a 404 error.

  1. Go to WordPress AdminSettingsPermalinks
  2. Do not change anything — just click Save Changes
  3. This refreshes WordPress rewrite rules so the plugin’s custom URLs (/pay/LINK_ID and /vbpay-mia-qr) are registered
⚠️ Important

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

  1. Navigate to WooCommerceSettingsPaymentsVictoriabank CardManage
  2. Register with your email address or log in if you already have an account
  3. Verify your email via the OTP code sent to your inbox
  4. Enter your Merchant ID and Terminal ID provided by Victoriabank
  5. 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:

MethodDescriptionDefault
Victoriabank CardVisa and Mastercard via VB gatewayEnabled
StarCardVictoriabank loyalty card paymentsOptional
StarPointsPoints-based payment (Puncte Star)Optional
MIA QRQR code payment via MIA mobile bankingOptional
Pay-By-LinkShareable payment links via email, SMS, messengerEnabled
⚠️ Important

You need a Merchant ID and Terminal ID from Victoriabank to configure the plugin. Use Sandbox mode for testing before going live.

Merchant Credentials

SettingDescription
Merchant IDYour Victoriabank merchant identifier
Terminal IDYour payment terminal identifier
Private KeyRSA-2048 — generate from plugin settings
Modesandbox or production

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:

  1. Merchant creates a payment link from the WooCommerce admin panel
  2. A unique URL is generated on your domain: yourstore.com/pay/LINK_ID
  3. Customer opens the link and sees the order details (amount, description, merchant name)
  4. Customer clicks “Pay” and is securely redirected to Victoriabank’s payment page
  5. 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
💡 Troubleshooting 404 on payment links

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