Delad betalnings-POC: testnings- och verifieringshandbok

Den här guiden hjälper dig att verifiera att alla komponenter fungerar som de ska, i den ordning de ska testas. Börja längst ned (Commerce-modulen) och arbeta upp (App Builder).

Steg 1 - Verifiera installation av Commerce-modul

Efter att bin/magento setup:upgrade och bin/magento setup:di:compile har körts:

# 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

Förväntade utdata: fyra kolumner som börjar med split_ synliga i sales_order.

Steg 2 - Verifiera konfigurationen för Commerce Admin

I Commerce Admin:

Steg 3 - Verifiera att REST-slutpunkter är tillgängliga

Använd krullning för att bekräfta att slutpunkterna svarar (de avvisar obehöriga begäranden, men en 401-bekräftelse bekräftar att de dirigeras korrekt):

# 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}'

Steg 4 - Testa gränssnittet för utcheckning

Testvalidering:

Steg 5 - Test Threshold Guard

Steg 6 - Testa delad betalningsorder

Efter beställningens placering kan du verifiera detta i Commerce Admin:

Om inga App Builder-kommentarer visas: Kontrollera App Builder åtgärdsloggar med aio app logs. Händelsen kanske inte har utlösts eller så kan åtgärden ha ett fel.

Steg 7 - Testa acceptera via simuleringsskript

Simuleringsskriptet är det snabbaste sättet att testa flödet för acceptera/avvisa utan användargränssnittet för den fullständiga operatorn.

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

När du har godkänt, verifiera i ordervyn i Commerce Admin:

Steg 8 - Testa avböjning via simuleringsskript

Placera ytterligare en testorder (samma inställning som steg 6) och sedan:

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

Bekräfta i Commerce Admin när du avböjt:

Steg 9 - Testa demokontrollpanelen

Efter distributionen av split-payment-orchestrator skriver aio app deploy ut URL:er för åtgärden.

Öppna URL:en demo-dashboard i en webbläsare:

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

Om DEMO_UI_SECRET har angetts:

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

Med väntande order:

Steg 10 - Testa App Builder åtgärdsloggar

# 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>

För payment-orchestrator söker du efter:

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

För payment-accept eller payment-decline:

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

Vanliga problem och korrigeringar

“Signaturen är ogiltig” från Commerce OAuth

Orsak: Skeva klockan mellan App Builder-miljön och Commerce, eller ett OAuth-signeringsfel.

Korrigera:

Delade betalningsfält visas inte i utcheckning

Orsak: Injektionssökvägarna för LayoutProcessorPlugin matchar inte din utcheckningslayout.

Korrigera:

Butikskrediten har inte tillämpats / “Betalningen kunde inte behandlas” på plats

Orsak: En av plugin-programmen för versaler fungerar vanligtvis inte korrekt.

Kontrollera:

App Builder-åtgärden tar emot händelse men orderId saknas

Orsak: Fältlistan io_events.xml innehåller inte entity_id eller så har händelsens nyttolastform ändrats.

Korrigera:

Beställningar visas inte på demokontrollpanelen

Orsak: Commerce REST orders sökvillkor returnerar inte order, eller split_cash_status fält finns inte i REST-svaret.

Korrigera:

Checklista för verifiering

Relaterade POC-resurser för delad betalning