Qonto-Lastschrift
Mit Qonto-Lastschrift kannst Du SEPA-Lastschrift als Zahlungsmethode über Dein Qonto-Konto anbieten. Nach dem Verbinden von Qonto und dem Registrieren von Webhooks kann Hostware Zahlungen automatisch von den Bankkonten Deiner Kundinnen und Kunden einziehen.
Registriere Deine App in Qonto
Bevor Du Qonto in Hostware verbindest, musst Du im Qonto-Entwicklerportal eine App registrieren.
Melde Dich mit Deinem Qonto-Konto auf developers.qonto.com an.
Stelle oben rechts sicher, dass Production ausgewählt ist.
Gehe zu Settings und erstelle eine neue App.
Füge eine Umleitungs-URL hinzu:
https://YOURDOMAIN.COM/admin/modules/hw-qonto/callbackKlicke auf Edit scopes und wähle die folgenden Scopes aus:
offline_access
client.read
client.write
organization.read
sepa_direct_debit.read
sepa_direct_debit.write
webhook
Speichere Deine Änderungen und kopiere die client ID und das client secret.
Wenn die App im Qonto-Entwicklerportal nicht korrekt registriert ist, zeigt die Schaltfläche Qonto verbinden einen allgemeinen Fehler wie „hat nicht funktioniert, kehre zur Seite zurück“ an.
Qonto in Hostware verbinden
Nachdem Du Deine App registriert hast, verbinde Qonto mit Hostware.
Öffne Modules in Deinem Hostware-Adminbereich und suche nach HwQonto.
Klicke auf Einstellungen, um die Modulkonfiguration zu öffnen.
Gib Deine client ID und Dein client secret aus dem Qonto-Entwicklerportal ein.
Klicke auf Qonto verbinden, um die OAuth-Autorisierung zu starten.
Melde Dich bei Qonto an und autorisiere die Verbindung.
Nach der Autorisierung wirst Du mit einer Bestätigungsnachricht zurück zu Hostware weitergeleitet: Qonto-Verbindung wurde erfolgreich hergestellt.
Die Verbindung speichert Deine Organisations-ID und Zugangstokens automatisch. Du kannst die Verbindung jederzeit trennen, indem Du auf Verbindung trennen klickst.
Webhooks registrieren
Webhooks ermöglichen es Qonto, Hostware über SEPA-Lastschrift-Ereignisse zu informieren, zum Beispiel über erfolgreiche Einzüge oder Änderungen an Mandaten.
Klicke in der HwQonto-Modulkonfiguration auf Webhooks registrieren.
Hostware erstellt den Webhook-Endpunkt in Qonto und speichert das Webhook-Geheimnis.
Die Bestätigungsnachricht erscheint: Qonto-Webhooks wurden registriert.
Der Webhook-Status im Modul zeigt, ob die Registrierung erfolgreich war:
Korrekt registriert: Webhook ist aktiv und funktioniert.
Nicht vorhanden oder falsch: Der Webhook existiert nicht oder das Geheimnis stimmt nicht überein. Registriere ihn erneut.
API-Prüfung fehlgeschlagen: Hostware konnte den Webhook über die Qonto-API nicht verifizieren. Überprüfe Deine Verbindung und versuche es erneut.
Qonto trennen
Um die Qonto-Verbindung zu entfernen, klicke in der Modulkonfiguration auf Verbindung trennen. Dadurch werden gespeicherte Tokens, Organisationsdaten und Webhook-Informationen gelöscht. Du kannst Dich später erneut verbinden, indem Du die Autorisierung noch einmal durchführst.
Wie geht es weiter
Nach dem Verbinden von Qonto und dem Registrieren von Webhooks können Deine Kundinnen und Kunden beim Checkout SEPA-Lastschrift auswählen. Wenn Du bestehende Mandate von einem anderen Zahlungsanbieter hast, siehe Migrate mandates to Qonto, um sie zu Deinem Qonto-Setup zu übertragen.
Für eine weitere SEPA-Lastschrift-Option siehe GoCardless.