Split payment POC: testing and verification guide

This guide walks you through verifying that every component works correctly, in the order they should be tested. Start from the bottom (Commerce module) and work up (App Builder).

Step 1 — Verify Commerce Module Installation

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

Expected output: four columns starting with split_ visible in sales_order.

Step 2 — Verify Commerce Admin Configuration

In Commerce Admin:

Step 3 — Verify REST Endpoints Are Accessible

Use curl to confirm the endpoints respond (they will reject unauthorized requests, but a 401 confirms they’re routed correctly):

# 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}'

Step 4 — Test the Checkout UI

テスト検証：

ステップ 5 - テストしきい値ガード

ステップ 6 - テスト分割支払い注文を行う

注文後、Commerce Adminで次の項目を確認します。

App Builder コメントが表示されない場合： App Builderのアクションログをaio app logsで確認します。 イベントが起動しなかったか、アクションにエラーがある可能性があります。

ステップ 7 - シミュレーションスクリプトを使用したテスト受け入れ

シミュレーションスクリプトは、オペレーター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

承認したら、Commerce管理者注文ビューで確認します。

ステップ 8 - シミュレーションスクリプトを使用したテスト拒否

別のテスト注文（ステップ 6と同じ設定）を行ってから：

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

辞退後、Commerce管理者で次の項目を確認します。

ステップ 9 - デモダッシュボードをテストする

split-payment-orchestratorをデプロイした後、aio app deployはアクション URLを印刷します。

ブラウザーでdemo-dashboard URLを開きます：

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

DEMO_UI_SECRETが設定されている場合：

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

保留中の注文の場合：

ステップ 10 - App Builder アクションログのテスト

# 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>

payment-orchestratorの場合、次を探します。

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

payment-acceptまたはpayment-declineについて：

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

一般的な問題と修正

Commerce OAuthの「署名が無効です」

原因： App Builder ランタイムとCommerceの間のクロックスキュー、またはOAuth署名バグ。

修正：

チェックアウト時に分割支払いフィールドが表示されない

原因： LayoutProcessorPlugin インジェクション パスがチェックアウト レイアウトと一致しません。

修正：

ストアクレジットが適用されない/「支払いを処理できませんでした」プレースオーダー

原因：​通常、エッジ ケース プラグインのいずれかが正しく機能しません。

確認：

App Builder アクションはイベントを受け取りますが、orderIdがありません

原因： io_events.xml フィールドリストにentity_idが含まれていないか、イベントペイロードの形状が変更されています。

Fix:

Orders don’t show in demo dashboard

Cause: Commerce REST orders search criteria not returning orders, or split_cash_status field not in the REST response.

Fix:

Verification Checklist

関連する分割支払POC リソース