拆分支付POC：测试和验证指南

本指南将指导您按照应测试的顺序验证每个组件是否正常工作。 从下开始（Commerce模块），然后再从上开始(App Builder)。

步骤1 — 验证Commerce模块的安装

运行bin/magento setup:upgrade和bin/magento setup:di:compile后：

# Confirm module is enabled
bin/magento module:status Client_SplitPayment

# Confirm db_schema columns were added
bin/magento doctrine:schema:validate
# or check directly:
mysql -u <user> -p <dbname> -e "DESCRIBE sales_order;" | grep split

预期输出：在sales_order中显示以split_开头的四列。

步骤2 — 验证Commerce管理配置

在Commerce Admin中：

步骤3 — 验证REST端点是否可访问

使用curl确认端点响应（它们会拒绝未授权请求，但401会确认它们已正确路由）：

# Should return 401 (not 404) — endpoint exists but requires auth
curl -X POST https://your-store.example.com/rest/V1/split-payment/orders/1/cash-received

# Should return 200 or session-based response — anonymous endpoint
curl -X POST https://your-store.example.com/rest/V1/split-payment/set \
  -H "Content-Type: application/json" \
  -d '{"storeCreditAmount": 0, "cashAmount": 0}'

步骤4 — 测试签出UI

Test validation:

Step 5 — Test Threshold Guard

Step 6 — Place a Test Split Payment Order

After order placement, verify in Commerce Admin:

If no App Builder comments appear: Check App Builder action logs with aio app logs. The event may not have fired or the action may have an error.

Step 7 — Test Accept via Simulation Script

The simulation script is the fastest way to test the accept/decline flow without the full operator UI.

cd commerce-checkout-starter-kit
cp commerce-backend-ui-1/.env.simulation.example commerce-backend-ui-1/.env.simulation
# Edit .env.simulation with your credentials

# List recent orders (find your test order entity_id)
node commerce-backend-ui-1/scripts/simulate-split-payment.mjs list

# Show split payment fields for a specific order
node commerce-backend-ui-1/scripts/simulate-split-payment.mjs show 42

# Accept the cash payment
node commerce-backend-ui-1/scripts/simulate-split-payment.mjs accept 42

After accept, verify in Commerce Admin order view:

Step 8 — Test Decline via Simulation Script

Place another test order (same setup as Step 6), then:

node commerce-backend-ui-1/scripts/simulate-split-payment.mjs decline <orderId>

After decline, verify in Commerce Admin:

Step 9 — Test the Demo Dashboard

After deploying the split-payment-orchestrator, aio app deploy prints the action URLs.

Open the demo-dashboard URL in a browser:

https://[runtime-host]/api/v1/web/split_payment_orchestrator/demo-dashboard

If DEMO_UI_SECRET is set:

https://[runtime-host]/api/v1/web/split_payment_orchestrator/demo-dashboard?secret=<your-secret>

With a pending order:

Step 10 — Test App Builder Action Logs

# Follow logs in real-time
aio app logs --tail

# Or view last invocations
aio runtime activation list --limit 10
aio runtime activation logs <activation-id>

For the payment-orchestrator, look for:

[INFO] Split payment orchestration finished { orderId: '42' }

For payment-accept or payment-decline:

[INFO] Cash payment accepted on Commerce via REST { orderId: '42' }

Common Issues and Fixes

“The signature is invalid” from Commerce OAuth

Cause: Clock skew between App Builder runtime and Commerce, or an OAuth signing bug.

Fix:

Split payment fields not appearing in checkout

Cause: LayoutProcessorPlugin injection paths don’t match your checkout layout.

Fix:

Store credit not applying / “Payment could not be processed” at place order

Cause: Usually one of the edge case plugins not working correctly.

Check:

App Builder action receives event but orderId is missing

Cause: The io_events.xml field list doesn’t include entity_id, or the event payload shape changed.

修复：

订单未显示在演示仪表板中

原因： Commerce REST orders搜索条件未返回订单，或split_cash_status字段不在REST响应中。

修复：

验证核对清单

Related split payment POC resources