ZenotiHelp

Processor: Payment express

ZTZenoti Docs Team Updated September 5, 2026 3 min readGuide

Payment Express (now part of Windcave) is a V1 payment processor configured at the center level. It supports card payments with integrated terminal support and card-on-file storage, primarily serving Australia and New Zealand.

Before you begin

Permission: Center-level payment configuration access is required.

Payment Express merchant-side prerequisites

  • Active Payment Express / Windcave merchant account for your region and currency.
  • Terminal provisioning β€” for terminal transactions, Payment Express pairs the card reader to your MID (Merchant Identifier).
  • Card-on-file vault enrolment β€” Payment Express enables the stored-card vault per MID.

Credentials

Field Source / owner What to enter
PX Post username Payment Express merchant agreement / account representative API user for the PX Post endpoint.
PX Post password Payment Express merchant agreement / account representative Bound to the PX Post username.
Post URL Payment Express account representative Gateway endpoint URL. Production and test URLs are different; do not guess.

Network requirements

Direction Port Protocol Why
Outbound from Zenoti to PX Post URL 443 HTTPS Charge, refund, tokenize
Outbound from POS (Point of Sale) / terminal to Payment Express 443 HTTPS Terminal-integrated payments

Payment Express capabilities in Zenoti

Capability Supported
Sale Yes
Refund Yes
Void [SOURCE GAP β€” PM VERIFY: PaymentExpressProcessor.cs has no VoidTransaction override. PX Post supports a "Status" and "Refund" action; a discrete void may be handled as a same-day refund.]
Pre-authorize and capture Yes
Terminal (POS) Yes
Stored accounts Yes
Recurring payments Yes
Global tokenization No

Configure Payment Express

  1. At the center level, navigate to Configuration > Payments > Settings (the center-scope caption of the Payments row).
  2. Select Payment Express as the payment processor.
  3. Enter the PX Post username, PX Post password, and Post URL.
  4. Enable the payment channels.
  5. Select Save.
  6. Select Test to verify.

Toggle interactions

Terminal Card-on-file Behaviour
Off Off Payment Express unavailable.
On Off Walk-in terminal only.
Off On Card-on-file only.
On On Recommended.

Process a payment

Terminal:

  1. Staff selects Payment Express on the invoice.
  2. Guest taps / inserts on the card reader.
  3. Result returned; invoice closes on approval.

Card-on-file:

  1. Staff selects a stored card.
  2. Zenoti charges via the PX Post vault token.

Process a refund

Refund β€” dual-system perspective

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

Edit or reverse a posted payment

Invoice state What you can do
Open Remove the payment line and refund if a charge has already gone through. Because there is no discrete void, same-day cancellations use refund.
Closed Reopen if permissions allow, or post a compensating refund.

Failure modes

Failure mode User-visible symptom Resolution
PX Post URL unreachable Every transaction fails with communication error. Check HTTPS and Payment Express status. Confirm the Post URL is current (production vs test).
Authentication All transactions fail with auth error. Re-verify username / password with Payment Express.
Card declined Issuer decline. Guest retries.
Amount out of range Rejected at gateway. Per-MID limits; contact Payment Express.
Currency mismatch Rejected. Payment Express supports AUD, NZD, and other currencies per MID. Confirm activation.
Settlement failure Approved but missing from settlement. Raise with Payment Express using the transaction reference.
Terminal pairing mismatch Terminal fails to transact. Re-pair the terminal to the MID with Payment Express support.

Settlement and reconciliation

Payment Express settlement in AU/NZ is typically T+1, excluding weekends and local bank holidays. [SOURCE GAP β€” PM VERIFY: exact window per acquirer / card scheme.]

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

Recommended cadence: daily.

Tips

  • The Post URL must be the correct Payment Express gateway URL for your region (production or test). Using a test URL in production will cause all transactions to fail.
  • Contact your Payment Express account representative if you encounter authentication errors.
  • Payment Express tokens are local β€” cards cannot be migrated away without re-enrolment.
Was this article helpful?
Your feedback helps us improve our documentation.