Overview of OpenEdge+XWeb & EMV Integration (US Facilities Only)

This article currently only applies to US-based merchants.

With the OpenEdge + Rock Gym Pro integration, you can process POS credit card payments and membership billing directly from your RGP workstation. 

READ THIS FIRST AND GO THROUGH EACH POINT WITH OPENEDGE!


Requirements From OpenEdge

  • Two sets of XWeb credentials from OpenEdge. These can be linked to the same merchant account.
    • One credential should be configured for EMV/RETAIL
    • The other credential should be configured for MOTO (for your membership billing)
  • Both sets of credentials need to share the same XWebID
  • If you have been using Rock Gym Pro previously with stored credit cards, the new credentials must use the existing XWebID as your current credentials. If not, you will lose your stored credit card aliases.
  • Only GlobalPayments is supported. If you are currently using TransFirst, OpenEdge will need to migrate you to GlobalPayments
  • If you are a multigym facility, make sure OpenEdge has enabled alias sharing between your merchant accounts.
  • For each workstation requiring credit card processing, you will need to purchase a terminal from OpenEdge.
    • IMPORTANT - You cannot mix old-style credit card swipers and EMV terminals within your facility.  You need to move over all your credit card processing to the new EMV terminals and remove the old swipers.  You can swipe cards without chips into EMV terminals.  And you can key-in card numbers to EMV terminals for phone transactions.
    • Only the IPP320 is supported You want the device without integrated signature capture. Your customers will continue to sign a printed receipt. Price is $250 per device.
    • The device must be purchased directly from OpenEdge to be properly configured.
    • You cannot share an EMV device between workstations.


Known Issues

  • The EMV/RETAIL credential should be configured at OpenEdge in such a way as to allow the auto-submit to operate properly on the POS form. This means it should not prompt for address/zip when completing POS transactions. The submit button will still need to be pressed for returns.
  • ApplePay Alias Capture
    • While ApplePay “appears” to work for capturing credit card aliases, the returned last four digits do not match. This is a known issue with ApplePay and there currently is no workaround. Do not use ApplePay to capture aliases.
  • Card Validation Message
    • OpenEdge will automatically display a “card validation message” if the same card is swiped/inserted within a period of time. Your staff will need to press Yes to continue.


Installing and configuring your EMV Device

  • The EMV device requires software from OpenEdge to be installed and operating on your workstation.
  • Please contact OpenEdge for assistance with installing and configuring your EMV device. Allow 30 minutes to properly configure the device.
  • Any and all support for the OpenEdge software must be directed to OpenEdge

 

EdgeExpress EMV Library from OpenEdge

Rock Gym Pro communicates to the EMV terminal using the Edge Express library.   The library can be downloaded and installed from the link below.

https://www.x-charge.com/downloads/files/RCM%20Windows_GA.exe  

While installing the  EdgeExpress Library, you may receive a command line popup with an error message similar to the screenshot below. You can ignore this message, which simply indicates that there was no firmware update available for the EMV terminal. The update will have been successful, despite this error message appearing.

emv2.png

RGP Cloud Installations

For EMV installations on RGP Cloud, note the following instructions:

  • The EdgeExpress library is ALREADY installed on your cloud host.  So you do NOT need to install the EdgeExpress library on your cloud host
  • The EMV terminal USB drivers needs to be installed on your LOCAL computer - the computer connected to the actual device.

Entering Credentials in Rock Gym Pro

IMPORTANT - Before entering your new credentials, cut-and-paste your existing credentials (both sets!) to a saved document in case their are problems with your new credentials and you need to revert back to your old ones.

Launch Data Entry -> Manage -> Settings -> Payment & Billing.  Select OpenEdge / XWeb as shown in the screen capture below.  For each account, you’ll need to enter the credentials by pressing the CONFIGURE button.

Your RETAIL credentials should be placed in the POINT OF SALE gateway, and your MOTO credentials should be placed in the BILLING CREDIT CARD credentials.

openedge2.png

 

After entering your credentials, select the EMV option for your integration method (select the EdgeExpress option).  This option should be selected for both the BILLING and POS credential sets.

 


Storing Credit Card Aliases on Customers

When you press the Change Card button when editing a member, you can optionally choose to use the EMV device to capture credit card aliases. If you are currently using a workstation that does not have an EMV device attached, you can select No for this prompt to key-in the credit card manually using the keyboard.

If you are a multigym facility, make sure OpenEdge has enabled alias sharing between all your locations.

 

openedge5.png


Running POS Transactions

When running credit card transactions at POS, you will see two buttons to process a credit card. One requires an EMV device and the other does not. If you are using a workstation that does not have an EMV device attached (for example in the back office), then you want to use the Key in credit card button to manually key in the credit card button.

openedge3.png 

 

NOTE:  If you are at a terminal with an EMV device, you should use the  EMV device to manually key in a number as well.   See screenshot below.   For this option you need to press the CREDIT CARD button on the Payment Completion window (not the key-in button) and then use the EMV device to manually enter the card.

 

openedge9.png

 

Card Validation Window: If OpenEdge recognizes the same credit card within a period of time (regardless of the amount!), the following message will be displayed to your staff.

openedge1.png

 

 

ApplePay

ApplePay works for POS transactions with the EMV device.  The transaction is recorded like normal with whatever payment method was provided (Amex, Visa, MC, or Discover).    The customer needs to hold their phone up to the EMV device when prompted.

ApplePay does NOT return the last four digits of the card number.   So you will not have that for record keeping.

IMPORTANT!  There is a known issue with ApplePay regarding capturing aliases via ApplePay.  While ApplePay “appears” to work for capturing credit card aliases, the returned credit card #s last four digits does not match.  DO NOT USE APPLEPAY TO CAPTURE ALIASES.  ApplePay does work fine for POS transactions.

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.