ZenotiHelp

Processor: Element express (worldpay)

ZTZenoti Docs Team Updated September 5, 2026 4 min readGuide

Element/Express (Worldpay) is a V1 payment processor configured at the center level. It supports credit and debit card payments with integrated terminal (card-reader) support, card-on-file storage via ElementPSStoredAccount, and automatic card updating through the Worldpay PASS Updater service.

Before you begin

Permission: Center-level payment configuration access is required.

Worldpay merchant-side prerequisites

  • Active Element/Express merchant account via Worldpay.
  • Application registration β€” Worldpay assigns an Application ID, name, and version per integrator; Zenoti's application credentials come from the Worldpay integrator programme.
  • Terminal personalisation β€” if you use physical card readers, Worldpay provisions each terminal with an Acceptor ID. Confirm the devices are delivered and personalised before configuring Zenoti.
  • PASS Updater enrolment (optional) β€” required if you want automatic card updating; Worldpay must enable PASS on the MID (Merchant Identifier).

Credentials

Field Source / owner What to enter
Account ID Worldpay merchant portal / account representative Numeric account identifier issued on activation.
Account token Worldpay merchant portal Token bound to the account ID; used to authenticate API calls.
Acceptor ID Worldpay terminal personalisation Identifies the physical merchant outlet / terminal to Worldpay.
Application ID Worldpay integrator programme (Zenoti-supplied) Identifies the Zenoti application to Worldpay.
Application name Worldpay integrator programme Matches the registered application name.
Application version Worldpay integrator programme Matches the registered version.

Note: Application ID / name / version are typically the same across centers within an organisation. Account ID, Account token, and Acceptor ID are per-center.

Network requirements

Direction Port Protocol Why
Outbound from Zenoti to Worldpay Express API 443 HTTPS Authorise, capture, refund, void, tokenize calls
Outbound from POS (Point of Sale) client / terminal to Worldpay 443 HTTPS Terminal-integrated payments
Outbound from Zenoti to Worldpay PASS Updater 443 HTTPS Nightly stored-card update job

Element/Express capabilities in Zenoti

Capability Supported
Sale Yes
Refund Yes
Void (pre-settlement) Yes
Pre-authorize and capture Yes
Stored accounts Yes (ElementPSStoredAccount)
Terminal (POS card reader) Yes (ElementPsCardReader)
Automatic card updating (Account Updater) Yes β€” via PASS Updater for Visa, Mastercard, Discover
Recurring payments Yes
Global tokenization (cross-processor) No (SupportsGlobalTokenization = false)

Configure Element/Express (Worldpay)

  1. At the center level, navigate to Configuration > Payments > Settings (the center-scope caption of the Payments row).
  2. Select Element/Express (Worldpay) as the payment processor.
  3. Enter the credentials from the credentials table.
  4. Enable the payment channels you want to accept.
  5. Select Save.
  6. Select Test to verify.

Toggle interactions

Card-on-file (stored accounts) Automatic card updater (PASS) Behaviour
Off Off One-off card payments only.
On Off Cards stored, but expired cards are not auto-updated β€” declines require a manual card re-entry.
Off On Invalid β€” PASS only operates on stored cards. Effectively same as both Off.
On On Recommended for membership businesses. See Update card details automatically for the end-to-end behaviour.

Process a payment

Terminal (POS):

  1. Staff selects Element/Express on the invoice.
  2. Guest taps / inserts / swipes on the attached card reader.
  3. The card reader returns approval / decline to Zenoti; invoice closes on approval.

Card-on-file:

  1. Staff selects a stored card for the guest.
  2. Zenoti charges via the Worldpay vault token; no card re-entry needed.

Process a refund

  1. Open the invoice, select the Worldpay transaction, choose Refund.
  2. Full or partial depending on your workflow.

Refund β€” dual-system perspective

System What happens
Zenoti Negative payment line; Collections report shows the refund row.
Worldpay Separate refund record in the Worldpay portal, linked to the original transaction. Match key: Worldpay transaction ID or Zenoti invoice number.

Process a void

Voids cancel an authorised but unsettled charge. 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
Worldpay API unreachable Terminal or online flow fails with communication error. Check HTTPS path and Worldpay status page.
Authentication / bad Account token Every transaction fails with auth error. Re-verify Account ID, Account token, Acceptor ID with Worldpay.
Card declined Terminal or HPP (Hosted Payment Page) shows issuer decline. Guest retries.
Amount out of range Worldpay rejects per MID limits. Contact Worldpay for per-MCC limits.
Currency mismatch Transaction rejected. Confirm center currency matches the MID's activated currency.
Settlement failure Transaction approved but missing from daily batch. Raise with Worldpay using the transaction ID.
PASS Updater timeout (15 days) Stored card not auto-updated; next scheduled charge declines. See Update card details automatically. No automatic guest / FDO notification.

Settlement and reconciliation

Worldpay settlement is typically T+1 in the US (funding to merchant bank), excluding weekends and US federal holidays. [SOURCE GAP β€” PM VERIFY: non-US markets.]

Source Report / view Match key
Zenoti Collections report (filter: Payment Method = Element/Express) Worldpay transaction ID + Zenoti invoice number
Worldpay Worldpay merchant portal daily batch report Same fields

Recommended cadence: daily.

Automatic card updating

Element/Express supports automatic card updating through the PASS Updater service. When a stored-card transaction is declined because the card has expired or been reissued, Zenoti can request updated card details from Worldpay. Updated details are saved permanently to the guest's stored payment account. This applies to Visa, Mastercard, and Discover. Amex is explicitly excluded. There is no automatic guest or FDO notification when a card is auto-updated or when the update fails. See Update card details automatically for the full behaviour, including the 15-day failure timeout.

Tips

  • Ensure the Acceptor ID matches your physical terminal configuration provided by Worldpay.
  • Contact your Worldpay account representative if you encounter credential validation errors.
  • Rotating the Account token on the Worldpay side invalidates Zenoti's copy β€” update it in Zenoti immediately.
Was this article helpful?
Your feedback helps us improve our documentation.