POC de pago dividido: petición de App Builder orchestrator AI

Utilice esta página para copiar el aviso completo que genera el proyecto split-payment-orchestrator: el consumidor de eventos de E/S de payment-orchestrator, payment-accept y payment-declina acciones web, el tablero de demostración y el cliente REST de Commerce.

Cómo utilizar este indicador

Copie todo desde INICIO DEL MENSAJE hasta Final del mensaje en el cursor (con Claude) o directamente en Claude. Ejecute la solicitud desde el directorio split-payment-orchestrator/ (la raíz del proyecto de App Builder).

Antes de ejecutar

El indicador

INICIO DEL MENSAJE

Está generando una aplicación Adobe App Builder completa para organizar pagos divididos en Adobe Commerce. Esta aplicación recibe eventos de E/S de Commerce, procesa las decisiones de pago divididas y vuelve a llamar a Commerce a través de REST.

Proyecto: split-payment-orchestrator
Tiempo de ejecución: Node.js 18
Dependencias de clave: @adobe/aio-sdk ^6.0.0, got ^11.8.6, oauth-1.0a ^2.2.6

Genere todos los archivos enumerados a continuación. La aplicación debe funcionar con Adobe I/O Runtime (aio app deploy).

Estructura de archivo para generar

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

Defina cuatro acciones en el paquete split_payment_orchestrator:

payment-orchestrator

payment-accept

payment-decline

demo-dashboard

Registro de eventos (en 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

Cliente REST de OAuth 1.0a compartido para Adobe Commerce. Implementa:

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

actions/payment-orchestrator/threshold.js

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

Lógica:

actions/payment-orchestrator/cash-payment.js

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

actions/payment-orchestrator/order-update.js

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

actions/payment-orchestrator/store-credit.js

applyStoreCredit({ commerce, cartId, amount, logger }): implementación obsoleta sin operación

Incluya este archivo con un aviso de JSDoc @deprecated que explique:

El orquestador ya no aplica crédito de almacén a través de REST. El crédito de tienda se aplica al cierre de compra en el módulo Commerce PHP (PlaceOrderPlugin) usando BalanceManagementInterface::apply(), que requiere un carro de compras activo. Para el momento en que App Builder reciba el evento de E/S, el carro de compras estará inactivo. Este archivo se conserva como referencia o para flujos personalizados en los que el crédito de tienda se aplica después del pedido.

Mantenga una implementación en funcionamiento (la misma forma que otros módulos) para que los desarrolladores puedan estudiar el patrón, pero márquelo claramente como no utilizado en el flujo actual.

actions/payment-orchestrator/index.js

Punto de entrada de evento de E/S. Implementa async function main(params).

Extracción de carga útil:

Los eventos de Adobe Commerce I/O pueden entregar la carga útil de varias formas. Extraiga el objeto de valor del pedido comprobando estas rutas en orden:

Extracción de campo del valor:

Flujo:

Importante: Devolver siempre statusCode: 200: I/O Runtime reintentará las respuestas que no sean 200, lo que causaría el procesamiento de pedidos duplicados. Los errores se registran en el cuerpo del mensaje.

Constante PUBLIC_ERROR: "Payment could not be processed. Please try again or contact support." — se usa para todos los mensajes de error externos.

actions/payment-accept/index.js

Acción web HTTP. Llamadas POST /V1/split-payment/orders/:orderId/cash-received.

Resolución de ID de pedido: Compruebe params.orderId, después params.payload.orderId y después params.__ow_body (JSON analizado). Devuelve 400 si falta.

Flujo:

actions/payment-decline/index.js

Acción web HTTP. El mismo patrón que payment-accept pero llama a POST /V1/split-payment/orders/:orderId/cash-decline.

Devolver { ok: true, orderId, message: 'declined' } si se realizó correctamente.

actions/demo-dashboard/index.js

Panel del operador de demostración independiente. Sirve como panel de control de HTML para listar pedidos de efectivo pendientes y activar acciones de aceptación/rechazo. Se trata de una acción web única que sirve tanto a la interfaz de usuario de HTML como a una API de JSON.

Seguridad:

Enrutamiento (basado en método HTTP + ruta/cuerpo):

La acción recibe todas las solicitudes. Determinar la intención desde:

Recuperando pedidos pendientes:

Panel de HTML:
El tablero es una cadena de HTML devuelta con Content-Type: text/html. Debería:

Error al mostrar en la IU:
Cuando falle una llamada de REST de Commerce, incluya el estado HTTP y una breve descripción del cuerpo del error de Commerce (sanear: eliminar las etiquetas de HTML, truncar a 500 caracteres). No exponga las credenciales.

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

Recursos de POC de pagos fraccionados relacionados