概述
VibeFox ePay.bg Gateway 为 OpenCart 3 和 OpenCart 4 添加保加利亚支付服务商 ePay.bg。顾客在最后一步结账时点击 Confirm Order，随后被引导至 ePay.bg 付款页面，并使用银行卡或 ePay.bg 账户付款。之后，ePay.bg 会向您的店铺发送已签名的通知，只有这条通知才会为订单设置状态。OpenCart 在付款前创建订单，因此未付款的尝试仍会保持为缺失订单。银行卡信息绝不会经过您的网站。
本扩展适合以保加利亚列弗（BGN）、欧元（EUR）或美元（USD）销售，并拥有 ePay.bg 商户账户的店铺。它仅支持一次性付款。不支持通过 OpenCart 退款（退款需在 ePay.bg 商户后台完成），也不支持保存银行卡、订阅或定期付款，以及 EasyPay 或 B-Pay 现金付款代码。
主要功能
ePay.bg 付款页面：以订单货币（BGN、EUR 或 USD）计算的订单总额，会以已签名的付款请求发送至 ePay.bg，顾客在该页面使用银行卡或 ePay.bg 账户付款。
仅在 ePay.bg 确认后才视为已付款：只有带有有效 HMAC-SHA1 校验和、且针对本扩展所开具发票的通知才会被接受。顾客返回店铺本身从不会为订单付款。之后，OpenCart 会发送其常规订单邮件。
金额、货币和模式检查：已签名的金额、货币和模式（测试或正式）会被保存，并在付款到达时再次核对。如果不一致，订单会进入审核状态并附带备注。
避免重复处理：重复或并发的通知绝不会重复入账。迟到的拒绝或过期通知绝不会改变已付款的订单。
被拒绝和已过期的请求：订单不会获得状态，购物车会被保留，顾客可以再次付款或选择其他付款方式。
测试与正式：demo.epay.bg 和 www.epay.bg 使用各自独立的凭据。在切换模式之前发起的付款仍会被确认。
您的设置：发票前缀、付款请求的过期时间、ePay.bg 页面语言（英文或保加利亚语）、使用您自己的 OpenCart 状态设置付款后的订单状态、地理区域、最低订单金额和排序。
订单页面中的 ePay.bg 选项卡：发票、请求金额、STAN、BORICA 代码以及 ePay.bg 备注。付款请求和通知会写入可选日志，日志中不包含密钥或银行卡数据；错误始终会记录。
要求
OpenCart 3.0.x（已在 3.0.5.0 上测试）或 OpenCart 4.0.2 及更高版本（已在 4.1.0.3 上测试），PHP 8.0 或更高版本。一个下载包同时包含两个版本的安装包。结账货币为 BGN、EUR 或 USD。需要一个 ePay.bg 商户账户，包含客户编号（MIN）和密钥，并已在您的 ePay.bg 商户资料中填写店铺的通知 URL。需要从 vibefox.net 获取 VibeFox 许可证密钥（每个域名一个密钥）。