POC de pagamento dividido: prompt do App Builder orchestrator AI

Use esta página para copiar o prompt completo que gera o projeto split-payment-orchestrator: o payment-orchestrator consumidor de Eventos de E/S, payment-accept e payment-deny ações da Web, o demo-dashboard e o cliente REST da Commerce.

Como usar este prompt

Copie tudo de PROMPT START para End of prompt no Cursor (com Claude) ou diretamente no Claude. Execute o prompt a partir do diretório split-payment-orchestrator/ (a raiz do projeto App Builder).

Antes de executar

O prompt

INÍCIO DA SOLICITAÇÃO

Você está gerando um aplicativo completo do Adobe App Builder para orquestrar pagamentos parcelados no Adobe Commerce. Esse aplicativo recebe Eventos de E/S da Commerce, processa decisões de pagamento dividido e retorna chamadas para a Commerce via REST.

Projeto: split-payment-orchestrator
Tempo de execução: Node.js 18
Dependências de chave: @adobe/aio-sdk ^6.0.0, got ^11.8.6, oauth-1.0a ^2.2.6

Gere todos os arquivos listados abaixo. O aplicativo deve funcionar com o Adobe I/O Runtime (aio app deploy).

Estrutura de arquivo a ser gerada

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 quatro ações no pacote split_payment_orchestrator:

payment-orchestrator

payment-accept

payment-decline

demo-dashboard

Registro de eventos (em 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 OAuth 1.0a compartilhado para Adobe Commerce. Implementa:

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

actions/payment-orchestrator/threshold.js

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

Lógica:

actions/payment-orchestrator/cash-payment.js

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

actions/payment-orchestrator/order-update.js

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

actions/payment-orchestrator/store-credit.js

applyStoreCredit({ commerce, cartId, amount, logger }) — implementação no-op obsoleta

Inclua este arquivo com um aviso JSDoc @deprecated explicando:

O orquestrador não aplica mais crédito de armazenamento via REST. O crédito de armazenamento é aplicado no check-out no módulo Commerce PHP (PlaceOrderPlugin) usando BalanceManagementInterface::apply(), que requer um carrinho ativo. Quando a App Builder recebe o evento de I/O, o carrinho fica inativo. Esse arquivo é mantido para referência ou para fluxos personalizados em que o crédito da loja é aplicado após o pedido.

Manter uma implementação em funcionamento (mesma forma que outros módulos) para que os desenvolvedores possam estudar o padrão, mas marcá-lo claramente como não usado no fluxo atual.

actions/payment-orchestrator/index.js

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

Extração de carga:

Os Eventos do Adobe Commerce I/O podem fornecer a carga de várias formas. Extraia o objeto de valor da ordem verificando esses caminhos em ordem:

Extração de campo do valor:

Fluxo:

Importante: sempre retornar statusCode: 200 — o I/O Runtime tentará novamente respostas não-200, o que pode causar processamento de pedido duplicado. Erros são relatados no corpo.

PUBLIC_ERRORconstante: "Payment could not be processed. Please try again or contact support." — usada para todas as mensagens de erro direcionadas para o exterior.

actions/payment-accept/index.js

Ação da Web HTTP. Chama POST /V1/split-payment/orders/:orderId/cash-received.

Resolução da ID do pedido: Verifique params.orderId, depois params.payload.orderId, depois params.__ow_body (JSON analisado). Retorna 400 se estiver faltando.

Fluxo:

actions/payment-decline/index.js

Ação da Web HTTP. Mesmo padrão de payment-accept, mas chama POST /V1/split-payment/orders/:orderId/cash-decline.

Retornar { ok: true, orderId, message: 'declined' } em caso de sucesso.

actions/demo-dashboard/index.js

Painel de operador de demonstração independente. Serve um painel do HTML para listar ordens de caixa pendentes e acionar ações de aceitação/recusa. Essa é uma única ação da Web que atende à interface do usuário do HTML e a uma API JSON.

Segurança:

Roteamento (com base no método HTTP + caminho/corpo):

A ação recebe todas as solicitações. Determinar intenção de:

Buscando pedidos pendentes:

Painel do HTML:
O painel é uma cadeia de caracteres do HTML retornada com Content-Type: text/html. Ele deve:

Erro ao exibir na interface do usuário:
Quando uma chamada REST do Commerce falhar, inclua o status HTTP e uma breve descrição do corpo do erro do Commerce (limpar — retirar as tags do HTML, truncar para 500 caracteres). Não exponha as credenciais.

Auxiliares de resposta:

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=

Implantar Comando

Após gerar todos os arquivos, no diretório split-payment-orchestrator/:

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

Após a implantação, observe as URLs de ação impressas por aio app deploy. A URL demo-dashboard é onde você acessa o painel do operador.

Fim da solicitação

Todos os recursos desta série

Recursos de referência