Archivo XML PaymentSystemPluginMapping

Utilice el archivo PaymentSystemPluginMapping.xml para correlacionar sistemas de pago con plug-ins de pago.

Este archivo se encuentra en el directorio siguiente:

workspace_dir/WC/xml/config/payments/ppc/plugins
workspace_dir/wc/xml/config/payments/plugins

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<Mapper xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="PaymentSystemPluginMapper.xsd">

  <RetainKeywords>
       <Keyword name="billing_address_id"/>
  </RetainKeywords>     
  <PaymentSystemName 
          name="SimpleOffline" >
          <Mapping paymentConfigurationId="default" PluginName="SimpleOffline" >
              <Keyword name="cc_cvc" mask="-" plain="0" removeAfterApproval="true" neverPersist="true"/>
              <Keyword name="cc_nameoncard" mask="*" plain="0" removeAfterApproval="true" neverPersist="true" />
              <Keyword name="account" mask="*" plain="-5" searchable="true"/>
          </Mapping> 
  </PaymentSystemName>

  <PaymentSystemName 
          name="VisaNet" >
          <Mapping paymentConfigurationId="VisaNet" PluginName="WCPaymentsPlugin" >
              <Property name="ProfileName" value="WCPPlugin_VisaNet"/>
              <Keyword name="cc_cvc" mask="-" plain="0" removeAfterApproval="true" neverPersist="true"/>
              <Keyword name="cc_nameoncard" mask="*" plain="0" removeAfterApproval="true" neverPersist="true"/>
              <Keyword name="account" mask="*" plain="-5" searchable="true"/>
          </Mapping>
  </PaymentSystemName>

  
</Mapper>

Nota: Si elimina los parámetros de los datos ampliados en una instrucción de pago, no puede reutilizar estos parámetros en transacciones posteriores, por ejemplo, en flujo de devolución.

Parámetros

RetainKeywords

Opcional: Especifique las palabras claves que deben mantenerse en la base de datos de HCL Commerce. Este es un valor global que se aplica a todas las instrucciones de pago para todos los plug-ins que están especificados en este archivo. En el ejemplo que se muestra, el ID de dirección de facturación se conserva en la base de datos para todos los plug-ins que se utilizan en este archivo.

Otra forma de especificar el mantenimiento de palabras claves es utilizando los elementos <ProtocolProperties> y <ProtocolProperty> en el descriptor de despliegue de plug-in. Cuando se mantienen palabras clave en el descriptor de despliegue de plug-in, se mantienen únicamente a nivel del plug-in (no es un mantenimiento global de todos los plug-ins).

Este elemento se puede utilizar para determinar qué datos importantes deben conservarse con el fin de mejorar el rendimiento de la aplicación de HCL Commerce en la tienda en línea.

PaymentSystemName

name

Nombre del sistema de fondo de pago.

Un nombre de sistema de pago es una serie independiente del nombre del plug-in. El nombre del sistema de pago se correlaciona con el plug-in de pago que se utiliza para procesar las transacciones. El nombre del sistema de pago debe coincidir con PaymentMethodConfigurations.xml (o RefundMethodConfigurations.xml) y con los archivos PaymentSystemPluginMapping.xml.

En la siguiente tabla se listan los nombres de sistemas de pago que se proporcionan en HCL Commerce para modalidades de pago (y reembolso) soportadas. Las asociaciones que se muestran a continuación son ejemplos; por ejemplo, puede configurar un tipo de tarjeta de crédito para que utilice otro nombre de sistema de pago o plug-in de pago.


Nombre de sistema de pago	Nombre de plug-in	Método
LOCSystem	LOCPlugin	LOC
OfflineACHSystem	SimpleOfflinePlugin	Seleccionar
OfflineCreditCardSystem	SimpleOfflinePlugin	AMEX
OfflineCreditCardSystem	SimpleOfflinePlugin	Master Card
OfflineCreditCardSystem	SimpleOfflinePlugin	VISA
OfflineSystem	SimpleOfflinePlugin	BillMeLater
OfflineSystem	SimpleOfflinePlugin	COD
OfflineSystem	SimpleOfflinePlugin	PayLater

Mapping

paymentConfigurationId

El ID de la configuración de pago de la modalidad de pago. La combinación del nombre de sistema de pago y paymentconfigurationId determinan qué plug-in se utiliza. Para obtener más información, consulte Grupo de configuración de pago.

PluginName

El nombre del plug-in de pago.

Property

Opcional: name El nombre de la propiedad de plug-in que debe utilizarse en transacciones para este método de pago concreto. Un plug-in puede requerir parámetros adicionales o una configuración de pago puede tener necesidades exclusivas.

value El valor de la propiedad de plug-in indicada.

Keyword

Opcional: Todas las palabras claves que están definidas bajo el elemento <Mapping> se guardan en la base de datos de HCL Commerce.

name

El nombre de la palabra clave asociada al protocolo de pago y sus atributos. Los atributos pueden utilizarse para configurar si se pueden utilizar los datos en otra búsqueda, qué parte de los datos son visibles en los resultados de la búsqueda, si se debe enmascarar alguna parte de los datos al mostrar los datos de protocolo en la interfaz de usuario y si los datos deben eliminarse de la base de datos una vez que se haya aprobado el importe total de la instrucción de pago.

mask

La carácter que se utiliza para enmascarar la parte de los datos que no debe ser visible. El carácter pueden ser un signo menos, un asterisco o cualquier otro carácter. Este atributo se utiliza en combinación con "plain" cuando se visualizan datos confidenciales en HCL Commerce Accelerator.

plain

La longitud del texto sin formato (parte visible). Este atributo se utiliza en combinación con "mask" cuando se visualizan datos confidenciales en HCL Commerce Accelerator. El valor para plain es un entero con o sin un signo menos. El signo menos se utiliza para definir la ubicación de la parte del texto normal en la serie relativa al final de la serie. Por ejemplo, Plain="2" se refiere a los dos primeros caracteres de la cadena. Plain="-5" se refiere a los últimos cinco caracteres de la serie (por ejemplo, el número de tarjeta de crédito 4111111111111111, se visualizan como ***********11111). Plain="0" significa que no hay caracteres normales.

Este atributo se aplica a los atributos mask y searchable. Si se omite plain, se trata como plain="0" para el enmascaramiento (sin caracteres enmascarados) y plain="total_text_length" para la búsqueda (todos los caracteres utilizados en la búsqueda). El valor para plain solo se utiliza cuando se especifica mask o cuando se especifica searchable.

Ejemplo: Ejemplo: suponga que una configuración muestra <keyword name="billto_address" searchable="true">. No se especifica ningún valor mask, por lo tanto en la interfaz de usuario se visualiza toda la serie de dirección de facturación. Puesto que searchable="true" se ha establecido sin un valor plain, se utiliza toda la serie de dirección de facturación para búsqueda de pedidos.

NeverPersist

Opcional: Indica si la palabra clave se almacena en la tabla PPCEXTDATA. La tabla PPCEXTDATA almacena datos ampliados para las instrucciones de pago.

true: No persiste la palabra clave.
false: El valor predeterminado. La palabra clave se almacena en la tabla PPCEXTDATA cuando se añade una instrucción de pago.

searchable

Indica si se puede buscar en la palabra clave en HCL Commerce Accelerator en la página Buscar pedidos.

true: Habilita los datos en los que se van a realizar búsquedas.
Nota: La palabra clave se almacena en la columna SEARCHVALUE de la tabla PPCEXTDATA. Aumentando el número de palabras clave de búsqueda aumenta la cantidad de espacio que se utiliza y disminuye la velocidad de proceso.
false: El valor predeterminado. No se pueden realizar búsquedas en los datos.

removeAfterApproval

Indica si la palabra clave se eliminará de los datos ampliados de la instrucción de pago una vez que se haya aprobado el importe total de la instrucción de pago. Algunos protocolos financieros requieren que no se almacenen los datos confidenciales (como el valor de verificación de la tarjeta y el nombre de la tarjeta).

true: Elimina la palabra clave. Los datos confidenciales se eliminan de los datos ampliados una vez que se haya aprobado el importe total del pago.
false: El valor predeterminado. Mantiene la palabra clave.

En la siguiente tabla se muestra un resumen de las distintas combinaciones de las configuraciones de palabras clave (no se muestran todas las combinaciones posibles). Las células en blanco de la tabla indican que el atributo correspondiente no está especificado en el archivo de configuración.


mask	plain	searchable	Descripción de configuración
un carácter (*, - u otros)	Un entero con o sin un signo menos	true/false	El valor de la palabra clave está enmascarado con el carácter de máscara junto con alguna parte normal en la interfaz de usuario. El entero del elemento plain define la longitud de la parte plain. El signo menos define la ubicación de la parte normal desde el final de la serie. Si searchable es true, solo se puede realizar la búsqueda la parte normal. Si searchable es false, no se da soporte a la búsqueda en esta palabra clave. Aquí, la parte normal es la misma que la parte searchable. Si la longitud de la parte normales 0, searchable="true" es igual a searchable="false".
	Un entero con o sin un signo menos	true/false	El valor de la palabra clave no está enmascarado en la interfaz de usuario. Se muestra claramente toda la serie del valor. Si searchable es true, la parte en la que se puede realizar la búsqueda la define plain. El entero define la longitud de la parte en la que se puede realizar la búsqueda y el signo menos define la ubicación de la parte en la que se puede realizar la búsqueda. Si searchable es false, no se da soporte a la búsqueda en esta palabra clave.
un carácter (*, - u otros)	Un entero con o sin un signo menos		El valor de esta palabra clave está enmascarado con el carácter de máscara junto con alguna parte normal en la interfaz de usuario. El entero del elemento plain define la longitud de la parte plain y el carácter menos define la ubicación de la parte normal de toda la serie. Cuando no se especifica searchable, no se puede realizar la búsqueda en la palabra clave.
		true	El valor de la palabra clave no está enmascarado en la interfaz de usuario. Se muestra claramente toda la serie. Dado que searchable es true sin que se especifique plain, puede realizarse la búsqueda en el valor de toda la serie.
		false	El valor de la palabra clave no está enmascarado en la interfaz de usuario. Se muestra claramente toda la serie. Dado que searchable es false, no puede realizarse la búsqueda en el valor.
un carácter (*, - u otros)		true/false	El valor de la palabra clave está enmascarado con el carácter de máscara sin ninguna parte normal visible en la interfaz de usuario. Si searchable es true, se puede realizar la búsqueda en toda la serie. Si searchable es false, no se da soporte a la búsqueda en esta palabra clave. Aquí, la parte normal no es la misma que la parte searchable.
un carácter (*, - u otros)			El valor de la palabra clave está enmascarado con el carácter de máscara sin que aparezca ninguna parte normal en la interfaz de usuario. Dado que searchable no se especifica, no se puede realizar la búsqueda en la palabra clave.
			No se especifica nada para mask, plain o searchable. El valor de la palabra clave no está enmascarado en la interfaz de usuario. Se muestra claramente toda la serie. Dado que searchable no se especifica, no puede realizarse la búsqueda en el valor.

Explicación del ejemplo

En el ejemplo anterior, se utilizan dos plug-ins, SimpleOffline y WCPayments:

El plug-in SimpleOffline procesa transacciones para el sistema de pago denominado SimpleOffline. El sistema de pago SimpleOffline es un enfoque de pago fuera de línea que no incluye la comunicación directa con un sistema de fondo de pago.
El plug-in WCPayments procesa transacciones con otro sistema de pago denominado VisaNet. El plug-in utiliza un casete que se denomina VisaNet para procesar transacciones para el sistema de pago VisaNet.

En el sistema de pago SimpleOffline, las configuraciones que determinan en qué datos de protocolo se pueden realizar búsquedas en HCL Commerce Accelerator cuando se realiza una búsqueda de pedidos. Si un fragmento específico de datos de protocolo debe estar localizable en la página Buscar pedidos en HCL Commerce Accelerator, la palabra clave de dichos datos debe indicarse con los atributos de búsqueda necesarios.
La "cuenta" de pago son los únicos datos de protocolo de pago que pueden utilizarse en la búsqueda de pedidos. En la página Buscar pedidos en HCL Commerce Accelerator, existirá un campo para que el usuario especifique los cinco últimos dígitos del número de cuenta de pago (por ejemplo, el número de tarjeta de crédito para una tarjeta de crédito). La interfaz de usuario no mostrará campos para el código de verificación de la tarjeta (CVC) o el nombre del titular de la tarjeta.
La interfaz de usuario se puede cambiar de modo que utilice otros datos de protocolo de pago para la búsqueda de pedidos. Para la búsqueda de pedidos al principio solo está disponible el campo "cuenta". Todos los datos de protocolo de datos pueden estar disponibles para la búsqueda. Si desea realizar una búsqueda utilizando algo distinto a los últimos cinco dígitos del número de cuenta de pago, puede personalizar la página de búsqueda de pedidos. Por ejemplo, para realizar una búsqueda por 'bankname' en lugar de 'account', modifique la búsqueda de pedidos o la página JSP de lista de pedidos para cambiar el nombre de datos de protocolo por 'bankname'.

Para utilizar dos tipos de datos de protocolo para buscar un pedido, como cc_brand y account (por ejemplo, cc_brand="CardBrandX" y account = "12345"), modifique los archivos JSP de modo que recopilen los dos valores. Para obtener más información, consulte Utilización de otros datos de protocolo de pago para buscar pedidos.
Los dígitos que preceden a los últimos cinco dígitos del número de cuenta se enmascaran en los resultados de la búsqueda con asteriscos (*). Por ejemplo, si el número de cuenta es 123456789012345, se visualiza como **********12345 en HCL Commerce Accelerator y solo se guarda internamente 12345 para la búsqueda de pedidos.
La palabra clave cc_cvc se enmascara con guiones en la interfaz de usuario sin que aparezca claramente ningún dígito.
Los valores para cc_cvc y cc_name de la tarjeta se eliminan una vez que se haya aprobado el importe total de la instrucción de pago. El número de cuenta no se elimina (la ausencia del atributo significa removeAfterApproval="false").
Los valores de cc_cvc y cc_nameoncard no permanecen en la tabla PPCEXTDATA. Para utilizar datos de protocolo en la autorización del pago, transfiera el valor de cc_cvc y cc_nameoncard al mandato OrderProcess.