esas/cmsgate-opencart-hutkigrosh

Opencart cms payment gate library

v4.1.2 2024-05-07 10:08 UTC

This package is not auto-updated.

Last update: 2024-09-24 12:03:02 UTC


README

该模块确保基于CMS Opencart的网店与支付服务ХуткiГрош之间的交互

  • 用于OpenCart 1.5.x版本的集成模块
  • 用于OpenCart 2.1.x版本的集成模块
  • 用于OpenCart 2.2.x版本的集成模块

要求

  1. PHP 5.6及以上
  2. Curl库

安装说明

  1. 创建商店和数据库的备份
  2. 使用模块 -> 安装扩展安装模块 cmsgate-opencart-hutkigrosh.ocmod.zip
  3. 点击模块 ХуткiГрош旁边的“安装”

配置说明

  1. 通过菜单模块 -> 支付进入插件配置
  2. 点击模块 ХуткiГрош旁边的“修改”。
  3. 指定必填参数
    • 网店登录名 - ХуткiГрош系统中的登录名。
    • 网店密码 - ХуткiГрош系统中的密码。
    • 服务唯一标识符 - ЕРИП服务的ID
    • 服务代码 - ЕРИП服务代码。用于生成二维码
    • 沙盒 - 将模块转换为测试模式。在此模式下,账单将在测试系统www.trial.hgrosh.by中生成
    • 电子邮件通知 - 在账单成功生成时通过电子邮件通知客户(由Хуткiгрош网关执行)
    • 短信通知 - 在账单成功生成时通过短信通知客户(由Хуткiгрош网关执行)
    • ЕРИП树路径 - 在ЕРИП树中支付账单的路径,订单完成后将显示给客户(例如,支付 > 商店 > 订单)
    • 账单有效期 - 账单在ЕРИП中可支付的有效期
    • 生成账单时的状态 - 在ЕРИП成功生成账单时,给订单设置的状态(从商店 > 设置 > 状态中选择现有状态标识符)
    • 成功支付账单时的状态 - 在成功支付生成的账单时,给订单设置的状态(选择现有状态标识符)
    • 取消支付账单时的状态 - 在取消支付账单时,给订单设置的状态(选择现有状态标识符)
    • 账单支付错误时的状态 - 在账单支付错误时,给订单设置的状态(选择现有状态标识符)
    • “说明”部分 - 如果启用,则在最终屏幕上客户将获得支付账单的逐步说明
    • “二维码”部分 - 如果启用,则在最终屏幕上客户将通过二维码支付账单
    • “Alfaclick”部分 - 如果启用,则在最终屏幕上客户将看到一个按钮来生成Alfaclick账单
    • “Webpay”部分 - 如果启用,则在最终屏幕上客户将看到一个按钮来通过卡片支付账单(跳转到Webpay)
    • 账单成功生成后的文本 - 客户在成功生成账单后显示的文本。可以包含html。文本中可以引用变量 @order_id、@order_number、@order_total、@order_currency、@order_fullname、@order_phone、@order_address
  4. 保存更改。

注意!

  • 为了自动更新订单状态(在客户支付在ЕРИП中展示的账单后),需要向“Хуткi Грош”技术支持服务提供处理器的地址。
    • 针对 oc 2.1 版本
    http://mydomen.my/index.php?route=payment/hutkigrosh/notify
    
    • 针对 oc > 2.3 版本
    http://mydomen.my/index.php?route=extension/payment/hutkigrosh/notify
    
  • 模块会记录日志文件,路径为 site_root/upload/system/library/esas/cmsgate/hutkigrosh/vendor/esas/cmsgate-core/logs/cmsgate.log。为了保证 安全性,请确保在 http 服务器设置中,根目录已启用 AllowOverride All 指令。

测试数据

为了设置测试模式下的支付

  • 请使用注册“ХуткiГрош”时获得的测试系统连接数据
  • 在模块设置中启用“沙盒”模式
  • 为了模拟客户支付账单,请使用测试系统的个人账户(菜单 测试 EРИП 支付)进行操作 已与 OpenCart v.3.0.0.2 版本开发并测试

安装说明

  • 在构建 cmsgate-opencart-hutkigrosh.ocmod.zip(适用于 OpenCart > v2.3)时,需要删除以下目录:
    • upload\admin\controller\payment
    • upload\admin\view\template\payment
    • upload\catalog\controller\payment
    • upload\catalog\model\payment
    • upload\catalog\view\theme\payment
  • 在构建 cmsgate-opencart21-hutkigrosh.ocmod.zip(适用于 OpenCart v2.1)时,需要删除以下目录:
    • upload\admin\controller\extension\payment
    • upload\admin\view\template\extension\payment
    • upload\catalog\controller\extension\payment
    • upload\catalog\model\extension\payment
    • upload\catalog\view\theme\default\template\extension\payment