POC van gesplitste betaling: App Builder Orchestrator AI prompt

Gebruik deze pagina om de volledige herinnering te kopiëren die het spleet-betaling-orchestrator project produceert: betalings-orchestrator I/O de consument van de Gebeurtenis, betaling-goedkeurt en betaling-daling Webacties, demo-dashboard, en de cliënt van Commerce REST.

Hoe deze herinnering te gebruiken

Kopieer alles van PROMPT START aan Eind van herinnering in Cursor (met Claude) of direct in Claude. Voer de vraag uit vanuit de map split-payment-orchestrator/ (de App Builder-projecthoofdmap).

Voordat u gaat werken

De vraag

PROMPT START

U genereert een volledige Adobe App Builder-toepassing voor het ordenen van gesplitste betalingen in Adobe Commerce. Deze toepassing ontvangt I/O-gebeurtenissen van Commerce, verwerkt gesplitste betalingsbeslissingen en roept via REST terug naar Commerce.

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

Genereer alle hieronder vermelde bestanden. De toepassing moet werken met Adobe I/O Runtime (aio app deploy).

Te genereren bestandsstructuur

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

Definieer vier acties in het split_payment_orchestrator -pakket:

payment-orchestrator

payment-accept

payment-decline

demo-dashboard

de registratie van Gebeurtenissen (onder 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

Shared OAuth 1.0a REST client for Adobe Commerce. Implementeert:

createCommerceClient(params, logger) — retourneert { request, baseUrl }

actions/payment-orchestrator/threshold.js

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

Logica:

actions/payment-orchestrator/cash-payment.js

recordCashPending({ commerce, orderId, cashAmount, logger }) — retourneert { ok: boolean, error? }

actions/payment-orchestrator/order-update.js

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

actions/payment-orchestrator/store-credit.js

applyStoreCredit({ commerce, cartId, amount, logger }) — vervangen no-op-implementatie

Neem dit bestand op met een JSDoc @deprecated -kennisgeving waarin het volgende wordt uitgelegd:

De beheerder past geen opslagkrediet meer toe via REST. Winkelcreditering wordt toegepast bij het afrekenen in de Commerce PHP-module (PlaceOrderPlugin) met BalanceManagementInterface::apply() . Hiervoor is een actieve winkelwagentje vereist. Tegen de tijd dat App Builder de I/O-gebeurtenis ontvangt, is het winkelwagentje inactief. Dit bestand wordt ter referentie bewaard of voor aangepaste stromen waarbij winkelkrediet na bestelling wordt toegepast.

Houd een werkende implementatie (de zelfde vorm zoals andere modules) zodat kunnen de ontwikkelaars het patroon bestuderen, maar het duidelijk merken als niet gebruikt in de huidige stroom.

actions/payment-orchestrator/index.js

I/O-gebeurtenisitem. Implementeert async function main(params) .

de extractie van de lading:

Adobe Commerce I/O-gebeurtenissen kunnen de lading in verschillende vormen leveren. Extraheer het object voor de ordewaarde door deze paden op volgorde te controleren:

de extractie van het Gebied van waarde:

Stroom:

Belangrijk: keer altijd terug statusCode: 200 — I/O Runtime zal niet-200 reacties opnieuw proberen, die dubbele ordeverwerking zou veroorzaken. Fouten worden in het lichaam gemeld.

PUBLIC_ERRORconstante: "Payment could not be processed. Please try again or contact support." — wordt gebruikt voor alle naar buiten gerichte foutberichten.

actions/payment-accept/index.js

HTTP-webactie. Roept POST /V1/split-payment/orders/:orderId/cash-received aan.

de resolutie van identiteitskaart van de Orde: Controle params.orderId, toen params.payload.orderId, toen params.__ow_body (ontleed JSON). Retourneer 400 als deze ontbreekt.

Stroom:

actions/payment-decline/index.js

HTTP-webactie. Hetzelfde patroon als payment-accept , maar roept POST /V1/split-payment/orders/:orderId/cash-decline aan.

Retourneer { ok: true, orderId, message: 'declined' } bij succes.

actions/demo-dashboard/index.js

Onafhankelijk demo-operatordashboard. Hiermee wordt een HTML-dashboard weergegeven voor het aanbieden van lopende kasopdrachten en voor het activeren van acties voor accepteren/afwijzen. Dit is één webactie die zowel de HTML-gebruikersinterface als een JSON-API dient.

Veiligheid:

Verpletterend (die op de methode van HTTP + weg/lichaam) wordt gebaseerd:

De handeling ontvangt alle aanvragen. Intentie bepalen uit:

het Ophalen van hangende orden:

HTML Dashboard:
Het dashboard is een HTML-tekenreeks die wordt geretourneerd met Content-Type: text/html . Zij moet:

Fout die in UI surft:
Wanneer een Commerce REST-aanroep mislukt, neemt u de HTTP-status op en een korte beschrijving van de Commerce-fouttekst (ontsmetten — HTML-tags verwijderen, afkappen tot 500 tekens). Geen referenties beschikbaar maken.

Response helpers:

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 Command

After generating all files, from the split-payment-orchestrator/ directory:

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

After deployment, note the action URLs printed by aio app deploy. The demo-dashboard URL is where you access the operator dashboard.

End of prompt

Gerelateerde gesplitste betalingen POC-middelen