mashgin

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


  1. The customer places item(s) on the base of the kiosk.
  1. 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


  • 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.

Notion image

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

Did this answer your question?
๐Ÿ˜ž
๐Ÿ˜
๐Ÿคฉ