ZenotiHelp

Processor: Freedompay

ZTZenoti Docs Team Updated September 5, 2026 3 min readGuide

FreedomPay is a V1 payment processor configured at the center level. It supports credit and debit card payments with integrated card-reader support, secure vault storage via FreedomPayStoredAccount, and recurring billing. Primarily used in the US and UK hospitality markets.

Before you begin

Permission: Center-level payment configuration access is required.

FreedomPay merchant-side prerequisites

  • Active FreedomPay merchant account.
  • Store and terminal provisioning β€” FreedomPay issues a Store ID per physical outlet and a Terminal ID per card reader. Get these before configuring Zenoti.
  • Vault enrolment β€” FreedomPay enables the secure vault per MID (Merchant Identifier) for card-on-file.

Credentials

Field Source / owner What to enter
Store ID FreedomPay merchant portal / account representative Outlet identifier. One per center.
Terminal ID FreedomPay terminal provisioning One per physical card reader.
Additional credentials (API key / secret per environment) FreedomPay account representative As required by your specific FreedomPay account type. [SOURCE GAP β€” PM VERIFY: full list of fields β€” FS references "additional credentials" without enumeration.]

Network requirements

Direction Port Protocol Why
Outbound from Zenoti to FreedomPay API 443 HTTPS Charge, refund, void, tokenize
Outbound from POS (Point of Sale) / terminal to FreedomPay 443 HTTPS Terminal-integrated payments

FreedomPay capabilities in Zenoti

Capability Supported
Sale Yes
Refund Yes
Void (pre-settlement) Yes
Pre-authorize and capture Yes
Stored accounts Yes (FreedomPayStoredAccount)
Recurring payments Yes
Terminal (POS) Yes
Global tokenization No
Automatic card updating No (not in SupportsPaymentAccountUpdate list)

Configure FreedomPay

  1. At the center level, navigate to Configuration > Payments > Settings (the center-scope caption of the Payments row).
  2. Select FreedomPay as the payment processor.
  3. Enter the Store ID, Terminal ID, and additional credentials from FreedomPay.
  4. Enable the payment channels you want to accept.
  5. Select Save.
  6. Select Test to verify.

Toggle interactions

Terminal payments Card-on-file Behaviour
Off Off FreedomPay unavailable at checkout.
On Off One-off terminal payments only; no return-guest card convenience.
Off On Card-on-file charges only (for example, MOTO or embedded web flows).
On On Recommended for hospitality centers running both walk-in and membership billing.

Process a payment

Terminal:

  1. Staff selects FreedomPay on the invoice.
  2. Guest taps / inserts / swipes on the FreedomPay terminal.
  3. Result returned to Zenoti; invoice closes on approval.

Card-on-file:

  1. Staff selects a stored card for the guest.
  2. Zenoti charges via the FreedomPay vault token.

Process a refund

Refund β€” dual-system perspective

System What happens
Zenoti Negative payment line; Collections report shows the refund row.
FreedomPay Separate refund record linked to the original transaction. Match key: FreedomPay transaction reference or Zenoti invoice number.

Process a void

Voids cancel pre-settlement. After settlement, use a refund.

Edit or reverse a posted payment

Invoice state What you can do
Open Remove the payment line; void (pre-settlement) or refund (post-settlement).
Closed Reopen if permissions allow, or post a compensating refund. Original line preserved.

Failure modes

Failure mode User-visible symptom Resolution
FreedomPay unreachable Terminal / online flow fails with communication error. Check HTTPS and FreedomPay status.
Authentication expired Every transaction fails with auth error. Re-verify credentials with FreedomPay.
Card declined Issuer decline. Guest retries.
Amount out of range Rejected at FreedomPay. Per-MID limits; contact FreedomPay.
Currency mismatch Rejected. Confirm center currency matches FreedomPay's activated currency.
Settlement failure Approved but missing from settlement report. Raise with FreedomPay using the transaction reference.
Terminal ID mismatch Transaction fails at the terminal. Verify the physical terminal ID matches the configured Terminal ID in Zenoti.

Settlement and reconciliation

FreedomPay US settlement is typically T+1 to T+2, excluding weekends and US federal holidays. [SOURCE GAP β€” PM VERIFY: UK / other markets.]

Source Report / view Match key
Zenoti Collections report (filter: Payment Method = FreedomPay) FreedomPay transaction reference + Zenoti invoice number
FreedomPay FreedomPay merchant portal settlement / batch report Same fields

Recommended cadence: daily.

Tips

  • Verify that the terminal ID matches your FreedomPay terminal device assignment.
  • Contact your FreedomPay account representative if you need additional store IDs for multiple terminals.
  • Cards stored against FreedomPay cannot be migrated to a different processor without re-enrolment (no global tokenization).
Was this article helpful?
Your feedback helps us improve our documentation.