bluepayment-plugin/module-bluepayment

此包最新版本（2.22.11）的许可证信息不可用。

适用于 Magento 2 的自动支付网关。

维护者

详细信息

github.com/bluepayment-plugin/magento-2.x-plugin

源代码

问题

安装: 36,510

依赖者: 1

建议者: 0

安全: 0

星标: 2

关注者: 5

分支: 4

开放问题: 1

类型:magento2-module

2.22.11 2024-08-27 19:09 UTC

Requires

  • ext-curl: *
  • ext-xml: *
  • magento/framework: ^102||^103
  • magento/module-checkout: ^100.3
  • magento/module-config: ^101.1
  • magento/module-payment: ^100.3
  • magento/module-quote: ^101
  • magento/module-sales: ^102.0||^103.0

Unknown License 49adb9e61b754ea759709d2d1d6952a8bbfe36fc

This package is auto-updated.

Last update: 2024-09-27 19:24:42 UTC

README

基本信息

Autopay 是一个支付模块，允许在基于 Magento 2 的商店中实现无现金交易。

主要功能

此模块的主要功能包括

  • 使用一个模块同时支持多个商店
  • 支持无需在服务中注册即可进行购物
  • 支持两种工作模式 - 测试和生产（每种模式都需要单独的账户信息，请向我们咨询）
  • 实现两种在商店中显示支付表单的方法
    • 在 Autopay 页面上 - 经典视图或个性化视图（与 Autopay 协商后），
    • 在商店页面上 - 集成，客户将被直接带到银行或支付卡页面。

要求

  • Magento 版本：2.3.0 – 2.4.7。
  • PHP 版本与商店版本的要求一致。

Autopay 中的新功能？

安装

通过 Composer

  1. 执行以下命令
composer require bluepayment-plugin/module-bluepayment
  1. 转到模块激活

通过 .zip 包

  1. 从此页面下载模块的最新版本。
  2. 将 .zip 文件上传到 Magento 的主目录。
  3. 在 Magento 的主目录中，执行以下命令
unzip -o -d app/code/BlueMedia/BluePayment bm-bluepayment-*.zip && rm bm-bluepayment-*.zip
  1. 转到模块激活

模块激活

通过命令行激活

  1. 在 Magento 的主目录中，执行以下命令
  • bin/magento module:enable BlueMedia_BluePayment --clear-static-content
  • bin/magento setup:upgrade
  • bin/magento setup:di:compile
  • bin/magento cache:flush
    ，然后模块将被激活。

通过管理面板激活（仅适用于 Magento 2.3 版本）

  1. 登录到 Magento 管理面板。

  2. 在主菜单中选择 系统 -> Web Setup Wizard。系统将要求您重新登录 - 请这样做以继续激活。

  3. 转到 组件管理器，在列表中找到模块 BlueMedia/BluePayment，单击 选择 然后单击 启用。

    install1.png

  4. 单击 开始就绪检查 以启动依赖性验证的执行，然后单击 下一步。

  5. 如果您想在此阶段创建代码、媒体和数据库的备份，请单击 创建备份。然后单击 下一步。

    install2.png

  6. 单击 启用 以在激活支付网关时关闭您的在线商店。

  7. 激活可能需要几分钟。成功完成后，您将看到以下消息：install3.png

配置

  1. 登录到 Magento 2 平台的行政面板。
  2. 在菜单中选择：商店（Store） -> 配置（Configuration）
  3. 在下拉菜单中选择：销售（Sales） -> 支付方式（Payment methods）
  4. 然后展开 其他支付方式（Other payment methods） 并选择 在线支付 Autopay（Online Payment Autopay）。

模块基本配置

  1. 转到模块配置。
  2. 填写必填字段
    1. 在 启用（Enabled） 状态下，单击 是（Yes）。
    2. 填写 标题（Title） – 即您店铺中客户可见的支付名称，例如：安全在线支付。
    3. 设置 测试模式（Test Mode）
  3. 填写支持的货币信息（您将收到来自Autopay的信息）
    1. 服务提供商ID（Service partner ID）
    2. 配置密钥（hash）（配置密钥（hash）） - 您将从Autopay获得，您也可以在Autopay门户中找到它 测试环境，生产环境 在服务详情中，作为 配置密钥（hash） configuration3.png
  4. 刷新缓存。

支付渠道配置

  1. 登录到Magento 2平台的管理控制台
  2. 在左侧菜单中选择 BluePayment -> 支付渠道（Gateways）

在店铺中选择支付渠道

  1. 转到 模块配置
  2. 在 在店铺中显示支付渠道（Show payment gateways in store） 字段旁边勾选 是（whitelabel）（YES（whitelabel））
  3. 刷新缓存。

刷新支付渠道列表

  1. 转到支付渠道列表
  2. 点击屏幕右侧的 同步支付渠道（Synchronize Gateways） 命令。

该模块允许每5分钟自动刷新一次支付渠道。要使用此功能，请根据以下链接中的文档配置CRON：[链接](https://devdocs.magento.com/guides/v2.4/config-guide/cli/config-cli-subcommands-cron.html)。

编辑支付渠道

  1. 转到支付渠道列表。
  2. 点击您要编辑的渠道名称
  3. 您可以编辑以下数据

    1. 渠道状态（Status） – 渠道是否当前可用（如果CRON配置正确，则渠道刷新每5分钟进行一次）；

    2. （信息）货币（Currency）

    3. （信息）ID

    4. （信息）银行名称（Bank Name）

    5. （信息）名称（Name）

    6. （信息）最大支付金额（Maximum payment amount）

    7. （信息）最小支付金额（Minimum payment amount）

    8. 描述（Description） – 在支付渠道名称下显示给客户

    9. 排序顺序（Sort Order） – 在列表中的排序顺序，其中

      • 1 – 列表中的第一个位置，
      • 2 – 列表中的第二个位置，
      • ...
      • 0 – 列表中的最后一个位置。

      对于单独的支付方式，聚合的Autopay支付方式（转账支付）默认顺序为1。如果您想将单独的支付方式设置为高于Autopay的方式，请使用负值（-5、-4、-3等）。

    10. 类型（Type）.

    11. 作为单独的支付方式处理（Is separated method） – 将该渠道显示为单独的支付方式。 BLIK、信用卡及分期付款渠道始终显示为单独的支付方式。

    12. 网关Logo

    13. 为支付渠道使用自定义Logo（Use Own Logo）

    14. Logo路径（Logo Path） – 自定义Logo的地址（在选中 使用自定义Logo（Use Own Logo） 选项时可见）

    15. （信息）最后更新时间（Status Date） – 最后更新支付渠道数据的日期和时间

    16. 强制禁用（Force Disable） – 允许停用选定的支付渠道（无论其状态如何）

可展开的渠道列表

从版本2.9.0开始提供 - 默认启用。

configuration1.png

如果您始终要显示完整的支付渠道列表

  1. 转到 模块配置
  2. 点击 禁用 (Disabled) 在 可折叠网关列表 (Collapsible gateway list) 字段中
  3. 刷新缓存。

刷新缓存

每次编辑配置后刷新缓存。要这样做

  1. 转到 系统 -> 缓存管理 (Cache Management)

  2. 选中 配置 (Configuration)

  3. 从下拉菜单中选择 刷新 (Refresh)

  4. 点击 提交 (Submit)

    configuration2.png

BLIK 0

BLIK "店内"的特点是交易安全代码需要直接输入到商店的页面上 - 在购物过程的最后阶段。

blik1.png

BLIK 0 激活

  1. 转到 模块配置
  2. 点击 启用 (Enable) 在 BLIK 0 选项旁边。
  3. 转到 ID 为 509 且网关名称为 BLIK 的网关编辑。
  4. 设置选项 将其视为单独的支付方式 (Is separated method).
  5. 刷新缓存。

Google Pay

此选项允许用户在商店页面上直接使用 Google Pay 进行支付 - 在购物过程的最后阶段。

gpay.png

Google Pay 激活

Google Pay 默认启用并始终显示为单独的支付方式。

自动支付

一键支付 - One Click Payment - 是利用信用卡进行便捷支付的另一种方式。它允许快速支付，无需客户每次都输入所有卡认证数据。支付处理过程包括一次性授权支付和将卡数据与特定客户关联。第一次交易通过 3D-Secure 协议进行保护，后续交易根据合作伙伴发送的卡扣款请求进行。

自动支付仅适用于您的商店已登录的客户。

automatic1.png

自动支付激活

  1. 转到 模块配置。
  2. 填写 自动支付协议 (Autopay Agreement) 以适当的条款 - 以供客户接受。
  3. 转到 ID 为 1503 且类型为 自动支付 的网关编辑。
  4. 设置选项 将其视为单独的支付方式 (Is separated method).
  5. 刷新缓存。

管理卡片

在首次使用自动支付进行正确交易并接受服务条款后，信用卡将被记住并绑定到客户账户。

客户可以从您的在线商店账户中删除保存的信用卡 - 他们只需

  1. 登录
  2. 从顶部菜单中选择 我的账户 (My account)
  3. 从左侧菜单中选择 保存的信用卡 (Saved payment cards)。此时将显示保存的信用卡列表： automatic2.png
  4. 点击 删除 并确认

从管理面板生成订单

此模块允许在管理面板直接创建订单的情况下向客户发送支付链接。为此，在创建订单时，请选择自动支付支付方式。

admin1.png

支付链接将通过 Autopay 发送到客户数据中显示的电子邮件地址。

admin2.png

电子邮件模板

对于消息

  • email_creditmemo_set_template_vars_before
  • email_invoice_set_template_vars_before
  • email_order_set_template_vars_before
  • email_shipment_set_template_vars_before 模块扩展了可用变量的列表，增加了 payment_channel。在模板中的示例使用： {{var payment_channel|raw}}

等待页面

模块允许在将用户重定向到支付之前添加一个中间页面。此功能可用于例如在 Google Analytics 中跟踪电子商务。

使用的模板： view/frontend/template/redirect.phtml

激活

要激活等待页面

  1. 转到 模块配置
  2. 在 显示重定向前等待页面 (Show waiting page before redirect) 选项旁边设置 启用 (Enable)
  3. 设置 重定向前的等待秒数 (Seconds to wait before redirect) – 以确定页面应显示多长时间。
  4. 刷新缓存。

退款

模块允许通过在线更正发票 (在线 贷项通知单) 以及直接从订单中直接将退款退回到原始支付账户。

通过贷项通知单退款

为了以这种方式进行退货

  1. 转到订单的 发票 (Invoice) 详细信息。
  2. 在顶部菜单中点击 调整发票 (Credit Memo)。
  3. 填写表格，输入要退货的项目数量以及费用金额。
  4. 点击 退货 (Refund) 以确认操作。

退货将自动生成。

直接退货

此选项允许将钱直接退回到支付的客户账户。要使用此选项

  1. 转到 模块配置 并在 启用 (Enable) 选项旁勾选 在订单详细信息中显示手动Autopay退货 (Show manual Autopay refund in order details)。这样，此选项将适用于通过此模块支付的所有已完成订单。

  2. 然后转到订单详细信息。

  3. 如果订单是使用Autopay支付方式支付的，则在上部菜单中应可见“Autopay退货”按钮。

    refund1.png

  4. 点击它后，您将看到允许进行全额或部分退货的窗口。

    1. 在部分退货的情况下，请输入格式为“000.00”的金额（点作为小数分隔符）

  5. 通过点击 确定 (OK) 确认退货订单，系统将显示确认退货完成的消息或退货失败的原因

  6. 退货信息可见

    1. 在订单注释中

      refund2.png

    2. 在交易列表中

      refund3.png

多地址配送 (multishipping)

此模块允许使用多地址配送功能支付订单。请根据 文档中的说明 配置配送

支付模块无需进行任何额外操作。Autopay支付将立即可用。

注意！

多地址配送模式的模块仅支持在商店页面上显示可用的支付渠道以及自动支付。无法启动Google Pay和BLIK 0支付。对于多地址配送订单，OrderID在客户收到的消息以及在 portal.autopay.eu仪表板中将是带有前缀QUOTE_的购物车编号，而不是订单编号。

支付信息

客户选择的支付渠道信息在订单列表（Order grid）中可见。
为此，请向视图添加 支付渠道 (Payment Channel) 列。
支付渠道的文本信息将在表中可见。

所选支付渠道的信息已记录在数据库中

  • 在 sales_order 表的 blue_gateway_id （渠道id）和 payment_channel （渠道名称）列中
  • 在 sales_order_grid 表的 payment_channel （渠道名称）列中

扩展分析 - Google Analytics 4电子商务

从版本2.19.0开始提供此选项。

通过此解决方案，您可以更详细地分析客户的购买路径。
完成以下配置后，Google Analytics 将开始收集有关用户行为的详细数据。

模块添加了对Google Analytics 4的额外事件支持

  • view_item_list - 用户在列表中看到产品
  • view_item - 用户查看产品页面
  • add_to_cart - 用户将产品添加到购物车
  • remove_from_cart - 用户从购物车中删除产品
  • begin_checkout - 用户开始下订单（购物车和/或选择配送方式）
  • checkout_progress - 用户进入订单的第二步（选择支付方式）
  • set_checkout_option - 用户填写订单信息
  • purchase - 用户提交订单并使用Autopay支付（将其标记为转换）

创建新的Google Analytics API密钥

  1. 转到 Google Analytics。
  2. 转到 管理（Admin）。
  3. 选择相应的账户及服务。
  4. 点击 数据流（Streams）。
    ga1.png
  5. 点击分配给您商店的相应数据流。 ga2.png 如果您之前没有创建数据流，可以通过点击 添加数据流（Add stream） -> 网络（Web） -> 填写商店的网址、数据流名称，然后点击 创建数据流（Create stream） 来创建。
  6. 选择 测量协议平台密钥（Measurement Protocol platform secret）（在 附加设置（Additional Settings） 表格中）。 ga3.png
  7. 点击 创建（Create）。

Google Analytics 配置

  1. 从菜单中选择 商店（Stores） -> 配置（Configuration） -> 销售（Sales） -> Google API。
    analytics1.png
  2. 在 启用（Enabled） 上选择 是（Yes）。
  3. 在 账户号码（GA4） 字段中输入跟踪代码（格式为 G-XXXXXXXXXX）。
  4. 输入根据上述说明生成的 API 密钥。
    analytics2.png
  5. 点击 保存配置（Save Config）。
  6. 刷新缓存。

调用事件

从版本2.19.0开始提供此选项。

收到新的支付状态时，会调用以下事件之一

  • bluemedia_payment_failure – 支付失败
  • bluemedia_payment_pending – 支付待处理
  • bluemedia_payment_success – 支付成功

事件在保存新的订单状态后触发。
在事件中，传递以下数据

  • order – \Magento\Sales\Model\Order 实例
  • payment – \Magento\Sales\Model\OrderPayment 实例
  • transaction_id – Autopay 系统中的交易标识符（string）

推广延迟支付/分期付款

为什么值得推广？

  • 更高的销售额
  • 更少的弃购率
  • 更多客户

如果客户可以稍后支付或分期付款，他们更愿意以更高的价格购买产品。

仅当特定服务提供 Alior Raty 或 分期付款 支付时才可用。
对于新安装的模块，此选项自动启动 – 对于更新，需要手动配置。

配置

  1. 转到模块配置。
  2. 在 推广支付（Promoting payments） 选项卡中，指定推广支付将在哪些位置显示。 cf1.png

示例可视化

页面顶部（At the top of the page）
cf2.png

在导航下（Under the navigation）
cf3.png

产品列表上（On the product list）
cf4.png

在产品页面下的按钮（On the product page under the buttons）
cf5.png

在购物车下的产品（In the shopping cart under the products）
cf6.png

GraphQL 支持以及与 Magento PWA 的集成

可以将此解决方案与我们的插件集成。有关 GraphQL 和 Magento PWA 的详细信息，请参阅相关章节。

更新

通过 Compose

  1. 执行以下命令
composer update bluepayment-plugin/module-bluepayment
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

通过 .zip 包

  1. 从此页面下载插件的最新版本。
  2. 将 .zip 文件上传到 Magento 主目录
  3. 在 Magento 主目录中，执行以下命令
unzip -o -d app/code/BlueMedia/BluePayment bm-bluepayment-*.zip && rm bm-bluepayment-*.zip
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush
  1. 模块已经激活。

禁用模块

使用命令行禁用

  1. 在 Magento 的主目录中，执行以下命令
bin/magento module:disable BlueMedia_BluePayment --clear-static-content
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

通过管理面板禁用（仅适用于 Magneto 2.3 版本）

  1. 登录到管理面板后，从主菜单中选择 系统 -> Web Setup Wizard。系统会要求您重新登录。

  2. 转到 组件管理器（Component Manager），在列表中找到模块 BlueMedia/BluePayment，点击 选择，然后点击 禁用。

    dezactivation1.png

  3. 单击 开始就绪检查 以启动依赖性验证的执行，然后单击 下一步。

  4. 如果您愿意，此时可以创建代码、媒体和数据库的备份，点击 创建备份。

    dezactivation2.png

  5. 执行备份后（或取消选中此选项） - 点击 下一步 以继续。

  6. 点击 禁用，以在禁用模块期间关闭商店。

  7. 禁用可能需要几分钟。如果成功完成，您将看到以下消息： dezactivation3.png

清理文件和数据库（可选）

  1. 在 Magento 的主目录下 - 删除目录：app/code/BlueMedia
  2. 执行以下数据库查询
DROP TABLE blue_card;
DROP TABLE blue_gateway;
DROP TABLE blue_refund;
DROP TABLE blue_transaction;
  1. 为了删除模块的全部配置 - 执行以下数据库查询
DELETE FROM core_config_data WHERE path LIKE 'payment/bluepayment%';

Magento 2 的自动支付结账

有关实施自动支付结账的文档，请参阅 Github 上的文档。