FreedomPay

In this article

Setup

Support

All settings to communicate with the terminal are set in FreeWayClientService.exe.config, FreeWayServerService.exe.config, and LaneConfig.xml files located on C:\Program Files (x86)\FreedomPay\FreewayCommerceConnect.

Setup

Terminals can be connected via USB or WiFi/IP.

Settings

  • IP Address is the IP address used to communicate with the terminal. Should be set to 127.0.0.1.
  • MainPort is the port used for communication. Should be set to 1011.
  • Timeout indicates, in seconds, for how long a communication is kept alive.
  • TerminalID is the identification given by FreedomPay for the terminal.
  • StoreID is the identification given by FreedomPay for the store.
  • LaneID refers to which settings line to use from LaneConfig.xml file.
  • WorkstationID refers to the name of the machine used to make requests. Is set in the FreedomPay config files.
  • ReceiptLineWidth ,the default value is set to 40 characters, the same as in LS Central.
  • TokenType refers to what kind of Token is used. Default is set to 6.
  • AllowPartial enables partial payments when set to true.
  • EnableDCC enables DCC transactions when set to true.

Support

EFT

FreedomPay supports the core EFT functions available in LS Pay:

  • Purchase
    • MOTO payments (Mail Order Telephone Order).
    • Token payments
    • VoiceAuth
  • Refund
    • Stand-alone refund (no previous purchase).
    • Referenced refund (linked to previous purchase).
      1. Full referenced refund.
      2. Partial referenced refund.
  • Void
    • Can void any previous transaction.
  • Get last transaction
    • Returns the last transaction response received.
  • Get last raw transaction
    • FreedomPay does not support GetLastRawTransaction.
  • Cancel
    • FreedomPay does not support canceling from POS to PED.
  • CreateToken
    • Creates a token for a card that can be stored.

Pre-authorization

  • Pre-authorization
  • Update pre-authorization to update amount or to prolong the authorization.
  • Cancel pre-authorization to release the amount.
  • Finalize pre-authorization to confirm the amount used for the transaction.

Gift cards

Gift card features have been added to the integration:

  • Activate
  • Add value
  • Balance inquiry
  • Deactivate.

Hotel data

Hotel data features have been added to the integration through AdditionalData fields:

Copy
Hotel data
  {Key:"IndustryType", Value: "hotel"},
  {Key:"Hotel_CheckInDate", Value: "07/26/2023"},
  {Key:"Hotel_CheckOutDate", Value: "07/29/2023"},
  {Key:"Hotel_RoomRate", Value: "51.19"},
  {Key:"Hotel_RoomTax", Value: "0.10"},

Level II data

Level II data is added in AdditionalData as key value pairs:

Copy
Level II data
    {Key:"CustomerId", Value: "95239922"},
    {Key:"CustomerPONumber", Value: "PO239933"},
    {Key:"CustomerPODate", Value: "6/26/2018"},
    {Key:"CustomerCode", Value: "33223322"},
    {Key:"BillTo_FirstName", Value: "Bob"},
    {Key:"BillTo_LastName", Value: "Smith"},
    {Key:"BillTo_Street1", Value: "123 Industry Lane"},
    {Key:"BillTo_City", Value: "Testville"},
    {Key:"BillTo_State", Value: "PA"},
    {Key:"BillTo_PostalCode", Value: "19403"},

Level III data

Level III data uses LineItems to populate product information that must be sent with the request:

Copy

Level III data

  {Key:"SKU", Value: "DELIV122"},
  {Key:"Description", Value: "Delivery Charge"},
  {Key:"UPC", Value: "96224"},
  {Key:"UnitPrice", Value: "10.0"},
  {Key:"Quantity", Value: "2.5"},
  {Key:"TotalAmount", Value: "26.50"},
  {Key:"TaxAmount", Value: "1.50"},
  {Key:"SKU", Value: "HUR"},
  {Key:"SaleCode", Value: "S"},