Mit CashCtrl verbinden

Damit das Plugin CashCtrl Gateway for WooCommerce auf CashCtrl zugreifen kann und die Aufträge gemäss der Konfiguration verbuchen kann, müssen in CashCtrl zwei Voraussetzungen erfüllt sein.
Zum einen muss in CashCtrl ein sogenannter API-Benutzer mit den entsprechenden Berechtigungen erstellt werden. Und zum anderen muss für die Überprüfung der CashCtrl-Verbindung ein Hauptsitz eingerichtet werden.

Vorarbeiten in CashCtrl

CashCtrl API-Benutzer einrichten

Wie einen API-Benutzer erstellt werden kann, ist in diesem CashCtrl Tutorial beschrieben.

Berechtigungen sollten nach dem Motto «so wenig wie möglich, soviel wie nötig» vergeben werden. Aus diesem Grund sollte in CashCtrl unter Benutzer & Rollen » Rollen eine separate Rolle für den API-Benutzer angelegt werden. Aus Sicherheitsgründen empfehlen wir zudem für jeden Service einen separaten API-Benutzer zu erstellen, zumal zusätzliche Benutzer bei CashCtrl sehr kostengünstig erworben werden können.

Das Plugin CashCtrl Gateway for WooCommerce benötigt dabei mindestens folgende Rechte.

CashCtrl Hauptsitz einrichten

Damit CashCtrl Gateway for WooCommerce die Verbindung zur Onlinebuchhaltung überprüfen kann und im Fall eines Verbindungsfehlers informieren kann, prüft das Plugin den Lesezugriff auf den Hauptsitz.

Die Einrichtung eines neuen Hauptsitz wird im CashCtrl Tutorial im Detail beschrieben. Für die erfolgreiche Verbindungsprüfung muss mindestens einen Hauptsitz existieren.

Verbindungseinstellungen

CashCtrl API-Key

Geben Sie hier den zuvor in CashCtrl erstellte API-Key ein. Dieser ist 32 Zeichen lang und besteht aus Zahlen und Buchstaben.

CashCtrl Organisation

Die CashCtrl Organisation entspricht der dem ersten Teil der URL mit welcher Sie sich bei CashCtrl anmelden (Beispiel https://demokunde.cashctrl.com/ ). Einfachheitshalber kann hier auch die ganze URL eingegeben werden.

CashCtrl Hauptsitz

Ist die Verbindung mit dem CashCtrl Mandanten erfolgreich, wird hier der oben erstellte Hauptsitz angezeigt.

WordPress Zeitzone und Zeit

Zeigt die aktuelle Zeitzone und Serverzeit an. Für eine zeitlich korrekte Verbuchung der Bestellungen in CashCtrl, sollte diese der aktuellen Zeitzone entsprechen.
Stellen Sie die Zeitzone in WordPress unter «Einstellungen > Allgemein» ein.

Fehlercodes und deren Bedeutung

Bei der Kommunikation zwischen der CashCtrl Gateway for WooCommerce und der CashCtrl-API können verschiedene Fehlercodes auftreten. Solche Fehler werden durch das Plugin als WordPress Admin-Mitteilung angezeigt.

Nachfolgend finden Sie eine Übersicht mit den gängigsten Fehler-Codes und möglichen Ursachen:

Fehler-Code	Ursachen	Mögliche Massnahmen
401 Unauthorized	CashCtrl hat die Anfrage zurückgewiesen, da keine oder ungültige Zugangsdaten übermittelt wurden.	Der CashCtrl API-Key und/oder Organisation ist falsch. Überprüfen Sie im Reiter «CashCtrl» den hinterlegten API-Key und Organisation.
403 Forbidden	Die Verbindung zu CashCtrl wurde aufgebaut, jedoch verweigert der Server den Zugriff.	Der API-Benutzer in CashCtrl verfügt möglicherweise nicht über die erforderlichen Berechtigungen oder die API ist serverseitig gesperrt. Prüfen Sie die CashCtrl-Benutzerrollen für den Benutzer.
500 Internal Server Error	CashCtrl hat einen internen Fehler gemeldet.	Die CashCtrl-API konnte die Anfrage nicht korrekt verarbeiten. Versuchen Sie es später erneut. Falls das Problem dauerhaft auftritt, kontaktieren Sie den CashCtrl-Support.
602 Bad Gateway (DNS/Host Error)	Der CashCtrl-Server konnte nicht gefunden oder aufgelöst werden.	Die Domain ORGANISATION.cashctrl.com konnte durch das Plugin nicht aufgelöst werden. Überprüfen Sie im Reiter «CashCtrl» die hinterlegte Organisation. Falls das Problem dauerhaft auftritt, kontaktieren Sie den CashCtrl-Support.
603 Service Unavailable (Connect Fail)	CashCtrl Gateway konnte keine Verbindung zum CashCtrl Server herstellen.	Der Server von CashCtrl antwortet nicht oder etwas blockiert den Verbindungsaufbau auf Port 443 zum CashCtrl Server. Prüfen Sie ob die Verbindung via Browser möglich ist. Falls das Problem dauerhaft auftritt, kontaktieren Sie den CashCtrl-Support.
604 Gateway Timeout (Operation Timed Out)	Die Verbindung zu CashCtrl konnte nicht innerhalb des gesetzten Zeitlimits hergestellt oder abgeschlossen werden.	CashCtrl antwortet zu langsam oder es besteht eine instabile Netzwerkverbindung. Versuchen Sie es später erneut. Falls das Problem dauerhaft auftritt, kontaktieren Sie den CashCtrl-Support.
620 Upstream Connection Error	Das CashCtrl Gateway konnte keine stabile Verbindung zur CashCtrl-API aufbauen. Es wurde keine gültige HTTP-Antwort empfangen.	Es existieret ein Netzwerk- oder Transportfehler zwischen CashCtrl Gateway und dem CashCtrl Server. Versuchen Sie es später erneut. Falls das Problem dauerhaft auftritt, kontaktieren Sie den CashCtrl-Support.
625 SSL Connect Error (Handshake Failed)	Der SSL-Handshake mit CashCtrl konnte nicht abgeschlossen werden.	Eine veraltete TLS-Version, Proxy-Störung oder zwischengeschaltete Sicherheitslösung welche die SSL-Verbindungen beeinflussen. Prüfen Sie ob die Verbindung via Browser möglich ist. Falls das Problem dauerhaft auftritt, kontaktieren Sie den CashCtrl-Support und/oder Ihren Web-Hosting Anbieter.
626 SSL Certificate Problem (CA/Chain Invalid)	Das SSL-Zertifikat vom CashCtrl Server konnte nicht verifiziert werden.	Die lokale Zertifikatskette (CA-Store) ist unvollständig oder veraltet. Stellen Sie sicher, dass die Stammzertifikate auf dem Webserver aktuell sind und ob keine Systeme (wie z.B. Proxy oder WAF) zwischen dem Web- und CashCtrl-Server die SSL-Verbindung beeinflusst (Man in the middle). Prüfen Sie ob die Verbindung via Browser möglich ist. Falls das Problem dauerhaft auftritt, kontaktieren Sie den CashCtrl-Support und/oder Ihren Web-Hosting Anbieter.

Weiterführende HTTP-Status-Codes sind hier dokumentiert.

Technik und Installationen sind nicht Ihr Ding?

Sie trauen sich die Installation von CashCtrl Gateway for WooCommerce nicht selbst zu oder haben einfach keine Zeit dafür? Wir unterstützen Sie gerne dabei.

Sie haben heute eine Agentur für die Betreuung Ihres Onlineshops beauftragt? Kein Problem! Wir nehmen mit Ihrer Agentur gerne Kontakt auf, um CashCtrl Gateway for WooCommerce zu installieren und initial zu konfigurieren.

Unabhängig, ob Sie Ihren Webshop selbst oder durch eine Agentur betreuen lassen. Wir kümmern uns gerne um die Installation von CashCtrl Gateway for WooCommerce und Integration in CashCtrl und bieten flexible Modelle für die Bedürfnisorientiere Integration an.