Processor: Moneris canada
ZTZenoti Docs Team Updated September 5, 2026 3 min readGuide
Moneris Canada is a V1 payment processor configured at the center level. It supports card payments with integrated terminal (card-reader) support, card-on-file storage, and recurring billing for Canadian businesses.
Before you begin
Permission: Center-level payment configuration access is required.
Moneris merchant-side prerequisites
- Active Moneris merchant account with your Canadian acquirer.
- Terminal provisioning β Moneris issues a Terminal ID per physical card reader. Terminals must be personalised before first use.
- Vault enrolment β required for card-on-file.
Credentials
| Field | Source / owner | What to enter |
|---|---|---|
| Store ID | Moneris merchant portal / account representative | Outlet identifier. One per center. |
| API token | Moneris merchant portal | Authenticates API calls. Treat as sensitive. |
| Terminal ID | Moneris terminal personalisation | Required for terminal transactions. One per card reader. |
Network requirements
| Direction | Port | Protocol | Why |
|---|---|---|---|
| Outbound from Zenoti to Moneris API | 443 | HTTPS | Charge, refund, void, tokenize |
| Outbound from POS (Point of Sale) / terminal to Moneris | 443 | HTTPS | Terminal-integrated payments |
Moneris Canada capabilities in Zenoti
| Capability | Supported |
|---|---|
| Sale | Yes |
| Refund | Yes |
| Void (pre-settlement) | Yes |
| Pre-authorize and capture | Yes |
| Stored accounts | Yes |
| Recurring payments | Yes |
| Terminal (POS) | Yes |
| Global tokenization | No |
Configure Moneris Canada
- At the center level, navigate to Configuration > Payments > Settings (the center-scope caption of the Payments row).
- Select Moneris Canada as the payment processor.
- Enter the Store ID, API token, and Terminal ID.
- Enable the payment channels you want to accept.
- Select Save.
- Select Test to verify.
Toggle interactions
| Terminal payments | Card-on-file | Behaviour |
|---|---|---|
| Off | Off | Moneris unavailable at checkout. |
| On | Off | Walk-in terminal payments only. |
| Off | On | Card-on-file charges only (MOTO / web flows). |
| On | On | Recommended for Canadian centers running both. |
Process a payment
Terminal:
- Staff selects Moneris on the invoice.
- Guest taps / inserts on the Moneris card reader.
- Result returned to Zenoti; invoice closes on approval.
Card-on-file:
- Staff selects a stored card.
- Zenoti charges via the Moneris vault token.
Process a refund
Refund β dual-system perspective
| System | What happens |
|---|---|
| Zenoti | Negative payment line; Collections report shows the refund row. |
| Moneris | Separate refund record in the Moneris merchant portal linked to the original transaction. Match key: Moneris 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 |
|---|---|---|
| Moneris unreachable | Terminal / online flow fails with communication error. | Check HTTPS and Moneris status. |
| Authentication expired | All transactions fail with auth error. | Re-verify Store ID / API token with Moneris. |
| Card declined | Issuer decline. | Guest retries. |
| Amount out of range | Per-MID (Merchant Identifier) limits rejected. | Contact Moneris. |
| Currency mismatch | Rejected. | Moneris Canada settles in CAD. Confirm center currency. |
| Settlement failure | Approved but missing from daily batch. | Raise with Moneris using the transaction reference. |
| Terminal ID mismatch | Terminal rejects. | Verify the physical terminal ID matches the Zenoti configuration. |
Settlement and reconciliation
Moneris Canada settlement is typically next-business-day (T+1), excluding weekends and Canadian federal / provincial holidays. [SOURCE GAP β PM VERIFY: exact window for your MCC.]
| Source | Report / view | Match key |
|---|---|---|
| Zenoti | Collections report (filter: Payment Method = Moneris) | Moneris transaction reference + Zenoti invoice number |
| Moneris | Moneris merchant portal daily batch / settlement report | Same fields |
Recommended cadence: daily.
Tips
- Verify that the Terminal ID matches the Moneris terminal device assigned to this center.
- Contact your Moneris account representative if you need to add additional terminal IDs.
- Moneris tokens are local β cards cannot be migrated to a non-Moneris processor without re-enrolment.
Was this article helpful?
Your feedback helps us improve our documentation.