ePayments Mobile App

Supported Devices

The ePayments Mobile App is available for the following devices:
OS Devices
iOS iPhone, iPad, iPod Touch
Android Android phones and tablets

Downloading and Installing

Links to download these mobile apps can be found within the “API & Cart Downloads” section of your administration area.

They may also be found by searching for “ePayments” within Apple’s iTunes Store or Google’s Play Market respectively.

Initial Setup

Before you begin, you will need to have your account’s master login username. This username was issued by us to you at time of sign-up.

You’ll also need to have created/setup a mobile client password, for use with our ePayment Mobile Terminal app. If you’ve not created one yet, please do so using the ‘Mobile Client Password’ feature, within the ‘Username/Password Configuration’ sub-section of your account’s Security Administration area.

Initial Setup For iOS Devices:

  1. Download and install the latest version of our ePayments Mobile Terminal app from the iTunes Store.

  2. If you’ve purchased a compatible MagTek card reader, connect it to your mobile device now.

  3. Ensure your mobile device is actively connected to the internet. If not, enable your internet connection now.

  4. Start the ePayments Mobile Terminal app.
    (You may receive an ‘Invalid Account’ message, when starting the app for the 1st time. This is normal with some versions of the ePayments app.)

  5. Click on the ‘Settings’ button, to open the ‘App Settings’ screen.

  6. In the ‘App Settings’ screens, enter the following information:

    Username:
    - Enter your account’s master login username

    Mobile Terminal Password:
    - Enter the account’s Mobile Terminal Password; which you’ve created beforehand.

    CC Email Address: [Optional]
    - Enter the email address you’d liked CC’ed a copy of the merchant confirmation email.
    (Note: The primary merchant confirmation email will be sent to the email address set within your account’s Email Management area.)

    BillPay Lite:
    - For normal Virtual Terminal usage, leave the ‘Enabled’ option ‘OFF’.
    - To use a custom BillPay Lite template, set the ‘Enabled’ option to ‘ON’ & enter the preassigned template’s name into the ‘Template Name’ field.
    (Note: If BillPay Lite option is enabled, but no template name was specified, the ePayments app will attempt to use the default BillPay Lite template of that given account.)

    Card Reader Type:
    - When not using a MagTek card reader, leave the setting as ‘UNKNOWN’.
    - If using a compatible credit card reader from MagTek, click on the box where the word ‘UNKNOWN’ resides. A device list should appear at the bottom of the screen. Simply select your model reader from the list, in which is actively plugged into your mobile device.

  7. Click on the ‘Confirm’ button to save the changes.

  8. If any mistakes were made within the Username or Mobile Client Password, you’ll receive an ‘Invalid Account’ error message. Simply retry from step #5 to correct the issue.

  9. Assuming no problems were encountered, you’re done… You should now be be presented with the the ePayment app’s Virtual Terminal page or the custom BillPay Lite page (dependent upon how you’ve configured the app). You may now begin to accept payments through the app.

Initial Setup For Android Devices:

  1. Download and install the latest version of our ePayments Mobile Terminal app from the Google Play Store.

  2. If you’ve purchased a compatible MagTek card reader, connect it to your mobile device now.

  3. Ensure your mobile device is actively connected to the internet. If not, enable your internet connection now.

  4. Start the ePayments Mobile Terminal app.
    (You should be automatically presented with ’ePayments Settings’ screen.)

  5. If not already presented, press your mobile device’s Menu Key button. Then click on the ‘Settings’ option that appears on the screen.

  6. In the ’ePayments Settings’ screens, enter the following information:

    Username:
    - Enter your account’s master login username

    CC Email Address: [Optional]
    - Enter the email address you’d liked CC’ed a copy of the merchant confirmation email.
    (Note: The primary merchant confirmation email will be sent to the email address set within your account’s Email Management area.)

    Support Card Reader:
    - When not using a MagTek card reader, leave the setting as ‘No’.
    - If using a compatible credit card reader from MagTek, change the setting to ‘Yes’.
    (When enabled, you should now see a Save Card Reader option, set this to ‘Yes’.)

    Use BillPay Lite:
    - For normal Virtual Terminal usage, leave setting as ‘No’.
    - To use a custom BillPay Lite template, change the setting to ‘Yes’ & enter the preassigned template’s name into the ‘BillPay Lite Template’ field.
    (Note: If BillPay Lite option is enabled, but no template name was specified, the ePayments app will attempt to use the default BillPay Lite template of that given account.)

  7. Click on the ‘Save’ button to save the changes.

  8. If any mistakes were made within the Username, you’ll receive an ‘Invalid Account’ error message. Simply retry from step #5 to correct the issue.

  9. Assuming no problems were encountered, you’re done… You should now be be presented with the the ePayment app’s Virtual Terminal page or the custom BillPay Lite page (dependent upon how you’ve configured the app). You can now begin to accept payments through the app.

Optional Steps:

Verify your ePayments app is working properly, before accepting real payments.

Any time changes are made to your ePayments app’s settings, we highly recommend that you testing your new app configuration. This can be accomplished by temporally enabling the Testing Mode within your payment gateway account’s Merchant Administration area. Then process a test authorization using our test credit card information accordingly. This will confirm there are no problems submitting an authorization or with receiving a response back from our payment gateway.

Additionally, if using a credit card reader with your mobile device, it’s recommended that you swipe a real credit card through your reader, while the ePayment app’s Virtual Terminal page appears on the screen. If the card swipe was accepted properly, you should see the cardholder’s name, card number and expiration date populated. This is how you can confirm the reader is working properly with your mobile device.
Setting Required Notes
Mobile Terminal Username iOS, Android This is your gateway login name.
Mobile Terminal Password iOS This is your Mobile Terminal Password.   Before this can be entered into the app it must first be set up in the Security Administration > Username/Password Configuration section of your account.   This must be different than your main login password.
Receipt CC Email optional This is an email address where you can have a copy of the receipt sent to for your records. (see note 1)
Reload Server Settings optional When this option is ‘ON’ using the ‘Reload Form’ button will reload the form from the server. This option is mainly for troubleshooting and should be left ‘OFF’ in most cases.

Notes:

To use Receipt CC Email you must also have an email address entered in the ‘Email Management’ section of your Merchant Administration page.

Running Transactions

Once you completed the setup you can run authorizations using the app the same way you’d use your Virtual Terminal. Tap the ‘Submit’ button at the bottom of the form to submit your transaction.

When a transaction completes you will see it’s status. If it is successful you will have the option to print a receipt (iOS only). You will also have the option to run another transaction. If it fails you will have the option to try it again or run a new transaction.

You will also have the following options:
Button Description
Reload Form This will reload the form and clear it’s contents.
Settings & Info This will bring you back to the setup screen.

Notes:

  1. This app currently only supports authorizations. Returns and forced authorizations are not available at this time.

  2. All authorizations that are run through the app will show up in your administration the same way your other transactions do.

Card Readers
Device Compatible Reader Notes
iPhone MagTek iDynamo iPhone 4S and earlier.
iPhone MagTek uDynamo
iPad MagTek iDynamo
iPad MagTek uDynamo
Android devices MagTek Bullet

Notes:

The MagTek iDynamo, MagTek uDynamo and the MagTek Bullet will need to be injected with the encryption key number 90125100 to be compatible with Plug & Pay.

Please request the key injection when you make the purchase from MagTek.

Printing (iOS only)

If you have an AirPrint compatible printer, you can print receipts after transactions are completed. To do this, tap the ‘Print Receipt’ button at the bottom of the screen.