拆分付款POC：先决条件和环境设置

在运行任何生成提示之前，请完成本教程中的每个步骤。 缺少一个步骤是教程中期流量中断的最常见原因。

​1. Adobe Commerce要求

仅限Commerce Cloud：启用I/O事件

添加模块之前，请将以下内容添加到.magento.env.yaml并进行部署：

stage:
  global:
    ENABLE_EVENTING: true

警告：​必须成功完成此部署才能解决I/O事件模块依赖关系。

​2. Commerce管理配置

先执行这些步骤，然后再执行其他操作。 签出JavaScript取决于完全匹配的字符串。

2a. 使用确切标题启用“货到付款”

Stores > Configuration > Sales > Payment Methods > Cash On Delivery Payment

注意：​如果您的商店使用其他货到付款(COD)实现或标题，请在Commerce模块中调整payment-method-helper.js。

2b. 启用商店点数

Stores > Configuration > Customers > Customer Configuration > Store Credit Options

2c. 向测试客户添加商店积分

Customers > All Customers > [您的测试客户] > Store Credit > Update Balance

在商店积分中添加至少​$50。 您将使用总金额在100美元以下的订单进行测试。

2d 创建Commerce集成

System > Integrations > Add New Integration

选择​Save，然后选择​Activate。

复制所有四个值；它们只显示一次：

安全地存储这些值。 您在每个App Builder .env文件中都需要这些文件。

​3. Adobe Developer Console和App Builder

概念验证中使用的事件代码为： com.adobe.commerce.observer.sales_order_place_before

如果您尚未将Commerce作为事件提供程序进行连接，请参阅Commerce扩展性指南中的配置Commerce以向Adobe I/O发出事件。

​4. 本地开发环境

# Required versions
node --version    # 18.x or later
npm --version     # any recent version

# Adobe I/O CLI
npm install -g @adobe/aio-cli

# Authenticate
aio login

# Select your project and workspace
aio app use
# Confirm the org, project, and workspace shown are correct

​5. 需要了解的两个项目目录

本教程使用两个单独的目录根。 把它们分开。

Commerce项目根（您的Magento Git存储库）：

<commerce-root>/
└── app/code/Client/SplitPayment/   ← Module goes here

App Builder项目根（源包中的split-payment-orchestrator文件夹，或您创建的新项目）：

split-payment-orchestrator/
├── app.config.yaml
├── package.json
├── .env                            ← Copy from .env.example, then fill in
└── actions/

​6. entity_id与increment_id比较

在REST调用中始终使用entity_id（数字数据库ID），而不是increment_id（例如000000042）。

从​ Commerce Admin ​订单URL中查找entity_id：

/admin/sales/order/view/order_id/42/   →   entity_id = 42

或者，从模拟脚本中：

node scripts/simulate-split-payment.mjs show 42

​7. 100美元的门槛

拆分付款UI和阈值保护目标订单​$100.00或更少。 流的行为如下所示：

要进行测试，请构建其小计、运费和税为​ 小于或等于$100 ​的购物车（例如，低于$90的商品，因此运费和税费仍低于上限）。

阈值存储在以下位置：

​8. Fastly（仅限Commerce Cloud）

App Builder操作会通过REST (/rest/V1/split-payment/orders/...)调用Commerce。 如果您的Commerce Cloud项目使用Fastly进行IP，则必须App Builder运行时出口IP地址。

如何检查：​首先运行模拟脚本（直接使用OAuth签名进行curl）。 如果这有效，但App Builder操作返回403，则Fastly可能会阻止该请求。

使用Adobe当前有关App Builder出口IP范围的文档，并根据需要将它们添加到您的Fastly配置中。

验证核对清单

在开始生成提示之前，请确认以下内容：

Related split payment POC resources