VibeFox ePay.bg for Adobe Commerce

Overview

VibeFox ePay.bg Gateway adds ePay.bg, the Bulgarian payment provider, to Magento Open Source and Adobe Commerce. After Place Order the order is placed in Pending Payment and the customer is sent to the ePay.bg payment page to pay 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: Magento creates the invoice and sends the order e-mail at that moment. Card data never touches your site, and unpaid, denied or expired payments end with a cancelled order and a restored cart.

It suits stores selling in Bulgarian lev (BGN), euro (EUR) or US dollar (USD) that have an ePay.bg merchant account. The module takes one-time payments only. It has no refunds from Magento (refunds are made in the ePay.bg merchant panel and recorded with an offline credit memo), 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 an invoice the module issued. 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 and checked again when the payment arrives. A mismatch puts the order On Hold with a note and without an invoice.

No double processing: repeated or parallel notifications never create a second invoice. A late denied or expired notice never changes a paid order, and a second payment for a paid cart gets a note.

Test and live: separate credentials for demo.epay.bg and www.epay.bg. Payments started before you switch the mode are still confirmed.

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

Standard Magento settings: the Payment Methods page, secret keys stored encrypted, the notification URL shown on the page, countries and Minimum/Maximum Order Total, and an error log.

ePay.bg details on the order page: invoice, STAN, BORICA code, payment time, signed amount and mode in the payment information, and a table of every payment request of the cart.

Requirements

Magento Open Source or Adobe Commerce 2.4.6 to 2.4.9 (not Adobe Commerce as a Cloud Service), PHP 8.1 to 8.4. Order 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).