文档Commerce工具

[仅限PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}

ACP2E-4419：在店面成功进行reCAPTCHA v2验证后，礼品卡在结账时无法正确应用

Last update: Mon Apr 27 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 有经验的
  • 管理员
  • 开发人员

ACP2E-4419补丁修复了在店面成功通过Google reCAPTCHA v2（我不是机器人）验证后，礼品卡不适用于购物车或结账支付步骤的问题。 安装Quality Patches Tool (QPT) 1.1.78时，此修补程序可用。 修补程序ID为ACP2E-4419。 请注意，此问题计划在Adobe Commerce 2.4.9中修复。

受影响的产品和版本

为Adobe Commerce版本创建了修补程序：

  • Adobe Commerce（所有部署方法） 2.4.7-p8

与Adobe Commerce版本兼容：

  • Adobe Commerce（所有部署方法） 2.4.6 - 2.4.7-p9
NOTE
该修补程序可能适用于具有新Quality Patches Tool发行版本的其他版本。 要检查修补程序是否与您的Adobe Commerce版本兼容，请将magento/quality-patches包更新到最新版本，并在Quality Patches Tool：搜索修补程序页面上检查兼容性。 使用修补程序ID作为搜索关键字来查找修补程序。

问题

在店面中成功通过Google reCAPTCHA v2（我不是机器人）验证后，礼品卡不适用于购物车或结账的问题。

重现步骤：

  1. 通过导航到​Stores > Settings > Configuration > Security > Google reCAPTCHA Storefront，在管理员中设置Google reCAPTCHA v2（我不是机器人）。
  2. 为礼品卡启用并配置reCAPTCHA验证。
  3. 使用​Admin > Marketing > Gift Card Accounts​中的有效代码创建礼品卡帐户。
  4. 在店面，将产品添加到购物车。
  5. 将礼品卡代码应用到购物车。
  6. 进入结账付款步骤并应用礼品卡代码。

预期的结果：

在Google reCAPTCHA验证完成后，结帐流程可成功应用礼品卡。

实际结果：

应用礼品卡时，店面显示reCAPTCHA错误​未知宏： {"message"}。

应用修补程序

要应用单独的修补程序，请根据您的部署方法使用以下链接：

相关阅读

要了解有关Quality Patches Tool的更多信息，请参阅：

recommendation-more-help
c2d96e17-5179-455c-ad3a-e1697bb4e8c3