分割支払いPOC: App Builder orchestrator AI プロンプト

このページを使用して、split-payment-orchestrator プロジェクトを生成するプロンプト全体をコピーします。payment-orchestrator I/O イベントコンシューマー、payment-accept​および​payment-decline web アクション、demo-dashboard、およびCommerce REST クライアント。

このプロンプトの使用方法

プロンプト開始​から​ プロンプト終了 ​までのすべての項目をカーソル（Claudeを含む）または直接Claudeにコピーします。 split-payment-orchestrator/ ディレクトリ （App Builder プロジェクトのルート）からプロンプトを実行します。

実行する前

プロンプト

プロンプト開始

Adobe Commerceで分割支払いのオーケストレーションを行うためのAdobe App Builder アプリケーション全体を生成します。 このアプリケーションは、CommerceからI/O イベントを受け取り、分割された支払い決定を処理し、REST経由でCommerceに呼び出します。

プロジェクト： split-payment-orchestrator
ランタイム： Node.js 18
主要な依存関係： @adobe/aio-sdk ^6.0.0、got ^11.8.6、oauth-1.0a ^2.2.6

以下のすべてのファイルを生成します。 アプリケーションはAdobe I/O Runtime （aio app deploy）で動作する必要があります。

生成するファイル構造

split-payment-orchestrator/
├── package.json
├── app.config.yaml
├── .env.example
└── actions/
    ├── payment-orchestrator/
    │   ├── index.js         ← I/O Event entry point
    │   ├── commerce-client.js
    │   ├── threshold.js
    │   ├── cash-payment.js
    │   ├── order-update.js
    │   └── store-credit.js  ← Deprecated stub; kept for reference
    ├── payment-accept/
    │   └── index.js
    ├── payment-decline/
    │   └── index.js
    └── demo-dashboard/
        └── index.js

package.json

{
  "name": "split-payment-orchestrator",
  "version": "1.0.0",
  "private": true,
  "description": "Adobe App Builder action — split payment PoC orchestrator",
  "engines": { "node": ">=18" },
  "scripts": {
    "deploy": "NODE_OPTIONS=--disable-warning=DEP0040 aio app deploy",
    "aio": "NODE_OPTIONS=--disable-warning=DEP0040 aio"
  },
  "dependencies": {
    "@adobe/aio-sdk": "^6.0.0",
    "@adobe/exc-app": "^1.5.9",
    "got": "^11.8.6",
    "oauth-1.0a": "^2.2.6"
  }
}

app.config.yaml

split_payment_orchestrator パッケージで4つのアクションを定義します。

payment-orchestrator

payment-accept

payment-decline

demo-dashboard

イベント登録 （events.registrations以下）:

Split payment — sales order place before:
  description: Invokes payment-orchestrator when an order is about to be placed
  events_of_interest:
    - provider_metadata: dx_commerce_events
      event_codes:
        - com.adobe.commerce.observer.sales_order_place_before
  runtime_action: split_payment_orchestrator/payment-orchestrator

actions/payment-orchestrator/commerce-client.js

Adobe Commerce用のShared OAuth 1.0a REST クライアント。 実装：

createCommerceClient(params, logger) — { request, baseUrl }を返します

actions/payment-orchestrator/threshold.js

evaluateThreshold({ orderTotal, storeCreditAmount, cashAmount, params, logger }) — { pass: boolean, reason: string }を返します

ロジック：

actions/payment-orchestrator/cash-payment.js

recordCashPending({ commerce, orderId, cashAmount, logger }) — { ok: boolean, error? }を返します

actions/payment-orchestrator/order-update.js

updateOrderAfterOrchestration({ commerce, orderId, success, detail, logger }) — { ok: boolean, error? }を返します

actions/payment-orchestrator/store-credit.js

applyStoreCredit({ commerce, cartId, amount, logger }) – 非推奨のno-op実装

このファイルをJSDoc @deprecatedの通知に含めて、次のことを説明します。

オーケストレーターは、RESTを介してストアクレジットを適用しなくなりました。 ストアのクレジットは、チェックアウト時にBalanceManagementInterface::apply()を使用してCommerce PHP モジュール（PlaceOrderPlugin）に適用されます。このモジュールでは、アクティブなカートが必要です。 App BuilderがI/O イベントを受け取るまでに、カートは非アクティブになります。 このファイルは、参照用またはストアクレジットが注文の後に適用されるカスタムフロー用に保持されます。

開発者がパターンを学習できるように、作業中の実装（他のモジュールと同じ形状）を維持しますが、現在のフローで使用されていないとして明確にマークします。

actions/payment-orchestrator/index.js

I/O イベントエントリポイント。 async function main(params)を実装します。

ペイロード抽出：

Adobe Commerce I/O Eventsは、ペイロードを複数の形状で配信する場合があります。 次のパスを順番にチェックして、注文値オブジェクトを抽出します。

値からのフィールド抽出：

フロー：

重要：​常にstatusCode: 200を返す – I/O Runtimeは200件以外の応答を再試行します。これにより、注文処理が重複します。 誤りが体に報告されます。

PUBLIC_ERROR定数： "Payment could not be processed. Please try again or contact support." – すべての外部向けエラーメッセージに使用されます。

actions/payment-accept/index.js

HTTP web アクション。 POST /V1/split-payment/orders/:orderId/cash-receivedを呼び出します。

注文ID解決： params.orderId、次にparams.payload.orderId、次にparams.__ow_body （解析されたJSON）を確認します。 見つからない場合は400を返します。

フロー：

actions/payment-decline/index.js

HTTP web アクション。 payment-acceptと同じパターンですが、POST /V1/split-payment/orders/:orderId/cash-declineを呼び出します。

成功時に{ ok: true, orderId, message: 'declined' }を返します。

actions/demo-dashboard/index.js

自己完結型のデモオペレーターダッシュボード。 保留中の現金注文を一覧表示し、承認/拒否アクションをトリガーするHTML ダッシュボードを提供します。 これは、HTML UIとJSON APIの両方を提供する単一のweb アクションです。

セキュリティ：

ルーティング （HTTP メソッド + パス/本文に基づく）:

アクションはすべてのリクエストを受信します。 インテントの決定方法：

保留中の注文を取得しています：

HTML ダッシュボード：
ダッシュボードは、Content-Type: text/htmlで返されるHTML文字列です。 次のようなことが必要です。

UIでのエラーの表示：
Commerce REST呼び出しが失敗した場合は、HTTP ステータスとCommerce エラー本文の簡単な説明を含めます（sanitize — HTML タグをストリップし、500文字まで切り捨てます）。 資格情報は公開しないでください。

応答ヘルパー：

function jsonResponse(statusCode, obj, extraHeaders = {}) { ... }
function htmlResponse(html) { ... }

.env.example

# Commerce REST base URL — no trailing slash
COMMERCE_BASE_URL=

# OAuth 1.0a integration credentials (Admin → System → Integrations)
COMMERCE_CONSUMER_KEY=
COMMERCE_CONSUMER_SECRET=
COMMERCE_ACCESS_TOKEN=
COMMERCE_ACCESS_TOKEN_SECRET=

# PoC threshold — must match split_payment/general/threshold in Commerce (default: 100)
PAYMENT_THRESHOLD=100

LOG_LEVEL=info

# Demo dashboard optional shared secret
DEMO_UI_SECRET=
DEMO_UI_BASE_URL=

Deploy コマンド

すべてのファイルを生成した後、split-payment-orchestrator/ ディレクトリから：

npm install
cp .env.example .env
# Edit .env with your credentials
aio app deploy

デプロイメント後、aio app deployによって印刷されたアクション URLに注意してください。 demo-dashboard URLは、オペレーターダッシュボードにアクセスする場所です。

プロンプトの終了

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