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
- At the center level, navigate to Configuration > Payments > Settings (the center-scope caption of the Payments row).
- Select FreedomPay as the payment processor.
- Enter the Store ID, Terminal ID, and additional credentials from FreedomPay.
- Enable the payment channels you want to accept.
- Select Save.
- 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:
- Staff selects FreedomPay on the invoice.
- Guest taps / inserts / swipes on the FreedomPay terminal.
- Result returned to Zenoti; invoice closes on approval.
Card-on-file:
- Staff selects a stored card for the guest.
- 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.