Zahlungsprovider

Wo finde ich die Zahlungsprovider-Verwaltung?

Sie finden die Administration unter:

Einstellungen → System → Zahlungsprovider

Wozu gibt es Zahlungsprovider?

Mit Zahlungsprovidern steuern Sie, wie Zahlungen für kostenpflichtige Reservationen abgewickelt werden – z.B. über eine externe Zahlungsseite (Kreditkarte/Wallet) oder über Rechnung.

Typische Einsatzfälle:

• Sie möchten Reservationen direkt online bezahlen lassen (z.B. Saferpay).
• Sie möchten Reservationen freigeben und später per Rechnung abrechnen (ohne externe Zahlungsabwicklung).

Welche Zahlungsprovider werden unterstützt?

• Saferpay: Externe Zahlungsabwicklung über Worldline/SIX (z.B. Kreditkarten, Wallets – je nach Vertrag).
• Rechnung: Keine externe Zahlungsabwicklung; die Reservation wird bestätigt und die Rechnung wird später gestellt/versendet (gemäss Ihrem Prozess).

Zahlungsprovider anlegen oder bearbeiten

1. Öffnen Sie Einstellungen → System → Zahlungsprovider.
2. Klicken Sie auf Neu (oder öffnen Sie einen bestehenden Eintrag).
3. Pflegen Sie die Felder (siehe unten).
4. Klicken Sie Speichern.

Felder

Stammdaten

• Name: Eindeutige Bezeichnung des Providers (z.B. „Saferpay“ oder „Rechnung“).
  • Verwenden Sie einen klaren, stabilen Namen, damit im Betrieb keine Verwechslungen entstehen.
  • Falls der Provider im Buchungsprozess «per Name» referenziert wird, muss dieser Name exakt passen (Gross-/Kleinschreibung beachten).
• URL (nur Saferpay): Basis-URL des Saferpay-Systems (Test oder Produktion).
• Benutzername / Passwort (nur Saferpay): Zugangsdaten, die Sie von Saferpay erhalten.
• Konfiguration (nur Saferpay): Saferpay-spezifische Optionen im JSON-Format.

Saferpay einrichten

Für Saferpay benötigen Sie typischerweise URL, Benutzername, Passwort und eine Konfiguration.

Konfiguration (JSON)

Die Konfiguration ist ein JSON-Objekt. Üblich sind diese Schlüssel:

Häufige Werte

Payment Methods (häufig):

• VISA
• MASTERCARD
• AMEX
• DINERS
• MAESTRO
• VPAY
• POSTFINANCECARD

Wallets (häufig):

• PAYPAL
• TWINT
• APPLEPAY
• GOOGLEPAY

Beispiel-Konfigurationen

1) Minimal (nur Identifikation; Zahlungsmittel kommen aus dem Vertrag/Standard)

{
  "customerId": "255759",
  "terminalId": "17729265"
}

2) Karten + Wallets explizit festlegen

{
  "customerId": "255759",
  "terminalId": "17729265",
  "paymentMethods": ["VISA", "MASTERCARD", "AMEX"],
  "wallets": ["PAYPAL", "TWINT"]
}

3) Nur Karten erlauben (keine Wallets)

{
  "customerId": "255759",
  "terminalId": "17729265",
  "paymentMethods": ["VISA", "MASTERCARD"]
}

4) Nur Wallets anbieten (z.B. TWINT + PayPal)

{
  "customerId": "255759",
  "terminalId": "17729265",
  "wallets": ["TWINT", "PAYPAL"]
}

Beispielwerte für URL

• Produktion (Beispiel): https://www.saferpay.com/api/
• Test (Beispiel): https://test.saferpay.com/api/

Rechnung einrichten

Für Rechnung genügt in der Regel:

• Name: z.B. „Rechnung“

Die restlichen Felder bleiben leer (keine externe Verbindung).

Beispiel (ohne Konfiguration):

{
  "name": "Rechnung"
}

Wie läuft der Zahlungsprozess ab?

Im Alltag läuft es typischerweise so:

1. Eine Reservation wird erstellt (ggf. mit Kosten für Raum/Equipment/Catering).
2. Beim Auslösen der Zahlung wird die Zahlung vorbereitet.
3. Je nach Provider:
   • Saferpay: Weiterleitung zur Zahlungsseite und anschliessend Rückkehr in 3V-ROOMS.
   • Rechnung: Keine Weiterleitung; die Reservation wird bestätigt und anschliessend gemäss Ihrem Prozess abgerechnet.

Statusmodell

%%{init: {
  'theme': 'neutral',
  'themeVariables': {
    'primaryColor': '#EEF2FF',
    'primaryBorderColor': '#4F46E5',
    'primaryTextColor': '#111827',
    'secondaryColor': '#F8FAFC',
    'tertiaryColor': '#FFFFFF',
    'lineColor': '#6B7280',
    'fontFamily': 'Inter, ui-sans-serif, system-ui, Segoe UI, Roboto, Helvetica, Arial'
  }
}}%%
stateDiagram-v2
  [*] --> Offen: Zahlung erstellt
  Offen --> Bestaetigt: Zahlung bestätigt
  Offen --> Abgebrochen: abgebrochen/fehlgeschlagen
  Bestaetigt --> Abgeschlossen: abgeschlossen/verbucht
  Bestaetigt --> Rueckerstattung: Rückerstattung angestossen
  Rueckerstattung --> Abgebrochen: rückerstattet/storniert

Ablauf mit Saferpay

%%{init: {
  'theme': 'neutral',
  'themeVariables': {
    'primaryColor': '#EEF2FF',
    'primaryBorderColor': '#4F46E5',
    'primaryTextColor': '#111827',
    'secondaryColor': '#F8FAFC',
    'tertiaryColor': '#FFFFFF',
    'lineColor': '#6B7280',
    'fontFamily': 'Inter, ui-sans-serif, system-ui, Segoe UI, Roboto, Helvetica, Arial'
  }
}}%%
sequenceDiagram
  participant U as Benutzer
  participant R as 3V-ROOMS
  participant S as Saferpay

  U->>R: Reservation abschliessen / Zahlung auslösen
  R->>R: Zahlung vorbereiten
  R->>S: Zahlungsprozess initialisieren
  S-->>R: Weiterleitungs-URL
  R-->>U: Weiterleitung zur Saferpay-Zahlungsseite
  U->>S: Zahlungsdaten erfassen und bestätigen
  S-->>U: Weiterleitung zurück zu 3V-ROOMS
  U->>R: Rückkehr nach erfolgreicher Zahlung
  R->>R: Zahlung aktualisieren und Reservation bestätigen

Ablauf mit Rechnung

%%{init: {
  'theme': 'neutral',
  'themeVariables': {
    'primaryColor': '#EEF2FF',
    'primaryBorderColor': '#4F46E5',
    'primaryTextColor': '#111827',
    'secondaryColor': '#F8FAFC',
    'tertiaryColor': '#FFFFFF',
    'lineColor': '#6B7280',
    'fontFamily': 'Inter, ui-sans-serif, system-ui, Segoe UI, Roboto, Helvetica, Arial'
  }
}}%%
sequenceDiagram
  participant U as Benutzer
  participant R as 3V-ROOMS

  U->>R: Reservation abschliessen / Zahlung auslösen
  R->>R: Zahlung vorbereiten (Rechnung)
  R-->>U: Reservation bestätigt (Rechnung gemäss Prozess)

Löschen

Sie können Zahlungsprovider löschen. Prüfen Sie vorher, ob der Provider noch für laufende Prozesse benötigt wird.

Häufige Probleme

• Zahlungsart/Provider steht nicht zur Verfügung: Prüfen Sie, ob der Zahlungsprovider korrekt angelegt und vollständig gepflegt ist.
• Saferpay-Verbindung klappt nicht: URL (Test/Produktion) sowie Benutzername/Passwort prüfen; bei Bedarf Saferpay-Zugang testen lassen.
• Bestimmte Zahlungsmittel fehlen: Konfiguration (z.B. paymentMethods/wallets) sowie Saferpay-Vertrag prüfen.