Processor: Element express (worldpay)
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)
- At the center level, navigate to Configuration > Payments > Settings (the center-scope caption of the Payments row).
- Select Element/Express (Worldpay) as the payment processor.
- Enter the credentials from the credentials table.
- Enable the payment channels you want to accept.
- Select Save.
- 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):
- Staff selects Element/Express on the invoice.
- Guest taps / inserts / swipes on the attached card reader.
- The card reader returns approval / decline to Zenoti; invoice closes on approval.
Card-on-file:
- Staff selects a stored card for the guest.
- Zenoti charges via the Worldpay vault token; no card re-entry needed.
Process a refund
- Open the invoice, select the Worldpay transaction, choose Refund.
- 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.