Aufspaltung des Zahlungs-POC: App Builder Orchestrator-KI-Eingabeaufforderung

Verwenden Sie diese Seite, um die vollständige Eingabeaufforderung zu kopieren, die das Projekt split-payment-orchestrator generiert: die Web-Aktionen payment-orchestrator I/O Event Consumer, payment-accepted und payment-decreased, demo-dashboard und den Commerce REST-Client.

So verwenden Sie diese Eingabeaufforderung

Kopieren Sie alles von PROMPT START bis Ende der Eingabeaufforderung nach Cursor (mit Claude) oder direkt nach Claude. Führen Sie die Eingabeaufforderung aus dem split-payment-orchestrator/ Verzeichnis (dem App Builder-Projektstamm) aus.

Vor der Ausführung

Die Eingabeaufforderung

PROMPT START

Sie generieren ein vollständiges Adobe App Builder-Programm zur Orchestrierung von Split-Zahlungen in Adobe Commerce. Diese Anwendung empfängt E/A-Ereignisse von Commerce, verarbeitet aufgeteilte Zahlungsentscheidungen und ruft über REST wieder zu Commerce auf.

Projekt: split-payment-orchestrator
runtime: Node.js 18
Schlüsselabhängigkeiten: @adobe/aio-sdk ^6.0.0, got ^11.8.6, oauth-1.0a ^2.2.6

Generieren Sie alle unten aufgeführten Dateien. Die Anwendung muss mit Adobe I/O Runtime (aio app deploy) funktionieren.

Zu erzeugende Dateistruktur

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

Definieren Sie vier Aktionen im split_payment_orchestrator:

payment-orchestrator

payment-accept

payment-decline

demo-dashboard

Ereignisregistrierung (unter 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

Freigegebener OAuth 1.0a REST-Client für Adobe Commerce. Implementiert:

createCommerceClient(params, logger) — gibt { request, baseUrl } zurück

actions/payment-orchestrator/threshold.js

evaluateThreshold({ orderTotal, storeCreditAmount, cashAmount, params, logger }) — gibt { pass: boolean, reason: string } zurück

Logik:

actions/payment-orchestrator/cash-payment.js

recordCashPending({ commerce, orderId, cashAmount, logger }) — gibt { ok: boolean, error? } zurück

actions/payment-orchestrator/order-update.js

updateOrderAfterOrchestration({ commerce, orderId, success, detail, logger }) — gibt { ok: boolean, error? } zurück

actions/payment-orchestrator/store-credit.js

applyStoreCredit({ commerce, cartId, amount, logger }) — deprecated no-op implementation

Include this file with a JSDoc @deprecated notice explaining:

The orchestrator no longer applies store credit via REST. Store credit is applied at checkout in the Commerce PHP module (PlaceOrderPlugin) using BalanceManagementInterface::apply(), which requires an active cart. By the time App Builder receives the I/O Event, the cart is inactive. This file is kept for reference or for custom flows where store credit is applied post-order.

Keep a working implementation (same shape as other modules) so developers can study the pattern, but mark it clearly as not used in the current flow.

actions/payment-orchestrator/index.js

I/O Event entry point. Implements async function main(params).

Payload extraction:

Adobe Commerce I/O Events may deliver the payload in several shapes. Extract the order value object by checking these paths in order:

Field extraction from value:

Flow:

Wichtig: Immer statusCode: 200 zurückgeben - I/O Runtime versucht es mit Nicht-200-Antworten erneut, was zu einer doppelten Bestellverarbeitung führen würde. Fehler werden im Hauptteil gemeldet.

PUBLIC_ERROR: "Payment could not be processed. Please try again or contact support." - Wird für alle Fehlermeldungen verwendet, die nach außen gerichtet sind.

actions/payment-accept/index.js

HTTP-Web-Aktion. Ruft POST /V1/split-payment/orders/:orderId/cash-received auf.

Reihenfolge-ID-Auflösung: Überprüfen Sie params.orderId, dann params.payload.orderId, dann params.__ow_body (geparste JSON). Gibt 400 zurück, wenn fehlt.

Fluss:

actions/payment-decline/index.js

HTTP-Web-Aktion. Dasselbe Muster wie payment-accept, ruft aber POST /V1/split-payment/orders/:orderId/cash-decline auf.

Gibt bei Erfolg { ok: true, orderId, message: 'declined' } zurück.

actions/demo-dashboard/index.js

Eigenständiges Demo-Benutzer-Dashboard. Dient zum Erstellen eines HTML-Dashboards für die Auflistung ausstehender Bargeldbestellungen und das Auslösen von Akzeptieren/Ablehnen von Aktionen. Dies ist eine einzelne Web-Aktion, die sowohl die HTML-Benutzeroberfläche als auch eine JSON-API bereitstellt.

Sicherheit:

Routing (basierend auf HTTP-Methode + Pfad/Hauptteil):

Die Aktion empfängt alle Anfragen. Absicht ermitteln aus:

Abrufen ausstehender Bestellungen:

HTML-Dashboard:
Das Dashboard ist eine mit Content-Type: text/html zurückgegebene HTML-Zeichenfolge. Sie sollte:

Fehler in der Benutzeroberfläche:
Wenn ein Commerce-REST-Aufruf fehlschlägt, geben Sie den HTTP-Status und eine kurze Beschreibung des Commerce-Fehlertexts an (bereinigen - entfernen Sie HTML-Tags, kürzen Sie auf 500 Zeichen). Geben Sie keine Anmeldeinformationen an.

Antwort-Helfer:

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=

Befehl bereitstellen

Nach dem Generieren aller Dateien aus dem split-payment-orchestrator/:

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

Notieren Sie sich nach der Bereitstellung die von aio app deploy ausgedruckten Aktions-URLs. Über die demo-dashboard-URL können Sie auf das Benutzer-Dashboard zugreifen.

Ende der Eingabeaufforderung

Gerelateerde gesplitste betalingen POC-middelen