WebSphere Commerce – Payment System Overview

El objetivo de la siguiente discusión es dar al lector una comprensión de alto nivel de cómo funciona el sistema de pago y cómo puede ser configurado.

Visión general del sistema de pagos

El procesamiento de pagos en WebSphere Commerce tiene tres eventos distintos que corresponden a las etapas del ciclo de vida del pedido. Cuando un pedido alcanza una determinada etapa, el evento relacionado desencadenará un proceso de pago específico. Este proceso es altamente personalizable y puede adaptarse a las necesidades específicas de la empresa. Véase la figura 1 para una visión general de alto nivel del flujo. Hay tres componentes principales del subsistema de pago en WCS:

Figura 1: Visión general de los componentes del sistema de pagos.

Motor de reglas de pago: Determina qué acciones de pago se deben tomar y plantea un evento para ellas. Utiliza un conjunto de archivos de configuración XML para crear el evento con las acciones apropiadas
Controlador de los complementos de pago:
Crea una transacción financiera que se utiliza para seguir el progreso del proceso de pago. Los datos de la transacción se almacenan en la tabla de la base de datos PPCPAYTRAN
Determinar qué enchufe usar. Utiliza un conjunto de archivos de configuración XML para hacerlo
Envía la transacción financiera al Payment Plug-in para procesar
Persiste la información en la base de datos

Plug-in de pago: Un componente de software autónomo que sirve como un proxy para un sistema de pago de fondo. Es un frijol de sesión sin estado que necesita implementar métodos que correspondan a las Acciones de Pago que el plug-in debe manejar. Exactamente qué acciones debe manejar el plug-in depende de los métodos de pago que utiliza el plug-in, junto con las necesidades de la empresa. Un plug-in es responsable de lo siguiente:
Recibir datos sobre una transacción financiera y enviar una solicitud al proveedor de servicios de pago para procesar
Recibir una respuesta del Proveedor de Servicios de Pago y decidir qué datos deben almacenarse
Llene la transacción financiera con los datos de respuesta y devuélvala al controlador de complementos de pago

Una descripción simplificada del flujo entre los componentes del Sistema de Pago puede describirse como sigue:

Lanzamiento del procesamiento de pedidos (fx. el cliente selecciona un método de pago y hace un pedido que activará el evento de pago principal del pedido)
El Motor de Reglas de Pago plantea un evento (fx. para hacer una acción de Aprobación)
El evento se envía al Controlador de Complementos de Pago (ejecución de un método apropiado en el controlador, fx. Approve()).
El controlador de complementos de pago procesa el evento y crea una transacción financiera que lo describe. También determina qué Plug-in de pago se debe utilizar
La transacción financiera se envía al plug-in de pago (ejecución de un método apropiado en el plug-in, fx. Approve())
El complemento de pago interactúa con el proveedor de servicios de pago para realizar el pago
Conceptos

Una descripción de los conceptos y términos que usamos en este post:

Sistema de pago: Todo lo que en WCS se relaciona con el procesamiento del pago de un pedido
Evento de pago: Hay tres eventos de pago distintos que corresponden a etapas del ciclo de vida de la orden
Método de pago (y método de devolución): Es el medio por el cual se hace un pago (o devolución) (fx. tarjeta de crédito, PayPal, certificados de regalo, etc.). Se gestionan en la tabla de la base de datos POLICY
Instrucción de pago: Es una instancia de un método de pago con los detalles necesarios para realizar el pago (fx. número de tarjeta de crédito)
Transacción financiera: Es un objeto que corresponde a una Acción de Pago. El complemento de pago utiliza este objeto para procesar el Evento de pago
Acción de pago: Es una de las acciones predefinidas que se pueden realizar durante el procesamiento de un pago (fx. aprobar)
El Proveedor de Servicios de Pago es el sistema de fondo (de terceros) que se encargará de la tramitación del pago propiamente dicho
Eventos y acciones

Cuando un cliente completa un pedido, debe elegir un método de pago. Los métodos de pago disponibles se gestionan en la tabla de la base de datos POLICY. La información de esta tabla ayudará al Motor de Reglas de Pago a determinar qué archivos de configuración se deben utilizar al procesar un pago con el Método de Pago seleccionado. Estas configuraciones dependerán del tipo de pago que se esté procesando y de las necesidades de la empresa. Describiremos los archivos en detalle más adelante.

Hay un conjunto de Acciones de Pago predefinidas que se pueden tomar durante el procesamiento de un pago. La(s) acción(es) que se llevará(n) a cabo durante cada evento de pago está(n) determinada(s) por el Motor de Reglas de Pago a partir del conjunto de archivos de configuración XML relacionados con el método de pago. Se pueden ejecutar varias acciones durante un solo evento. El funcionamiento preciso de una acción se implementa en el plug-in de pago asociado al método de pago. El Controlador del Plug-in de Pago se encarga de ejecutar y recibir la respuesta del Plug-in de Pago. En la tabla 1 se enumeran los tres eventos de pago distintos y cómo se relacionan con el ciclo de vida de la orden y en la tabla 2 se enumeran las acciones de pago que pueden ejecutarse.

Tabla 1: Las diferentes etapas de un pedido y cómo se relacionan con la tramitación del pago. La columna Comando de tarea especifica el comando que se ejecuta durante el Evento de pago especificado.
Fase del ciclo de vida de la orden Comando de tarea del evento de pago
Orden de captura de la prima de pago PrimePaymentCmd
Release to Fulfillment Reserve Payment ReservePaymentCmd
Confirmación de envío Finalizar pago FinalizarPagoCmd
Cuadro 2: Las distintas medidas que pueden adoptarse durante la tramitación del pago y una descripción de la finalidad de cada una de ellas
Descripción de la acción de pago
Aprobar Verificar que el cliente está autorizado a hacer la compra
Depósito Capturar el pago de una orden
Aprobar y depositar Verificar que el cliente pueda hacer la compra y luego capturar un pago por el pedido
La aprobación inversa anula una aprobación
El crédito emite un reembolso para devolver el dinero al cliente
Error Generar un mensaje de error para indicar que se ha producido una excepción
ConsumeAmount Actualizar la información relacionada con el pago (sin causar ninguna acción de pago directo con un sistema back-end)
Configuraciones

Los archivos de configuración del sistema de pago se dividen en dos subcarpetas que se encuentran en workspace_dir/WC/xml/config/payments/

Configuraciones de Edp

Archivos de configuración utilizados para determinar qué acciones tomar y cómo procesar el pago. Estos archivos de configuración pueden dividirse en diferentes grupos (carpetas). Fuera de la caja, sólo tenemos un grupo, el predeterminado. Cada grupo contiene los siguientes archivos de configuración:

PaymentMappings.xml: Define el método de pago (a partir del nombre de la póliza en la base de datos) y las reglas de pago y configuraciones a utilizar.
PaymentMethodConfigurations.xml: Define varias configuraciones que pueden utilizarse con un método de pago
PaymentRules.xml: Define las reglas que determinan lo que sucede durante cada evento de pago
RefundMappings.xml: Define qué configuración usar para el reembolso
RefundMethodConfigurations.xml: Define varias configuraciones que pueden utilizarse con un método de reembolso

Además, para cada configuración de pago que se define en PaymentMethodConfigurations.xml, tenemos una carpeta con el mismo nombre. Esta carpeta contiene un conjunto de archivos de configuración que definirán las acciones a realizar en función del estado del pago y de la regla de pago que se esté utilizando.

Configuraciones de Ppc

Archivos de configuración utilizados por el Controlador del Plug-in de Pago para determinar el Plug-in de Pago apropiado. Contiene los siguientes archivos de configuración:

PaymentSystemPluginMapping.xml: Define los sistemas de pago que realizan un seguimiento de qué plug-in de pago se debe utilizar y define ciertas configuraciones a utilizar

Además, para cada plug-in que se define en PaymentSystemPluginMapping.xml, tenemos una carpeta con el mismo nombre que contiene hasta dos archivos XML. Contendrá un archivo llamado PluginDeployment.xml que, como su nombre indica, contendrá información sobre cómo desplegar el plug-in en cuestión. El otro archivo, opcional, que contiene información sobre los parámetros adicionales que se pasan al plug-in, según el método de pago que lo utilice.

 

Figura 2: Visión general de los diferentes archivos de configuración relacionados con el Sistema de Pago y cómo se interconectan

Conclusión

Hemos discutido el Sistema de Pago de Comercio de WebSphere y hemos dado una visión general de cómo funciona y cómo los diferentes componentes están conectados entre sí. En particular, hemos discutido los diferentes archivos de configuración relacionados con el Sistema de Pago. Se pueden encontrar más detalles sobre cualquiera de los conceptos discutidos, junto con tutoriales, en el Centro de Conocimiento de IBM.