OpenCart

Victoriabank payment extension for OpenCart 4.x. Supports card payments, StarCard, StarPoints, MIA QR, and Pay-By-Link. Developed by DOT TEAM.

ℹ️ In Development

This extension is currently being developed and tested. The documentation below describes the current integration flow.

Overview

PlatformOpenCart 4.x
Extension typeOCMOD (dotteam.ocmod.zip)
Version1.0.0
LanguagesEnglish, Romanian
StatusIn Development

Installation

Option 1 — Extension Installer

  1. Go to OpenCart Admin → Extensions → Installer
  2. Click Upload and select the dotteam.ocmod.zip file
  3. After upload, go to Extensions → Extensions → filter by Payments
  4. Find Victoriabank Payment and click the green Install button (+)
  5. Click Edit (pencil icon) to configure

Option 2 — Manual Upload

  1. Extract the dotteam.ocmod.zip archive
  2. Upload the extension/dotteam/ folder to your OpenCart root directory under extension/
  3. Go to Extensions → Extensions → filter by Payments
  4. Find Victoriabank Payment and click Install, then Edit

Setup

Step 1 — Register and Authenticate

  1. Open the extension settings — Extensions → Payments → Victoriabank Payment → Edit
  2. You will see the login screen. Register with your email or log in if you already have an account
  3. Check your inbox for a 6-digit OTP code and enter it on the verification screen
  4. After verification, the full settings panel will appear

Step 2 — Enter Merchant Credentials

  1. Enter your Merchant ID and Terminal ID provided by Victoriabank
  2. Enter your Merchant Name, Merchant URL, and Merchant Address
  3. Generate your RSA key pair by clicking Generate Keys or paste your existing private key
  4. Set the Mode to Test for sandbox or Production for live payments
  5. Click Save Settings

Step 3 — Configure Payment Methods

Each payment method can be enabled or disabled independently from the settings tabs:

MethodHow to enable
Victoriabank CardEnabled by default after setup — configure in the Gateway tab
StarCardEnable in the StarCard tab, set separate Terminal ID if needed
StarPointsEnable in the StarPoints tab, set separate Terminal ID if needed
MIA QREnable in the MIA tab, enter your Creditor IBAN and DBA name
Pay-By-LinkAvailable in the Pay-By-Link tab after card payment is configured
⚠️ Important

StarCard and StarPoints may require separate Merchant/Terminal IDs from Victoriabank. Each method has its own configuration tab with independent credentials.

Step 4 — Set Order Status and Geo Zone

  1. In the extension settings, set the Order Status for successful payments (e.g., “Processing”)
  2. Set the Geo Zone to restrict which regions can use this payment method (or leave “All Zones”)
  3. Set Status to Enabled
  4. Set the Sort Order to control where Victoriabank appears among other payment methods
  5. Click Save

Payment Methods

MethodDescription
Victoriabank CardVisa and Mastercard via Victoriabank gateway
StarCardVictoriabank loyalty card
StarPointsPoints-based payment (Puncte Star)
MIA QRQR code payment via MIA mobile banking
Pay-By-LinkShareable payment links via email, SMS, messenger

How It Works

  1. Customer selects Victoriabank at checkout and confirms the order
  2. Extension calls the VBPay API to generate a signed payment form
  3. Customer is redirected to Victoriabank’s secure payment page
  4. Customer enters card details and completes the payment
  5. Victoriabank sends a callback to your store confirming the transaction
  6. Customer is returned to your store with an order confirmation
  7. Order status is updated automatically based on the payment result

For MIA QR payments, the customer sees a QR code to scan with the MIA mobile banking app instead of being redirected to a card payment page.

Generate payment links directly from the OpenCart admin panel and share them with customers via email, SMS, or messenger.

  1. Go to the extension settings → Pay-By-Link tab
  2. Fill in the product name, amount, and optional description
  3. Add optional delivery cost and discounts
  4. Click Create Payment Link
  5. Share the generated link with your customer

The customer opens the link, sees the order summary, and pays securely through Victoriabank.

Features

  • OpenCart 4.x native payment extension (OCMOD)
  • All payment methods: Card, StarCard, StarPoints, MIA QR, Pay-By-Link
  • Multi-language support (English, Romanian)
  • Sandbox and production modes
  • RSA-2048 encryption for all transactions
  • Automatic order status management
  • Payment callback handling
  • Admin panel with tabbed configuration

Support

Built by DOT TEAM