VibeFox ePay.bg for WooCommerce

Overview

VibeFox ePay.bg Gateway adds ePay.bg, the Bulgarian payment provider, to WooCommerce. After placing the order, the customer is sent to ePay.bg and pays there with a bank card or an ePay.bg account. ePay.bg then sends a signed notification to your store, and only this notification marks the order paid. Card data never touches your site.

It suits stores selling in Bulgarian lev (BGN), euro (EUR) or US dollar (USD) that have an ePay.bg merchant account. The plugin takes one-time payments only. It has no refunds from WooCommerce (refunds are made in the ePay.bg merchant panel), no saved cards, subscriptions or recurring payments, and no EasyPay or B-Pay cash payment codes.

Key features

ePay.bg payment page: a signed payment request for the order total in the order currency (BGN, EUR or USD) is sent to ePay.bg, where the customer pays by card or with an ePay.bg account.

Paid only when ePay.bg confirms: notifications are accepted only with a valid HMAC-SHA1 checksum and only for the invoice the plugin issued for that order. The customer's return to the store never marks an order paid.

Amount, currency and mode check: the amount, currency and mode (test or live) that were signed are stored on the order and checked again when the payment arrives. A mismatch puts the order on hold for review.

No double processing: repeated or parallel notifications never duplicate notes, stock reduction or e-mails. A late denied or expired notice never changes a paid order, and a payment for a cancelled or refunded order is never applied automatically.

Expired and denied requests: the unpaid order is cancelled and WooCommerce restores the stock. A customer who cancels on ePay.bg keeps the cart.

Test and live: separate credentials for demo.epay.bg and www.epay.bg.

Your settings: invoice prefix, expiration time of the payment request, ePay.bg page language (English or Bulgarian) and order status after payment.

Modern WooCommerce: classic checkout, Checkout block, the Pay for order page, HPOS. Optional log without secret keys or card data. Bulgarian translation included.

Requirements

WordPress 6.0 or later, WooCommerce 7.0 or later, PHP 8.0 or later. Store currency BGN, EUR or USD. An ePay.bg merchant account with a customer number (MIN) and a secret key, and the notification URL entered in your ePay.bg merchant profile. A VibeFox license key from vibefox.net (one key per domain).