Skip to main content

Terminals

Open Store Operations > Terminals to review registered devices and payment readiness for the selected store. The page requires store.terminals.read. It is a merchant status and configuration view; adding, registering, or provisioning a terminal remains a Peak Support task.

On Android, current server feature-resolution flags determine available features, within the terminal's effective product tier. The server limits that tier to the lower of the organization's edition and the device's hardware tier: NEXGO N62/N92 are Peak Terminal, EF20 is Peak Simple, and Landi C20 Pro is Peak POS. Peak Terminal keeps payments, history/refund/void, reports, enabled gift cards and customers, settings, support, and sync. Cash tools, End of Day, and employee clock-in/out remain available when the cash module and operator permissions allow them. Catalog administration, inventory, orders/invoices, appointments, employee administration, and full tax configuration belong in the portal or full POS, and cannot be opened through alternate Android routes on Peak Terminal.

The More screen uses the same compact tile grid on every product tier, with more columns on wider screens. Tools remain subject to the current tier and employee permissions. The header identifies the store (or business when no store name is available), and the footer quietly reports the last sync. Sync refreshes checkout data even when product management is unavailable.

More destinations also use the signed-in operator's current effective server permissions, not a role name: Reports requires store.reports.read; Products requires store.products.read; Expiry Alerts requires store.inventory.read; Lot Receiving requires store.inventory.receive.write and product read; Stock Transfers requires transfer read/write and product read. Orders requires transaction read, appointments requires appointment read, employee administration requires organization/member administration, and cash tools require cash read/write. These checks apply equally to Peak Terminal, Peak Simple, and Peak POS, in addition to the store's feature capabilities. A restricted cashier sees only granted destinations; a manager title does not bypass a denial. Personal shifts, notifications, gift-card balance, settings, support, and catalog synchronization retain their existing terminal-self-service and feature gates. Failed list loads show an error rather than claiming the list is empty.

The register does not persist or replay privileged feature visibility. While current access is unresolved, new privileged navigation is unavailable; an already-open form retains its draft and camera callback but remains covered and noninteractive. A fresh denial closes that workflow. Draft ownership resets when the organization, store, or employee session changes. Visibility is refreshed for those changes and whenever the register resumes. PIN admission and server endpoint permissions still apply independently.

Temporarily unresolved access does not detach an already-admitted checkout customer or erase that sale's loyalty state. A fresh denial or scope/session reset can clear the association. Customer-ID lookups also recheck current feature availability at completion: a scan started before access was revoked cannot attach a customer afterward.

Review the terminal fleet​

  1. Confirm the selected store.
  2. Open Terminals.
  3. Review the fleet summary for online, offline, and total devices.
  4. Review each row's:
    • terminal name and identifier;
    • Online, Offline, or Unknown status;
    • model and app version;
    • battery and storage, when reported; and
    • certificate expiration date.
  5. Select Refresh when you need an immediate update. The list also refreshes automatically every 30 seconds.
  6. Select a row to open the device detail.

The detail can include device identity, last-seen time, certificate status, battery, storage, scanner and card-reader connection, location, network information, uptime, memory, and registration timestamps. A value can be unavailable when the device has not reported it; that alone does not prove the hardware has failed.

Check Gateway status​

The Gateway section is available only when the role also has store.transactions.read.

  • If an account appears, review its authorization status and any displayed transit state.
  • If the page says no Peak Gateway account is connected, payment setup is not complete for that store.
  • If Gateway status cannot load, use Retry Gateway status after confirming the selected store and connection.

A user can have terminal read access without Sales & Payments access. In that case, the fleet remains visible but Gateway status does not.

Review payment configuration​

Open a terminal row and find Payment Configuration. The detail identifies the configured processor and device mode when available.

The merchant-editable setting currently exposed here is Proxy timeout. Changing it requires store.terminals.admin; other terminal readers see the value read-only.

  1. Confirm that you opened the intended terminal.
  2. Review the current processor, device type, and proxy timeout.
  3. Change the timeout only when your operating procedure or Peak Support directs you to.
  4. Select Save configuration.
  5. Reopen the detail and verify the saved value.

Store-wide receipt, tip, and gift-card behavior is inherited from checkout settings rather than configured per terminal here. EBT enablement is managed by Peak Support.

For Landi terminals, Peak Support selects NearPay on the POS itself or an external Nexgo reader. Selecting NearPay removes the external-reader pairing fields when the payment configuration is saved.

If the page says no payment configuration has been provisioned, contact Peak Support. The portal cannot create the missing configuration.

Deprovisioning intentionally removes the terminal's payment authorization and configuration. Re-enrolling the same physical device with a fresh Enrollment PIN restores its certificate identity from the device-reported hardware serial; support should not need to retype the serial. A serial already registered to another terminal in the organization cannot be claimed. Certificate enrollment does not automatically restore permission to take card payments. Peak Support must use Authorize relink for a device marked as requiring manual relink authorization, then save its payment configuration and verify readiness. The authorization action remains available even when the old payment configuration and observed device were cleared.

Understand POS price previews​

On the Android register, locally displayed subtotals are provisional while the server checkout quote is pending. Cash and card prices come from the matching server quote; the POS does not apply a cached surcharge percentage to invent a card price.

For a split payment, enter the intended cash portion. The remaining card price is shown after cash acceptance and receipt of the server's residual quote. Until then, the split panel labels the amount as pending rather than presenting a locally calculated card remainder.

Troubleshoot an offline terminal​

  1. Select Refresh and confirm the status is still Offline.
  2. Open the terminal detail and note Last seen.
  3. On the device, confirm power and the network connection.
  4. Check whether the scanner, card reader, battery, or storage detail points to a local device issue.
  5. Restart the terminal and reopen the register application.
  6. Wait for another fleet refresh and confirm whether the device returns online.

If every terminal is offline, check the store's router and whether another device can reach the internet. Follow the detailed steps in Troubleshooting.

Troubleshoot a payment issue​

  1. Confirm the terminal itself is online.
  2. Review the Gateway status, if your role can view it.
  3. Open the terminal and confirm that Payment Configuration exists.
  4. Check that the card reader is reported connected when diagnostics are available.
  5. Compare the issue with another terminal in the same store.
  6. Retry a payment only after you have checked Sales & Payments for an existing result.

Contact Peak Support when:

  • a new or replacement terminal must be added to the store;
  • the page shows no payment configuration or no connected Gateway account;
  • a certificate is expired or nearing expiration;
  • EBT or another support-managed payment capability must be enabled;
  • a terminal remains offline after power, network, restart, and refresh checks; or
  • payment attempts remain unresolved after checking Sales & Payments.

Include the organization, selected store, terminal name and identifier, last-seen time, app version, Gateway status, approximate payment time and amount, and the exact message displayed. Never send full card numbers or security codes.