Skip to content

Payware Connect integration setup

Configuring Payware Connect (IPCharge)

Payware Connect (IPCharge) is a electronic payment service offered via the internet. It is a secure site and application that is certified by Visa & Mastercard to meet stringent security standards. Payware Connect (IPCharge) may be manually accessed via a web address (URL) that may be typed into a compatible browser.

The web address is: https://Payware Connect (IPCharge).com/nma/MC

Accessing Payware Connect (IPCharge) directly via a web browser will display a log-in form. Once logged in, the Payware Connect (IPCharge) starts and presents a payment form where an electronic payment may be accepted. In addition, a menu of it's other maintenance and reporting functions is available as well.

ProfitSystem, when properly configured, will automatically process electronic payments via Payware Connect (IPCharge). Sign up with BBL for a Payware Connect (IPCharge) account. Once accepted a Payware Connect (IPCharge) Merchant Number, Merchant Code, User ID & Password will be provided with a detailed welcome kit. A new ProfitSystem user should be created following the steps within this topic.

Log into Payware Connect (IPCharge) via the web address above once this information is received and follow the steps listed here

Step 1

  1. From the top menu, select Account Admin-> User Manager
  2. Click New to create a new user with the following details:
    User ID: APIUSER
    Full Name: API user
    Password: (a password must be created following Payware Connect (IPCharge)'s rules (rules of Visa & Mastercard)

Note: To help you remember the password we recommend a pass phrase which is two related words separated by numbers. The password must contain uppercase and lowercase letters, and numbers, example BLUE4sky2

Visa & Mastercard REQUIRE for passwords to be change every 90 days and Payware Connect (IPCharge) enforces this rule. Log-in to Payware Connect (IPCharge)to modify the password. In addition, the six previous passwords may not be reused.

Enable debit: checked
Role: select Administrator
Scroll down to Select Transaction types and click Check All.
Click Save

Step 2

Go to Account Admin->API Key Management. Click Select Key to Copy button and type Ctrl-C to copy the key to your computer's Windows clipboard.
Key field. Also, write the key down ona piece of paper. This key will be used in ProfitSystem and uniquely identifies this shop to Payware Connect (IPCharge) when processing electronic payments thru ProfitSystem. This may be immediately pasted into the ProfitSystem Merchant Key field, described in ProfitSystem setup below.

NOTE:

Before attempting to set up ProfitSystem for use with Payware Connect (IPCharge), make sure that the Payware Connect (IPCharge) software is properly configured by processing a credit card for $1 via it's web terminal. Choose Transaction Processing-> Web Terminal and process a charge. Contact the merchant vendor for technical support if Payware Connect (IPCharge) cannot process the charge. click Log Out to close Payware Connect (IPCharge)

Configuring

Go Software Payware Connect (IPCharge) with ProfitSystem Configure ProfitSystem to process credit card Sale/Credit & debit card transactions with Verifone’s Payware Connect (IPCharge).

From the ProfitSystem Main Menu, choose Main->Housekeeping->General Setup->Stores-> Options Tab.(for optional multi-store implementations this must be completed for each store)

On the Options tab' Credit Card Processing – Choose Payware Connect (IPCharge) Merchant ID (code) – Enter the store's merchant ID/code
Login Information - Complete the following log-in fields with the information provided by Payware Connect (IPCharge)
User Name...
Password...
Merchant
ID (code)... Merchant
Key... This is the key that was written down and copied to your Windows clipboard. Perform a Ctrl P to paste it in this field.

That is it. Test by creating a ProfitSystem ticket and running a small charge through.

The Payware Connect (IPCharge) integration provides an additional feature over PCCharge/ICVerify integration. It allows credit card information to be saved for customers.

The option to save Credit Card may be disabled. This is accomplished in: Housekeeping-> General Setup-> System Setup-> Options Tab-> 'Don't allow credit card to be saved?'. Check this setting to turn off the ability to save credit card info.

Credit card information may be saved from the customer form, event form, or during a credit card payment. Saving a credit card from the customer form or during a Credit Card payment will instruct ProfitSystem to store the details for the customer (it will save the credit card information during a payment to the customer who owns the ticket the payment is being applied to), and can be used again by that customer.

Any member of an event can use the event's credit card information to make a payment if credit card information is saved with an Event via the Event-> Event tab. Of course this is controlled by the ProfitSystem clerk and should be utilized after authorization of the credit card's owner.

To save credit card information directly to a customer the user visits the Customer card, Main-> Customer-> Details tab-> Add Credit Card. To save credit card information directly to a customer the user visits the Customer card, Main-> View/Change Event-> Event tab-> Add Credit Card. After choosing 'Add a Credit Card' The user may swipe a credit card or manually enter the acct #, exp date, address and zip, The credit card information is actually stored with the Payware Connect (IPCharge) computers. Accepting a credit card payment for a customer or event with saved credit card info will cause ProfitSystem to present an option to use the saved credit card. This may be accepted. If not accepted the user may choose to use a different credit card by swiping or entering the credit card info.

Upgrading

ProfitSystem version 8 and earlier would save a customer's credit card information in it's own database. This is not allowed by new Visa/Mastercard regulations.

When ProfitSystem version 9 or a newer software version is first started it will check to see if there's any saved credit cards in event, customer, or the ticket file. If there are, it saves the current system date and provides 60 days for the store to perform any store tasks concerning the credit cards (like writing them down or processing any charges .etc) . ProfitSystem will ask at each startup, as a reminder, for permission to allow it process the card information. At the end of 60 days it will automatically process the saved card information.

Note

IMPORTANT, when Payware Connect (IPCharge) is/will be utilized by the store, insure it is setup and functioning prior to allowing ProfitSystem to process the stored card information.

ProfitSystem will process the saved card information in this manner.

As each customer/event's and ticket saved card information is cleared the information is archived into a text/csv file called CARDS.TXT and placed in the \ProgramData\ProfitSystem\User folder. The format of this file is Name, Card #, Expiration date, Address, Zip.

Credit Card information stored on tickets is converted to *[last 4 digits] and the expiration date becomes /**.. With Payware Connect (IPCharge) integration, customer/event credit card information will be exported to Payware Connect (IPCharge) as a Contract when each is cleared in ProfitSystem. Customer credit card information will be created under a Contract ID of 'CU' + customer number. Event credit card information will be exported using a contract ID of 'EV' + event number. Future credit cards for customers and events will follow this same convention.

To see customers & events with saved credit cards log-in to the Payware Connect (IPCharge) account via the web address. From the menu choose, Recurring Billing-> Dashboard-> Add-On contracts. Double click a customer name to review/edit additional details. This information cannot currently be deleted. Review the Payware Connect (IPCharge) manual to see how add-on contracts may be further utilized.

Add Payware Connect (IPCharge) to Quick launch

Set up a ProfitSystem Quick Launch selection to the on-line Payware Connect (IPCharge) console when your ProfitSystem version does not have the selection. Housekeeping-> General Setup-> Actions/Transfer table.

Technical Details

Payware changed their processing endpoints as of 1/1/2018. ProfitSystem was updated to use the latest endpoints in version 13.85.

If a shop is running an old version of ProfitSystem, you can add the following lines to TPSWIN.INI to use the new endpoints.

IPCProdURL1=https://api.vfipayna.com/IPCHAPI/RH.ASPX IPCProdURL2=https://api.vfipayna.com/IPCHAPI/RH.ASPX IPCBillURL1=https://api.vfipayna.com/IPCAdminAPI/RH.IPC IPCBillURL2=https://api.vfipayna.com/IPCAdminAPI/RH.IPC

These URLs require Windows 7 or later or Server 2012 or later. Windows 7, server 2012 do not support the TLS level required for these new URL's.

The ProfitSystem can log all communication with Payware. To enable logging, create at file called paywarelog.txt in the program install folder. All XML communication with Payware will be logged in the system log, as entry LOGCHARGE. The system log can be viewed at Setup->System Maintenance->Log.

Phase I- SEPTEMBER 20, 2016 05:30AM 1. Verifone will change the domain IPCHARGE2.NET SSL certificate to SHA-256, which is used by all integrations and devices. This domain will remain SSLV3 for the next year. [Customers who still do not support SHA-256 by September 20, 2016, will be able to connect to the alternate domain of ipcharge.net until October 18, 2016.]

https://ipcharge2.net/ipchapi/rh.aspx (Device/Integration URL)
https://ipcharge2.net/CPADM/rh.cpa (Admin API)
https://ipcharge2.net/ipcadminapi/rh.ipc (Recurring Billing API)

  1. Verifone will change the IPCHARGE.COM URL used by PWC Store Portal and Corporate Portals to enforce TLS1.2 and disable SSLV3, TLS1.0, and TLS1.1 [Customers who still do not support TLS1.2 in their web browser will need to either fix this immediately or will be able to use the alternate domain of ipcharge2.com until October 18, 2016.]

https://ipcharge.com/mc (Store Portal)
https://ipcharge.com/rc (Corporate Portal)

Phase II-OCTOBER 18, 2016 05:30AM 3. Verifone will change the domain IPCHARGE.NET SSL certificate to SHA-256, which is used by all integrations and devices. This URL will remain SSLV3 for the next year.

https://ipcharge.net/ipchapi/rh.aspx (Device/Integration URL)
https://ipcharge.net/CPADM/rh.cpa (Admin API)
https://ipcharge.net/ipcadminapi/rh.ipc (Recurring Billing API)