Delad betalning POC: App Builder orchestrator AI prompt

Använd den här sidan om du vill kopiera den fullständiga uppmaningen som genererar projektet split-payment-orchestrator: webbåtgärderna payment-orchestrator I/O Event-konsumenten, payment-accept och payment-deny, demo-dashboard och Commerce REST-klienten.

Hur du använder den här uppmaningen

Kopiera allt från PROMPT START till End of prompt till Cursor (med Claude) eller direkt till Claude. Kör frågan från katalogen split-payment-orchestrator/ (App Builder-projektroten).

Innan du kör

Uppmaningen

UPPMANA START

Du genererar en komplett Adobe App Builder-applikation för att organisera delningar i Adobe Commerce. Programmet tar emot I/O-händelser från Commerce, bearbetar delade betalningsbeslut och återanropar Commerce via REST.

Projekt: split-payment-orchestrator
Runtime: Node.js 18
Nyckelberoenden: @adobe/aio-sdk ^6.0.0, got ^11.8.6, oauth-1.0a ^2.2.6

Generera alla filer som listas nedan. Programmet måste fungera med Adobe I/O Runtime (aio app deploy).

Filstruktur att generera

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

Definiera fyra åtgärder i paketet split_payment_orchestrator:

payment-orchestrator

payment-accept

payment-decline

demo-dashboard

Händelseregistrering (under 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

Delad OAuth 1.0a REST-klient för Adobe Commerce. Implementerar:

createCommerceClient(params, logger) - returnerar { request, baseUrl }

actions/payment-orchestrator/threshold.js

evaluateThreshold({ orderTotal, storeCreditAmount, cashAmount, params, logger }) - returnerar { pass: boolean, reason: string }

Logic:

actions/payment-orchestrator/cash-payment.js

recordCashPending({ commerce, orderId, cashAmount, logger }) - returnerar { ok: boolean, error? }

actions/payment-orchestrator/order-update.js

updateOrderAfterOrchestration({ commerce, orderId, success, detail, logger }) - returnerar { ok: boolean, error? }

actions/payment-orchestrator/store-credit.js

applyStoreCredit({ commerce, cartId, amount, logger }) - borttagen implementering utan åtgärd

Inkludera den här filen med ett JSDoc @deprecated-meddelande som förklarar:

Orchestrator använder inte längre butikskrediter via REST. Butikskrediten används vid utcheckning i Commerce PHP-modulen (PlaceOrderPlugin) med BalanceManagementInterface::apply(), vilket kräver en aktiv kundvagn. När App Builder tar emot I/O-händelsen är vagnen inaktiv. Den här filen sparas som referens eller för anpassade flöden där butikskrediter används efter beställningen.

Behåll en fungerande implementering (samma form som andra moduler) så att utvecklare kan studera mönstret, men markera det tydligt som om det inte används i det aktuella flödet.

actions/payment-orchestrator/index.js

Startpunkt för I/O-händelse. Implementerar async function main(params).

Nyttolastextrahering:

Adobe Commerce I/O Events kan leverera nyttolasten i flera former. Extrahera ordervärdesobjektet genom att kontrollera sökvägarna i ordning:

Fältextrahering från värde:

Flöde:

Viktigt! Returnera alltid statusCode: 200 - I/O-körningsmiljön försöker utföra icke-200-svar igen, vilket skulle orsaka dubblettorderbearbetning. Fel rapporteras i kroppen.

PUBLIC_ERROR-konstanten "Payment could not be processed. Please try again or contact support." - används för alla externa felmeddelanden.

actions/payment-accept/index.js

HTTP-webbåtgärd. Samtal POST /V1/split-payment/orders/:orderId/cash-received.

Upplösning för beställnings-ID: Kontrollera params.orderId, sedan params.payload.orderId och sedan params.__ow_body (parsad JSON). Returnera 400 om det saknas.

Flöde:

actions/payment-decline/index.js

HTTP-webbåtgärd. Samma mönster som payment-accept men anropar POST /V1/split-payment/orders/:orderId/cash-decline.

Returnera { ok: true, orderId, message: 'declined' } när åtgärden lyckades.

actions/demo-dashboard/index.js

Instrumentpanel för självständiga demonstrationsoperatorer. Skapar en HTML-kontrollpanel för att lista väntande kassaorder och utlösa åtgärder för att acceptera/avböja. Detta är en enda webbåtgärd som fungerar för både HTML användargränssnitt och JSON API.

Säkerhet:

Routning (baserat på HTTP-metod + sökväg/brödtext):

Åtgärden tar emot alla begäranden. Bestäm metod från:

Hämtar väntande order:

HTML Dashboard:
Kontrollpanelen är en HTML-sträng som returneras med Content-Type: text/html. Den bör

Fel i gränssnittet:
När ett Commerce REST-anrop misslyckas inkluderar du HTTP-statusen och en kort beskrivning av Commerce-felmeddelandet (sanera — strip HTML-taggar, trunkera till 500 tecken). Visa inte autentiseringsuppgifter.

Hjälp med svar:

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=

Distribuera kommando

När du har genererat alla filer från katalogen split-payment-orchestrator/:

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

Observera URL-adresserna som skrivs ut av aio app deploy efter distributionen. URL:en demo-dashboard är den plats där du kommer åt kontrollpanelen för operatorer.

Frågeslut

Relaterade POC-resurser för delad betalning