Skip to content

Worldline Saferpay

Worldline Saferpay is the in-store / card-present payment integration. When a guest pays at reception or at the campground shop, the cashier picks the WORLDLINE method in /kasse, the amount is pushed to the paired terminal, and the customer just taps. No more typing the amount on the terminal by hand.

This is separate from Stripe: Stripe handles online payments (web checkout, the booking widget, Apple Pay / TWINT in the browser). Worldline handles the physical card terminal at the desk.

  • One-tap payments from the cash register
  • Refunds and partial reversals from the booking detail
  • Automatic status polling, so a hung transaction recovers cleanly after the network comes back
  • An audit log of every terminal interaction (paired, payment opened, status checked, refunded) — visible on the settings card
  • A signed Saferpay agreement with Worldline (commercial side — talk to Worldline sales).
  • A paired hardware terminal at the desk.
  • Saferpay JSON API credentials (you generate these yourself in the Saferpay Backoffice).

If you don’t yet have a Saferpay account, you can self-register a sandbox at https://test.saferpay.com/BO/SignUp?lang=en for testing before signing the production contract.

Open Settings → Integrations → Vendor Adapters → Worldline Saferpay and fill:

FieldWhere to find it
EnvironmentTest for the sandbox, Production for live
Customer IDTop-right of the Saferpay Backoffice header (6 digits)
Terminal IDSaferpay Backoffice → Settings → Terminals (8 digits)
API usernameSaferpay Backoffice → Settings → JSON API → Basic Authentication — click Add new
API passwordSame place — Saferpay shows the password once, copy it now

Tick Enabled, click Save, then Test connection. A green pill confirms the terminal is paired.

  1. Cashier picks Worldline in /kasse and confirms the amount.
  2. CampOne calls Saferpay’s terminal API; the amount appears on the physical terminal.
  3. Customer taps / inserts card and enters PIN if asked.
  4. Terminal returns approval; CampOne marks the POS transaction as paid.
  5. The transaction handle is stored on the booking for refunds later.

If the customer takes too long, the cashier can Cancel from CampOne — this releases the terminal.

From the booking’s payment panel, click Refund. The refund goes back to the same card the customer used (this is a Saferpay rule — refunds always trace the original payment). You can refund partially.

  • Worldline charges a per-transaction fee. Stripe might be cheaper for low-value online charges; Worldline is for in-person.
  • The terminal pairing is per-tenant. If you have multiple desks, you’ll have multiple terminals — each with its own terminal_id. (Multi-terminal support per tenant is on the roadmap.)
  • Reversals only work for the original transaction’s same business day. After that, use a Refund.