POC de pagos divididos: requisitos previos y configuración del entorno

Complete todos los pasos de este tutorial antes de ejecutar cualquiera de las indicaciones de generación. La falta de un solo paso es la razón más común por la que el flujo se interrumpe a mitad del tutorial.

​1. Requisitos de Adobe Commerce

Solo Commerce Cloud: habilitar eventos de E/S

Agregue lo siguiente a .magento.env.yaml e implemente antes de agregar el módulo:

stage:
  global:
    ENABLE_EVENTING: true

Advertencia: Esta implementación debe finalizar correctamente para que se pueda resolver la dependencia del módulo de eventos de E/S.

​2. Configuración de administración de Commerce

Haz estos pasos antes que nada. El JavaScript de cierre de compra depende de coincidencias de cadena exactas.

2 bis. Habilitar Pago contra reembolso con el título exacto

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

Nota: Si tu tienda usa una implementación o un título de Pago contra reembolso (COD) diferente, ajusta payment-method-helper.js en el módulo de Commerce.

2 ter. Habilitar crédito de tienda

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

2 quater. Añadir crédito de la tienda al cliente de prueba

Customers > All Customers > [su cliente de prueba] > Store Credit > Update Balance

Agregar al menos $50 en el crédito de la tienda. Realizará pruebas con un pedido total inferior a 100 $.

2d. Creación de la integración de Commerce

System > Integrations > Add New Integration

Seleccione Save, luego Activate.

Copie los cuatro valores; solo se muestran una vez:

Guarde estos valores de forma segura. Los necesita en cada archivo de App Builder .env.

​3. ADOBE DEVELOPER CONSOLE y APP BUILDER

El código de evento utilizado en la prueba de concepto es: com.adobe.commerce.observer.sales_order_place_before

Si no ha conectado Commerce como proveedor de eventos, consulte Configuración de Commerce para que emita eventos a Adobe I/O en la guía de extensibilidad de Commerce.

​4. Entorno de desarrollo local

# 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. Dos directorios de proyecto para conocer

Este tutorial utiliza dos raíces de directorio independientes. Manténgalos separados.

raíz de proyecto de Commerce (su repositorio de Git de Magento):

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

Raíz de proyecto de App Builder (la carpeta split-payment-orchestrator del paquete de origen o un nuevo proyecto que cree):

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

​6. entity_id comparado con increment_id

Use siempre entity_id (el identificador numérico de base de datos), no increment_id (por ejemplo 000000042), en las llamadas REST.

Buscar entity_id de la dirección URL del pedido Commerce Admin:

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

O desde el script de simulación:

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

​7. El umbral de 100 dólares

La interfaz de usuario de pago dividido y el objetivo de protección de umbral solicitan $100.00 o menos. El flujo se comporta de la siguiente manera:

Para probar, genere un carro de compras cuyo subtotal, gastos de envío e impuestos sean menores o iguales a $100 (por ejemplo, un producto menor de $90 por lo que los gastos de envío e impuestos aún caben debajo del límite).

El umbral se almacena en:

​8. Rápidamente (solo Commerce Cloud)

Las acciones de App Builder llaman a Commerce sobre REST (/rest/V1/split-payment/orders/...). Si el proyecto de Commerce Cloud utiliza Fastly con inclusión en la lista de permitidos IP, las direcciones IP de salida de tiempo de ejecución de App Builder deben estar incluidas en la lista de permitidos.

Comprobación: Ejecute primero el script de simulación (curl directo con firma OAuth). Si esto funciona pero la acción App Builder devuelve 403, es probable que Fastly esté bloqueando la solicitud.

Utilice la documentación actual de Adobe para los intervalos de IP de salida de App Builder y añádalos a la configuración de Fastly según sea necesario.

Lista de comprobación de verificación

Antes de iniciar las peticiones de datos de la versión, confirme lo siguiente:

Recursos de POC de pagos fraccionados relacionados