Deprecated feature

Configuring WebSphere Commerce to connect to the Payment Manager

You can manually configure your WebSphere Commerce instance to connect to your Payment Manager server using the compatible payment model.

About this task

This task details a configuration which is an option to using the WCPayments Plug-in to connect to the Payment Manager.

Procedure

  1. Configure the commerce server.
    Open the WebSphere Commerce configuration file, and find the "PaymentManager" element. Set the properties to the correct values.
    <PaymentManager 
       DTDPath="config/payment/dtd/IBMPaymentServer.dtd" 
       Hostname="vim.cn.ibm.com" 
       PMAdminId="wcsadmin" 
       ProfilePath="config/payment" 
       UseExternalPM="false" 
       UseNonSSLPMClient="0"
       UsePayment="true"
       UseRemote="false"
       UseSocksServer="false" 
       WebPath="/webapp/PaymentManager" 
       WebServerPort="5433" 
       name="Payments"/>
    Set the correct values for the following parameters.
    Hostname
    The fully qualified host name or IP address for the WebSphere Commerce Payments Web server.
    PMAdminId
    The registered administrator user for the WebSphere Commerce Server.
    UseExternalPM
    Set this to true.
    UseNonSSLPMClient
    This parameter indicates whether SSL is used for the Payment Manager Web server. Refer to the value of the UseSSL attribute of the PMWebServer element in the WebSphere Commerce Payments configuration file for the payment instance. If the UseSSL attribute value is "true", set this value to 0, else set the value as 1.
    The WebSphere Commerce Payments Configuration file can be found at the following location:
    • SolarisLinuxAIXWC_installdir/instances/instance_name/xml/instance_name.xml
    • WindowsWC_installdir\instances\instance_name\xml\instance_name.xml
    • For IBM i OS operating systemWC_userdir/instances/instance_name/xml/instance_name.xml
    UsePayment
    Set this value to "true".
    UseSocksServer
    This parameter indicates if a socks server is used. If your instance uses a socks server, set it to "true", otherwise, set it to "false".
    SocksHostname
    The host name of the socks server. This is required when UseSocksServer is set to "true".
    SocksPort
    The port name of the socks server. This is required when UseSocksServer is set to "true".
    WebServerPort
    The Web server port for of the payment manager. Refer to the "PMWebServer" element in the WebSphere Commerce Payments configuration file for payment instance. If "UseNonSSLPMClient" is 0(UseSSL="true"), the value should be the same as the "SSLPort" in "PMWebServer". If "UseNonSSLPMClient" is 1(UseSSL="false"), the value should be the same as "ServerPort" in "PMWebServer". The default values Out of box, the "SSLPort" is 5433, and the "ServerPort" is 5432.
    <PMWebServer RemoteWS="false"
    .
    .
    .
       ServerPort="5432"
       UseSSL="true"
       SSLPort="5433"
    .
    .
    .
    />  
    PaymentsEnabled
    This parameter indicates if payment manager is used for payment process. A value of "true" indicates that payment manager is used, while "false" indicates that payment manager is not used. If not specified, the default value is "true". Ensure that it is not set to "false", or else you cannot connect to the payment manager.
  2. Configure the WCSRealm of the payment instance.
    1. Open the Configuration Manager.
    2. Select the payment instance.
    3. Navigate to the WCSRealm panel.
    4. Set the WC Hostname as the host name of the WebSphere Commerce instance.
      For the "Use Non-SSL WC Client" check box and the Web server port, refer to the following snippet in the Web server configuration file of the commerce instance. Open the Web server configuration file of the commerce instance in the following location:
      • SolarisLinuxAIXWC_installdir/instances/instance_name/httpconf/httpd.conf
      • WindowsWC_installdir\instances\instance_name\httpconf\httpd.conf
      • For IBM i OS operating systemWC_userdir/instances/instance_name/httpconf/httpd.conf
      If SSL is used, find the "VirtualHost" element which specifies "SSLEngine On" in the Web server configuration file. You can find the port for SSL in this virtual host configuration. In this case, the "Use Non-SSL WC Client" check box in the WCSRealm panel should not be selected. If SSL is not used, the "Use Non-SSL WC Client" check box should be selected. Here is a snippet from the IBM i httpd.conf file:
      <VirtualHost host_name:80>
      ServerName host_name
      Alias /wcsstore  
       "/QIBM/UserData/WebSphere/AppServer/V6/Base/profiles/profile_name/installedApps/cell_name/WC_instance_name.ear/Stores.war"     
      Alias /wcs       
       "/QIBM/UserData/WebSphere/AppServer/V6/Base/profiles/profile_name/installedApps/cell_name/WC_instance_name.ear/CommerceAccelerator.war" 
      </VirtualHost>
      
      <VirtualHost host_name:443>    
         SSLEngine On
         SSLClientAuth 0
         ServerName host_name    
         Alias /wcsstore  
        "/QIBM/UserData/WebSphere/AppServer/V6/Base/profiles/profile_name/installedApps/cell_name/WC_instance_name.ear/Stores.war"    
         Alias /wcs       
        "/QIBM/UserData/WebSphere/AppServer/V6/Base/profiles/profile_name/installedApps/cell_name/WC_instance_name.ear/CommerceAccelerator.war" 
      </VirtualHost>
  3. Configure the Policy for cassettes.
    Refer to Creating a payment policy to create a policy for compatible payment.