Aufspaltung des Zahlungs-POC: Voraussetzungen und Einrichtung der Umgebung

Complete every step in this tutorial before you run any of the build prompts. Missing a single step is the most common reason the flow breaks mid-tutorial.

1. Adobe Commerce requirements

Commerce Cloud only: enable I/O eventing

Add the following to .magento.env.yaml and deploy before you add the module:

stage:
  global:
    ENABLE_EVENTING: true

Warning: This deploy must finish successfully before the I/O Event module dependency can resolve.

2. Commerce Admin configuration

Do these steps before anything else. Der Checkout-JavaScript hängt von den exakten Zeichenfolgen-Übereinstimmungen ab.

2a. Enable Cash on Delivery with the exact title

Stores > Configuration > Sales > Payment Methods > Cash On Delivery Payment

Note: If your store uses a different cash-on-delivery (COD) implementation or title, adjust payment-method-helper.js in the Commerce module.

2b. Enable store credit

Stores > Configuration > Customers > Customer Configuration > Store Credit Options

2c. Hinzufügen von Warenkorb-Guthaben zu einem Testkunden

Customers > All Customers > [Ihr Testkunde] > Store Credit > Update Balance

Fügen Sie mindestens $ 50 als Warenkorb hinzu. Testen Sie mit einer Bestellung unter insgesamt $100.

2 T. Erstellen der Commerce-Integration

System > Integrations > Add New Integration

Wählen Sie Save und dann Activate aus.

Kopieren Sie alle vier Werte; sie werden nur einmal angezeigt:

Speichern Sie diese Werte sicher. Sie benötigen sie in jeder App Builder-.env.

​3. Adobe Developer Console und App Builder

Der im Konzeptnachweis verwendete Ereigniscode lautet: com.adobe.commerce.observer.sales_order_place_before

Wenn Sie Commerce nicht als Ereignisanbieter verbunden haben, finden Sie weitere Informationen unter Konfigurieren von Commerce zum Ausgeben von Ereignissen an Adobe I/O im Commerce-Erweiterbarkeitshandbuch.

​4. Lokale Entwicklungsumgebung

# Required versions
node --version    # 18.x or later
npm --version     # any recent version

# Adobe I/O CLI
npm install -g @adobe/aio-cli

# Authenticate
aio login

# Select your project and workspace
aio app use
# Confirm the org, project, and workspace shown are correct

​5. Zwei Projektverzeichnisse

In diesem Tutorial werden zwei separate Ordnerstämme verwendet. Getrennt halten.

Commerce-Projektstamm (Ihr Magento-Git-Repository):

<commerce-root>/
└── app/code/Client/SplitPayment/   ← Module goes here

Stammordner des App Builder-Projekts (der split-payment-orchestrator aus dem Quellpaket oder ein neues Projekt, das Sie erstellen):

split-payment-orchestrator/
├── app.config.yaml
├── package.json
├── .env                            ← Copy from .env.example, then fill in
└── actions/

​6. entity_id verglichen mit increment_id

Verwenden Sie in REST-Aufrufen immer entity_id (die numerische Datenbank-ID), nicht increment_id (z. B. 000000042)

entity_id finden Sie in der Commerce Admin-URL:

/admin/sales/order/view/order_id/42/   →   entity_id = 42

Oder vom Simulationsskript:

node scripts/simulate-split-payment.mjs show 42

​7. Der Schwellenwert von 100 Dollar

Die aufgeteilte Zahlungs-Benutzeroberfläche und der Schwellenwert-Guard zielen auf Bestellungen $100.00 oder weniger ab. Der Fluss verhält sich wie folgt:

Um zu testen, erstellen Sie einen Warenkorb, dessen Zwischensumme, Versand und Steuer kleiner oder gleich 100 $) z. B. ein Produkt unter 90 $, sodass Versand und Steuer immer noch unter die Obergrenze passen).

Der Schwellenwert wird gespeichert in:

​8. Fastly (nur Commerce Cloud)

App Builder-Aktionen rufen Commerce über REST auf (/rest/V1/split-payment/orders/...). Wenn Ihr Commerce Cloud-Projekt Fastly mit IP-Zulassungsauflistung verwendet, müssen die Egress-IP-Adressen der App Builder-Laufzeitumgebung auf die Zulassungsliste gesetzt werden.

Überprüfen: Sie zuerst das Simulationsskript aus (direkte cURL mit OAuth-Signierung). Wenn dies funktioniert, die App Builder-Aktion jedoch 403 zurückgibt, blockiert Fastly wahrscheinlich die Anfrage.

Verwenden Sie die aktuelle Dokumentation von Adobe für App Builder Egress-IP-Bereiche und fügen Sie sie nach Bedarf zu Ihrer Fastly-Konfiguration hinzu.

Verifizierungs-Checkliste

Bevor Sie mit den Buildaufforderungen beginnen, bestätigen Sie Folgendes:

Gerelateerde gesplitste betalingen POC-middelen