How To Enable real-time credit-card processing via Verisign's® PayFlow Pro ^SM Program

Purpose:

This document describes the steps needed to enable real-time credit-card processing via Verisign's ® PayFlow Pro program. Only those steps requiring modification to the software residing on a NetMAX system are discussed in any detail within this document.

Assumptions:

The reader has completed those portions of E-Commerce implementation that do not require configuration of the NetMAX system or the Interchange package. Assisting the reader to get to this point falls into the category of consultation, and is not documented here.

The reader is attempting this procedure on a supportable software platform as defined at http://www.netmax.com/support/contact_support/policy_sup_interchange.html.

Procedure:

1. Sign up for Verisign's Payflow Pro service to enable online authorization. You will receive a payment ID, payment Secret (password), and a payment vendor.

2. Access the Verisign ® Manager in your web browser and supply the proper credentials to log in.

3. Click the “Downloads” link at the top of the page.

4. In the section labelled “Payflow Pro Software Development Kit (SDK)” click the link labelled
   “Linux - libc6 / glibc2 / ELF kernels 2.0.36 and above” to start downloading the payflow link software.

5. Copy the file you downloaded in the previous steps (usually called pfpro_linux.tar.gz) to the /var/tmp directory on the NetMAX system running the Interchange package.

6. Log into the NetMAX system at the console with credentials for the “root” user.

7. Enter the following commands:
   cd ~
   mkdir tmp
   cd tmp
   tar zxfv /var/tmp/<downloaded_file>.gz
   cd verisign/payflowpro/linux
   cp bin/pfpro /usr/bin/
   cp lib/libpfpro.so /usr/lib
   ldconfig
   mkdir /var/conf/payflow
   cp -a certs /var/conf/payflow

8. Add the following line to /etc/interchange.cfg:
   Require module Vend::Payment::Signio

9. Add the following lines to /var/lib/interchange/foundation/catalog.cfg:
   Variable MV_PAYMENT_MODE signio
   Variable MV_PAYMENT_ID <yourpaymentid>
   Variable MV_PAYMENT_SECRET <yourpaymentsecret>
   Variable MV_PAYMENT_PARTNER <yourpaymentpartner>
   Variable MV_PAYMENT_CERT_PATH /var/conf/payflow/certs
   Variable MV_PAYMENT_SERVER <yourpaymentserver>

10. Restart interchange.
    service interchange restart

FIREWALLS

You may have to add rules to your firewall to allow the web server to communicate with Verisign's® servers.
If this is the case, you will need 2 firewall rules formatted as follows:

1. Rule 1:
   Type: “Forward” if firewall is not same as web server, “Input” if firewall is on same machine as web server.
   Action: “Accept”
   Protocol: “tcp”
   Source Address->IP Address/Network: the hostname of the payment server (e.g. test-payflow.verisign.com)
   Source Port: “80”
   Destination->IP Address/Network: “hostname.domain” where hostname.domain is the IP address or hostname of the NetMAX running Interchange.
   Destination Port: 1024-65535,80,443

2. Rule 2:
   Type: “Forward” if firewall is not same as web server, “Input” if firewall is on same machine as web server.
   Action: “Accept”
   Protocol: “tcp”
   Source Address->IP Address/Network: “hostname.domain” where hostname.domain is the IP address or hostname of the NetMAX running Interchange.
   Source Port: 1024-65535,80,443
   Destination Address->IP Address/Network: the hostname of the payment server (e.g. test-payflow.verisign.com)
   Destination Port: “80”

You should now be able to process credit-cards online!