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
- At the center level, navigate to Configuration > Payments > Settings (the center-scope caption of the Payments row).
- Select Payment Express as the payment processor.
- Enter the PX Post username, PX Post password, and Post URL.
- Enable the payment channels.
- Select Save.
- 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:
- Staff selects Payment Express on the invoice.
- Guest taps / inserts on the card reader.
- Result returned; invoice closes on approval.
Card-on-file:
- Staff selects a stored card.
- 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.