POC de pagamento dividido: guia de teste e verificação

Este guia orienta você na verificação de que cada componente funciona corretamente, na ordem em que devem ser testados. Comece de baixo (módulo Commerce) e trabalhe acima (App Builder).

Etapa 1 — Verificar a instalação do módulo Commerce

Após executar bin/magento setup:upgrade e 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

Saída esperada: quatro colunas começando com split_ visíveis em sales_order.

Etapa 2 — Verificar a configuração de administração do Commerce

No Commerce Admin:

Etapa 3 — Verificar se os pontos de extremidade REST estão acessíveis

Use curl para confirmar a resposta dos endpoints (eles rejeitarão solicitações não autorizadas, mas um 401 confirma que foram roteados corretamente):

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

Etapa 4 — testar a interface do usuário de check-out

Validação de teste:

Etapa 5 — Testar proteção de limiar

Etapa 6 — Colocar uma Ordem de Pagamento de Divisão de Teste

Após o envio do pedido, verifique no Commerce Admin:

Se nenhum comentário do App Builder for exibido: Verifique os logs de ação do App Builder com aio app logs. The event may not have fired or the action may have an error.

Step 7 — Test Accept via Simulation Script

The simulation script is the fastest way to test the accept/decline flow without the full operator 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

After accept, verify in Commerce Admin order view:

Step 8 — Test Decline via Simulation Script

Place another test order (same setup as Step 6), then:

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

After decline, verify in Commerce Admin:

Step 9 — Test the Demo Dashboard

After deploying the split-payment-orchestrator, aio app deploy prints the action URLs.

Open the demo-dashboard URL in a browser:

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

If DEMO_UI_SECRET is set:

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

With a pending order:

Step 10 — Test App Builder Action Logs

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

For the payment-orchestrator, look for:

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

Para payment-accept ou payment-decline:

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

Problemas comuns e correções

“A assinatura é inválida” do Commerce OAuth

Causa: Desvio de relógio entre o tempo de execução do App Builder e o Commerce ou um erro de assinatura OAuth.

Correção:

Campos de pagamento dividido não aparecem no check-out

Causa: os caminhos de injeção de LayoutProcessorPlugin não correspondem ao layout de check-out.

Correção:

O crédito da loja não está sendo aplicado / “O pagamento não pôde ser processado” na ordem de colocação

Causa: Geralmente, um dos plug-ins de caso de borda não está funcionando corretamente.

Verificar:

A ação do App Builder recebe o evento, mas orderId está ausente

Causa: a lista de campos io_events.xml não inclui entity_id ou a forma de carga do evento foi alterada.

Correção:

Os pedidos não são exibidos no painel de demonstração

Causa: os critérios de pesquisa REST do Commerce orders não retornam pedidos ou o campo split_cash_status não está na resposta REST.

Correção:

Lista de verificação de verificação

Related split payment POC resources