MercuryPay API: Requirements

To run successfully, this sample demo requires the following:

Kiosk Pro Enterprise, version 7.8 or later

While the JavaScript included in this code sample is compatible with earlier versions of Kiosk Pro, those versions require a different 'kiosk_functions.js' file to access this functionality.

For live projects, we highly recommend hosting the 'kiosk_functions.js' file with your own files, whether they are placed on a server or stored locally on the iPad, and checking the app's change logs before updating. The 'kiosk_functions.js' file referenced in the sample may be updated or moved without warning - if you are referencing this file directly, this would prevent your kiosks from working correctly.

To run the demo on earlier versions of the app, generate the 'kiosk_functions.js' for that version from the settings menu under 'JavaScript API > Generate API Functions File'. Transfer the file from the device using iTunes so you can place it where you need it, then change the reference in the sample code to point at the file.

Connection to a card reader with MercuryPay-specific encryption

As charges are submitted directly to MercuryPay's servers for processing with PCI-compliant encryption in place, use of this API requires a IDTech Shuttle or Magtek iDynamo card reader encrypted with MercuryPay's specific key.

These specially-encrypted card readers can be purchased directly from Kiosk Group. Kiosk enclosures designed to accomodate these readers are also available. For more information and pricing, please contact us.

MercuryPay Merchant Account

To process charges thorugh MercuryPay's servers, you will require a merchant account. For more information about MercuryPay services and obtaining a merchant account, visit

Specific Kiosk Pro Settings

IDTech Shuttle Demo MagTek iDynamo Demo