VirtueMart 插件

概述

MakePay VirtueMart 插件为 Joomla/VirtueMart 商店提供托管加密支付。客户选择 MakePay 后进入托管结账，签名回调会更新订单状态。

开始之前

• Joomla 与 VirtueMart 已安装并使用 HTTPS。
• PHP 启用 OpenSSL。
• 管理员可安装插件并管理支付方式。
• MakeCrypto 公司已完成 MakePay 结算设置。

安装插件

下载官方 ZIP：

https://plugins.makecrypto.io/downloads/virtuemart/latest.zip

在 Joomla 扩展管理中上传并启用插件，然后在 VirtueMart 支付方式中新增 MakePay。

连接 MakePay

使用 Connect MakePay 连接 MakeCrypto 公司，或在支持团队指导下使用手动 API key。连接后保存支付方式配置。

网关设置

检查支付标题、结账体验、结算 symbol、支付链接过期时间、回调 URL 和手动凭据。普通安装应使用连接模式。

结账流程

订单创建后，插件创建 MakePay 支付链接，并把 VirtueMart 订单号、客户邮箱和金额写入 metadata。客户付款后返回商店。

订单状态

成功付款会标记订单已确认/已支付。失败、取消或过期会按配置标记订单失败或取消。

手动 API 密钥回退

创建 MakePay API 密钥后，把公司 ID、key ID 和 secret 填入插件设置。请避免在模板、前端脚本或公开工单中暴露 secret。

故障排查

如果订单未更新，请检查 MakeCrypto Webhook 日志、Joomla/VirtueMart 日志、回调 URL 和安全扩展规则。