Tocco

In diesem Artikel erfährst Du, wie Du die Zahlungslösung von Payrexx ins Schweizer ERP-System Tocco integrieren kannst, um Zahlungen zu empfangen.

Allgemein

Tocco ist eine cloudbasierte, modulare ERP-Lösung aus der Schweiz, die speziell auf die Bedürfnisse von Bildungseinrichtungen, Verbänden, Fundraising-Organisationen und Non-Profit-Organisationen zugeschnitten ist.

Die Software beinhaltet unter anderem CRM-Funktionen, Veranstaltungs- und Kursmanagement, Ressourcenplanung, Rechnungsstellung und Dokumentenverwaltung.

Durch die Integration von Payrexx können sich Nutzer bei Tocco für eine Veranstaltung registrieren und direkt über die Zahlungslösung von Payrexx bezahlen.

Links

• Webseite von Tocco

Funktionen

• Anmeldung für Veranstaltungen

• Bezahlung der Gebühren für Veranstaltungen

Integration

In den nächsten Kapiteln erfährst Du, wie Du die Zahlungslösung von Payrexx in Tocco integrierst.

Konfiguration von Payrexx

Bitte beachte, dass Du bei Payrexx eingeloggt sein musst, bevor Du beginnst. Falls Du noch kein Konto hast, registriere Dich bitte bei Payrexx.

Erstellen eines API-Schlüssels

• Navigiere im Hauptmenü Deiner Händler-Administration zu API und Integrationen.

• Scrolle hinunter zu "API-Integration hinzufügen" und klicke auf "API-Schlüssel hinzufügen":

Hinzufügen eines API-Schlüssels in Payrexx

• Gib der Integration einen beliebigen Namen, zum Beispiel "Tocco".

• Klicke auf die Schaltfläche "Hinzufügen", um den API-Schlüssel zu erstellen:

Erstellen eines API-Schlüssels in Payrexx

• Kopiere den API-Schlüssel in die Zwischenablage. Du benötigst ihn später bei der Konfiguration von Tocco:

Kopieren des API-Schlüssels in die Zwischenablage

Konfiguration von Tocco

Erstellen des Payrexx-Datensatzes

• Logge Dich in Dein Konto bei Tocco ein.

• Öffne das Datenobjekt "Payrexx-Konto":

Öffnen des Datenobjekts "Payrexx-Konto" in Tocco

• Erstelle einen neuen Datensatz und konfiguriere ihn wie folgt:

  • Kürzel: Wähle ein beliebiges Kürzel.

  • Bezeichnung: Wähle eine beliebige Bezeichnung für die Anzeige im System und erfasse sie in den verschiedenen Sprachen.

  • Sortierung: Lege die Sortierung für die Anzeige im System fest.

  • Konto: Wähle das buchhalterische Konto, das bei den Zahlungseingangs-Belegen dieses Payrexx-Kontos als Sollkonto verwendet werden soll.

  • Standard: Wenn Du die Checkbox aktivierst, wird das Payrexx-Konto als Standard-Konto markiert. Dieses wird dann verwendet, wenn in den E-Payment-Einstellungen kein anderes Konto konfiguriert ist.

Konfiguration des Datensatzes in Tocco

• Klicke auf "Erstellen", um das Payrexx-Konto anzulegen.

Herstellen der Verbindung zu Payrexx

• Wähle die Aktion "Payrexx-Logindaten setzen".

• Erfasse den Instanznamen Deines Payrexx-Kontos im Feld "Payrexx-Instanz". Der Instanzname entspricht dem ersten Teil Deiner Payrexx-URL. Wenn die URL beispiel.payrexx.com ist, so lautet der Instanzname beispiel.

• Füge den zuvor in die Zwischenablage kopierten API-Schlüssel ins Feld "API-Key" ein:

Eingabe von Instanznamen und API-Schlüssel in Tocco

Es wird geprüft, ob die eingegebenen Daten korrekt sind. Falls ja, wird die Verbindung aktiviert. Falls nein, wird eine Fehlermeldung angezeigt.

• Wähle in der Liste das gewünschte Konto aus (Mehrfachauswahl möglich) und klicke auf "Zahlungsarten importieren".

Wenn in Payrexx neue Zahlungsarten dazukommen, kannst Du sie erneut importieren. Die Aktion löscht allerdings keine bestehenden Daten. Stehen Zahlungsarten in Payrexx nicht mehr zur Verfügung, musst Du sie in Tocco manuell deaktivieren oder löschen.

Kopieren der Webhook-URL

Damit die Zahlungseingänge von Payrexx an Tocco übermittelt werden können, muss ein Webhook eingerichtet werden:

• Kopiere hierfür im Datensatz "Payrexx-Konto" den Wert des Feldes "Webhook-URL" in die Zwischenablage.

Konfiguration von Payrexx

Melde Dich nun wieder in Deinem Payrexx-Konto an, um den Webhook zu erstellen.

Erstellen des Webhooks

• Navigiere im Hauptmenü Deines Payrexx-Kontos zu Webhooks.

• Klicke auf "Webhook hinzufügen".

• Konfiguriere den Webhook anhand der folgenden Einstellungen:

Konfiguration des Webhooks in Payrexx

1. Name: Vergib einen Namen für den Webhook, zum Beispiel "Tocco" (optional).

2. Webhook URL: Füge die URL des Webhooks ein, die Du zuvor in Tocco in die Zwischenablage kopiert hast.

3. Ereignisse: Aktiviere die Checkbox bei "Transaction".

4. Webhook Inhaltstyp: Wähle die Option "JSON" aus.

5. Webhook-Version: Wähle 2023-11-14 oder ein aktuelleres Datum.

Klicke auf "Hinzufügen", um den Webhook zu erstellen.

Die Integration von Payrexx in Tocco ist abgeschlossen.