POC de pago fraccionado: guía de prueba y verificación

Esta guía le explica cómo verificar que cada componente funciona correctamente, en el orden en que se deben probar. Comience desde abajo (módulo Commerce) y trabaje hacia arriba (App Builder).

Paso 1: Verificación de la instalación del módulo Commerce

Después de ejecutar bin/magento setup:upgrade y 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

Resultado esperado: cuatro columnas que comienzan con split_ visibles en sales_order.

Paso 2: Verificación de la configuración del administrador de Commerce

En Commerce Admin:

Paso 3: Verificar que los puntos finales de REST sean accesibles

Utilice curl para confirmar que los puntos de conexión responden (rechazarán solicitudes no autorizadas, pero un error 401 confirma que se han enrutado correctamente):

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

Paso 4: Prueba de la IU de cierre de compra

Validación de prueba:

Paso 5: Probar la protección del umbral

Paso 6: Realizar una orden de pago dividida de prueba

Después de realizar el pedido, compruebe en el Administrador de Commerce:

Si no aparecen comentarios de App Builder: Compruebe los registros de acciones de App Builder con aio app logs. Es posible que el evento no se haya activado o que la acción tenga un error.

Paso 7: Prueba de aceptación mediante script de simulación

El script de simulación es la forma más rápida de probar el flujo de aceptación/rechazo sin la interfaz de usuario del operador completa.

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

Después de aceptar, verifique en la vista de orden de administración de Commerce:

Paso 8: Rechazo de prueba mediante script de simulación

Realice otro pedido de prueba (la misma configuración que en el paso 6) y, a continuación:

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

Después del rechazo, compruebe en Administración de Commerce:

Paso 9: Prueba del tablero de demostración

Después de implementar split-payment-orchestrator, aio app deploy imprime las direcciones URL de acción.

Abra la URL demo-dashboard en un explorador:

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

Si DEMO_UI_SECRET está establecido:

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

Con un pedido pendiente:

Paso 10: Prueba de registros de acciones de App Builder

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

Para payment-orchestrator, busque:

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

Para payment-accept o payment-decline:

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

Problemas y correcciones comunes

“La firma no es válida” desde Commerce OAuth

Causa: Diferencia de reloj entre el tiempo de ejecución de App Builder y Commerce o un error de firma de OAuth.

Corrección:

Los campos de pago divididos no aparecen en el cierre de compra

Causa: las rutas de inyección de LayoutProcessorPlugin no coinciden con el diseño de cierre de compra.

Corrección:

Crédito de tienda no aplicable / “No se pudo procesar el pago” en el pedido del lugar

Causa: Normalmente, uno de los complementos de casos extremos no funciona correctamente.

Comprobación:

La acción de App Builder recibe el evento pero falta orderId

Causa: La lista de campos de io_events.xml no incluye entity_id o la forma de carga útil de evento cambió.

Fix:

Orders don’t show in demo dashboard

Cause: Commerce REST orders search criteria not returning orders, or split_cash_status field not in the REST response.

Fix:

Verification Checklist

Recursos de POC de pagos fraccionados relacionados