VibeFox ePay.bg for PrestaShop

Overview

VibeFox ePay.bg Gateway adds ePay.bg, the Bulgarian payment provider, to PrestaShop. At the payment step the customer chooses ePay.bg, is sent to the ePay.bg payment page and pays there with a bank card or an ePay.bg account. ePay.bg then sends a signed notification to your shop, and only this notification creates the order. Card data never touches your site, and abandoned payments leave no unpaid orders.

It suits shops 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 PrestaShop (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 cart total in the cart currency (BGN, EUR or USD) is sent to ePay.bg, where the customer pays by card or with an ePay.bg account.

Order 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 shop never creates or pays an order.

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 in ePay.bg payment on hold with a note.

No double processing: repeated or parallel notifications never create a second order or record the payment twice. A late denied or expired notice never changes a paid order.

Denied and expired requests: no order is created, the cart is kept and the customer can pay again or choose another payment method.

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.

ePay.bg block on the order page: invoice, requested amount, STAN, BORICA code and the module notes. Payment requests and notifications go to an optional log without secret keys or card data; errors are always logged.

Requirements

PrestaShop 8.0 to 9.x, PHP 8.0 or later. Cart 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).