Payment Processing Overview

Lists are used to configure merchant accounts in BillMax, specifically credit card processing and echeck processing. There are a number of settings for credit card and echeck processing with most of the items having preset values. A specific setup for each Virtual Company can be created. Some settings are critical and must be set. Here is the list of critical values:

Table 1. Payment Processing Settings
Item	Value	Description
Virtual Company	All	All will allow the list to be used for All Virtual Companies. Otherwise, specify the number of the Virtual Company the list applies to.
Test	0	0 indicates the list is active for production. 1 is the test mode where transactions are fake.
ResultEmail	admin@example.com	The address where the batch processing log will be emailed.
State	Active	Active indicates this list is in use for the specified Virtual Company and PayType. Not Active means the list is not in use.
PayType	Credit	This value must be set to either "Credit" or "Echeck".
UserName	ZX1GHTYU1234	The TID or Terminal ID provided by the merchant service provider is entered as the UserName.
Tokenization	1	0 means that `tokenization` will not be used. Otherwise, 1 specifies that tokens will be generated as needed and used.
Module	ippay	This entry indicates the BillMax module to use.

Out of the box, BillMax provides two lists for each processor it supports: one for credit cards and one for e-checks (bank debit). To use a simple setup where only one merchant account is used for all virtual companies, locate the appropriate lists and configure the settings mentioned above. To use multiple merchant accounts, create two new lists for each Virtual Company if credit cards and e-checks are accepted. As each list contains a couple dozen settings, use the copylist.pl script from the command line as follows:

/usr/local/billmax/bin/copylist.pl <from list name> <new list name>

Edit the new list to be used for the new Virtual Company. Terminal IDs can be used for more than one list.

Note: If the copied list is Active, there is a brief period where the two lists refer to the same Virtual Company. Subsequent charge/refund attempts will fail. Copy the lists at a time where it will not be used.

Note: If the "from" list name is the same as the module name, the copylist.pl script will rename the module.

To check the overall configuration, view System Administration > System Status. It is also a good idea to test a single transaction for a customer in the appropriate Virtual Company before the nightly batch runs.

Lastly, BillMax payment processing can be configured to run for only certain Virtual Companies. See Configure Payment Processing by Virtual Company.