Payments
FreedomPay (FCC) User Guide
Overview of the FreedomPay (FCC) payment gateway integration with Mashgin: checkout flow, requirements, DMP key, installation, supported features, and vendor support.
๐ Overview
This guide covers the FreedomPay (FCC) integration within Mashgin. FreedomPay is a payment gateway that utilizes Ingenico card readers.
๐ Checkout Flow
- The customer places item(s) on the base of the kiosk.
- The customer uses a credit / debit card or tap-to-pay on the Ingenico reader to complete the transaction.
The customer is able to pay at any time. No need to press Pay Now!
โ Requirements
- Confirm with Mashgin Support that the payment credentials are in place.
- Mashgin needs the following information prior to software installation:
- Store ID
- Terminal ID
- DMP Key
๐ How to Acquire the DMP Key
- Anyone with admin access can find or generate the DMP (Device Management Portal) key in the FreedomPay Enterprise Portal.
- If no one on your team has admin access, open a case with FreedomPay to request the DMP key for your account.
๐งญ Installation
Step 1. Plug in the payment device
Confirm with Mashgin Support that you are on-site before plugging in the payment device.
The payment reader should be plugged into the USB port located directly underneath the power button.

Step 2. Install the FCC package
Once instructed, open Staff Mode and go to Manage > Setup > Payments > FreedomPay. Select the package, then press "Install":
- Prod: Allows offline transactions. If the network drops, the kiosk keeps taking card payments and uploads them once it reconnects.
- Prod-No-Offline: Blocks offline transactions. Card payments only go through while the kiosk is online.
- UAT: For test devices only.
Step 3. Wait for the reader to finish
Once installation is complete, the payment reader will display "Secured by FreedomPay" and the FCC/PAL details will auto-fill.
The reader will reboot several times during installation. Do not continue until it has completed the reboot cycles.
Step 4. Run a test transaction
Perform a test transaction to confirm successful installation. During the transaction you should see the message "WELCOME TO MASHGIN" followed by the transaction total amount. If you run into any issues, notify Mashgin Support at help@mashgin.com.
โจ Supported Features
- Store and Forward (Offline Payments): The kiosk captures payment data during instances where the network connection is not consistent and allows the payment to still go through. Payment data is then uploaded once the network connection is restored.
- Only available with the Prod package.
- Partial Refunds: FreedomPay supports partial refunds. A transaction can be refunded once.
๐ค Integration Request
To enable this integration, reach out to sales@mashgin.com for more information.
๐ Relevant Articles
Need help? Contact support at ๐ง help@mashgin.com or call (855) 475-0889
