Gesplitste betalingsconcepttest: test- en verificatiegids

Deze gids begeleidt u door het verifiëren dat elke component correct werkt, in de orde zij zouden moeten worden getest. Begin van onderaan (de module van Commerce) en werk omhoog (App Builder).

Stap 1 — De installatie van Commerce Module verifiëren

Na uitvoering bin/magento setup:upgrade en bin/magento setup:di:compile :

# Confirm module is enabled
bin/magento module:status Client_SplitPayment

# Confirm db_schema columns were added
bin/magento doctrine:schema:validate
# or check directly:
mysql -u <user> -p <dbname> -e "DESCRIBE sales_order;" | grep split

Verwachte uitvoer: vier kolommen, beginnend met split_ zichtbaar in sales_order .

Stap 2 — Configuratie van Commerce Admin verifiëren

In Commerce Admin:

Stap 3 — verifieer de eindpunten van de REST Toegankelijk zijn

Gebruik curl om te bevestigen dat de eindpunten reageren (ze zullen niet-geautoriseerde aanvragen afwijzen, maar een 401 bevestigt dat ze correct zijn gerouteerd):

# Should return 401 (not 404) — endpoint exists but requires auth
curl -X POST https://your-store.example.com/rest/V1/split-payment/orders/1/cash-received

# Should return 200 or session-based response — anonymous endpoint
curl -X POST https://your-store.example.com/rest/V1/split-payment/set \
  -H "Content-Type: application/json" \
  -d '{"storeCreditAmount": 0, "cashAmount": 0}'

Stap 4 — De gebruikersinterface voor uitchecken testen

bevestiging van de Test:

Stap 5 — Drempelwaarborg voor tests

Stap 6 — Een gesplitste betalingsopdracht voor tests plaatsen

Verifieer na plaatsing van de bestelling in Commerce Admin:

als geen commentaren van App Builder verschijnen: controleer de actielogboeken van App Builder met aio app logs. De gebeurtenis is mogelijk niet geactiveerd of er is een fout opgetreden.

Stap 7 — de Test keurt via het Manuscript van de Simulatie goed

Het simulatiescript is de snelste manier om te testen goedkeurt/verval stroom zonder de volledige exploitant UI.

cd commerce-checkout-starter-kit
cp commerce-backend-ui-1/.env.simulation.example commerce-backend-ui-1/.env.simulation
# Edit .env.simulation with your credentials

# List recent orders (find your test order entity_id)
node commerce-backend-ui-1/scripts/simulate-split-payment.mjs list

# Show split payment fields for a specific order
node commerce-backend-ui-1/scripts/simulate-split-payment.mjs show 42

# Accept the cash payment
node commerce-backend-ui-1/scripts/simulate-split-payment.mjs accept 42

Verifieer na acceptatie in de Commerce Admin-ordeweergave:

Stap 8 — Test Weigeren via Simulatiescript

Plaats een andere testvolgorde (dezelfde instelling als bij Stap 6), dan:

node commerce-backend-ui-1/scripts/simulate-split-payment.mjs decline <orderId>

Controleer na afwijzen in Commerce Admin:

Stap 9 — Test het demo-dashboard

Nadat split-payment-orchestrator is geïmplementeerd, drukt aio app deploy de actie-URL’s af.

Open de URL van demo-dashboard in een browser:

https://[runtime-host]/api/v1/web/split_payment_orchestrator/demo-dashboard

Als DEMO_UI_SECRET is ingesteld:

https://[runtime-host]/api/v1/web/split_payment_orchestrator/demo-dashboard?secret=<your-secret>

Met een lopende bestelling:

Stap 10 — App Builder-actielogboeken testen

# Follow logs in real-time
aio app logs --tail

# Or view last invocations
aio runtime activation list --limit 10
aio runtime activation logs <activation-id>

Voor payment-orchestrator zoekt u naar:

[INFO] Split payment orchestration finished { orderId: '42' }

Voor payment-accept of payment-decline :

[INFO] Cash payment accepted on Commerce via REST { orderId: '42' }

Veelvoorkomende problemen en oplossingen

“De handtekening is ongeldig” in Commerce OAuth

Oorzaak: de schuine streep van het Klokje tussen runtime van App Builder en Commerce, of een OAuth het ondertekenen insect.

Repareren:

Betalingsvelden splitsen die niet worden weergegeven bij de afhandeling

Oorzaak: LayoutProcessorPlugin injectiepaden passen uw controlelay-out niet aan.

Repareren:

Winkelkrediet niet aangevraagd / “Betaling kan niet worden verwerkt” op bestelling

Oorzaak: gewoonlijk één van de steekmodules van het randgeval werkt correct niet.

Controle:

App Builder-actie ontvangt gebeurtenis maar orderId ontbreekt

Oorzaak: de io_events.xml gebiedslijst omvat niet entity_id, of de veranderde vorm van de gebeurtenislading.

Repareren:

Bestellingen worden niet weergegeven in het dashboard voor demo

Oorzaak: Commerce REST orders onderzoekscriteria die geen orden terugkeren, of split_cash_status gebied niet in de REST reactie.

Repareren:

Controleoverzicht

Gerelateerde gesplitste betalingen POC-middelen