WHMCS Wero (PPRO) – Zahlungsmodul

Kurzbeschreibung
Wero Payment Gateway. Einfacher bezahlen lassen. Überall.
Erreichen Sie über 80 % der Verbraucher in Frankreich, Deutschland und Belgien – direkt aus WHMCS.
Autor: Enrico Fischer · Website: Hallo-Webseite.de

Warum Wero?

• Reichweite & Conversion: Direkte Konto-zu-Konto-Zahlungen (A2A) – besonders stark in DE/FR/BE.

• Kostenkontrolle: Keine Kartenschemes, dadurch oft bessere Kostenstruktur.

• Schnelle Abwicklung: Autorisierung in Echtzeit, klare Statussignale.

• Nahtlos in WHMCS: End-to-End-Flow inklusive Redirect, Webhooks, Verbuchung und Refund.

Key Features

• Währungen & Länder

  • EUR-Only (hart erzwungen)

  • Country-Gating: Standard-Whitelist DE, FR, BE (konfigurierbar)

• Checkout & Redirect

  • Erstellung einer Payment-Charge (PPRO Global API)

  • Redirect-Auth zu Wero, automatische Rückleitung zur Rechnung

• Status & Verbuchung

  • Webhooks (CloudEvents) mit Signaturprüfung

  • Verbuchung bei AUTHORIZATION_SUCCEEDED / CAPTURED (idempotent)

• Refunds

  • Voll- und Teil-Erstattungen direkt aus WHMCS (mehrfach möglich)

• Admin-Konsole

  • Dashboard: KPIs, Top-Länder, letzte Transaktionen

  • Logs: Letzte Module-Logs für gezieltes Debugging

  • Hilfe: Onboarding/Go-Live-Leitfaden

  • Branding: Logo & Footer „© Enrico Fischer – Hallo-Webseite.de“

• Developer-Ergonomie

  • Sauberes Mapping ChargeID ↔ InvoiceID, modulare HTTP-Wrapper, Debug-Log

Technische Spezifikation (Kurz)

• API: PPRO Global API (/v1/payment-charges, /refunds)

• Auth: Bearer API Key (optional Merchant-Id Header)

• Webhook-Security: Signatur sha256(payload + "." + secret)

• DB: Tabelle mod_wero_ppro_tx (Charge, Invoice, Amount, Country)

• Kompatibilität: WHMCS 8.x, PHP 7.4–8.2, cURL, OpenSSL/TLS 1.2+

Zahlungs-Flow (End-to-End)

1. Invoice (EUR) → Kunde wählt Wero (Country-Check greift).

2. Modul erstellt Payment-Charge → erhält Redirect-URL → Auto-Weiterleitung.

3. Kunde autorisiert in der Wero-Journey.

4. Return zurück zu WHMCS; Webhook bestätigt finalen Status.

5. Modul verbucht die Rechnung automatisch; Rückerstattungen via WHMCS-Admin.

Installation & Setup (Kurzleitfaden)

1. Modul in WHMCS einspielen und aktivieren.

2. Gateway konfigurieren:

   • Environment: Sandbox/Production

   • API Key (Bearer), optional Merchant-Id

   • Allowed Countries: z. B. DE,FR,BE

   • EUR-Only: aktiv

   • Webhook Signing Secret

3. Admin-Addon aktivieren (Addons → Wero (PPRO) Admin).

4. Webhook/Return: Callback-URL ist im Paket enthalten; Webhook-Signatur testen.

5. Sandbox-Testcases: Erfolg, Abbruch, Refund.

Betrieb, Monitoring & Go-Live

• Go-Live-Checklist

  • Live-Host & Live-Key setzen, Allowed Countries bestätigen

  • Webhook im Prod-Account hinterlegen, Signatur validieren

  • Erste Live-Transaktionen eng monitoren (Module-Logs + Dashboard)

• Observability

  • Aktivierbares Debug-Logging (Request/Response ohne Secrets)

  • KPIs & Transaktionsliste im Admin-Addon

• Sicherheit

  • TLS end-to-end; Bearer-Keys serverseitig; strikte Webhook-Signatur

  • Idempotente Buchungen verhindern Doppelgutschriften

Einschränkungen & Hinweise

• Nur EUR – andere Währungen werden im Checkout abgelehnt.

• Konsumentenländer standardmäßig DE/FR/BE – außerhalb der Whitelist wird Wero ausgeblendet.

• Capture-Logik: Wero arbeitet ohne separate Captures; maßgeblich sind die o. g. Erfolgsstatus.

Hilfe – Freischaltung bei PPRO/Wero

1. PPRO kontaktieren (Partner/Merchant-Support), Wero für DE/FR/BE anfragen.

2. KYC/Onboarding abschließen; Merchant wird provisioniert.

3. Sandbox-API-Key & Webhook-Secret erhalten; im Gateway eintragen.

4. Tests fahren (Erfolg/Abbruch/Refund); danach Go-Live-Request stellen.

5. Prod-Keys/Host setzen, Webhook aktivieren, Monitoring an.

FAQ

• Unterstützte Länder? Standard: DE, FR, BE (konfigurierbar).

• Unterstützte Währung? EUR.

• Wie werden Zahlungen verbucht? Webhook/Return prüfen Status und verbuchen bei AUTHORIZATION_SUCCEEDED/CAPTURED.

• Refunds? Voll/Teil möglich; direkt aus WHMCS.

• Wie sehe ich Fehler? Addons → Wero (PPRO) Admin → Logs.