Beispiele für Anwendungsfälle
Digitale Rechnungsseiten mit Twikey verbessern
In vielen Abrechnungsabläufen wird höchstwahrscheinlich bereits innerhalb eines bestehenden Rechnungsrahmens gearbeitet. Dies kann eine bestehende Rechnungsdetailseite, ein Kundenportal oder eine ERP-gesteuerte Abrechnungserfahrung umfassen, mit der Kunden bereits vertraut sind. In solchen Szenarien führt die Einführung einer separaten, vollständigen Zahlungsseite allein zur Unterstützung zusätzlicher Zahlungsmethoden oft zu unnötigerer Komplexität, sowohl technisch als auch hinsichtlich der Benutzererfahrung.
Twikey ist so konzipiert, dass es sich nahtlos in diese bestehenden Abläufe integriert. Anstatt einen vollständigen Ersatz der aktuellen Rechnungs-Landingpage zu erzwingen, ermöglicht Twikey die Einbettung und Orchestrierung einzelner Zahlungsfunktionen nach Bedarf. Dadurch ist es möglich, die aktuelle Rechnungserfahrung um automatische Zahlungen (wie Lastschriften oder wiederkehrende Kartenzahlungen) sowie Einmalzahlungen zu erweitern, während der Kunde so weit wie möglich in der eigenen Oberfläche bleibt.
Die folgenden Abschnitte beschreiben einen gängigen Anwendungsfall, bei dem ein Kunde eine Rechnung erhält, eine bestehende Rechnungsseite aufruft und die Möglichkeit erhält, automatische Zahlungen mit Twikey zu aktivieren oder eine Einmalzahlung durchzuführen. Die Sequenzdiagramme zeigen, wie diese Interaktion auf API-Ebene abgebildet wird.
Die automatische Zahlung
Wenn ein Kunde entscheidet, automatische Zahlungen zu aktivieren, sei es per Lastschrift oder wiederkehrender Kreditkarte, muss eine neue Vereinbarung in Twikey erstellt werden. Die Erstellungsanfrage für diese Vereinbarung generiert eine Signatur-URL, zu der der Kunde von der Rechnungsseite oder dem Kundenportal weitergeleitet werden kann. Der Kunde durchläuft den Signierungsprozess über die gehosteten Signierungsmechanismen von Twikey, die auf die gewählte Zahlungsmethode zugeschnitten sind und den geltenden Zahlungsschema- und regulatorischen Anforderungen entsprechen.
Nach Abschluss des Signierungsablaufs leitet Twikey den Kunden zurück zu einer Return-URL, die das Ergebnis der Signatur widerspiegelt. Dadurch kann der Kunde auf eine Bestätigungsseite, die ursprüngliche Rechnungsansicht oder eine allgemeine Kontoübersicht zurückgeführt werden. Ein Webhook benachrichtigt das System, wenn die Signierung abgeschlossen ist, sodass der Rechnungsstatus entsprechend aktualisiert werden kann.
Sobald eine Vereinbarung erfolgreich signiert wurde, kann sie zur Einziehung aller ausstehenden oder zukünftigen Rechnungen für diesen Kunden verwendet werden. Das eigene System behält die Kontrolle darüber, welche Rechnungen für die Einziehung geeignet sind und wann sie eingezogen werden sollen. Alles, was für die Einleitung der Einziehung benötigt wird, ist die Vereinbarungs-ID, der Betrag und die Nachricht an den Kunden.
Falls eine Zahlung fehlschlägt oder abgelehnt wird, setzt Twikey den Einziehungsprozess automatisch gemäß dem konfigurierten Mahnschema fort, das im Twikey-Dashboard konfiguriert werden kann. Während dieses Prozesses wird der aktuelle Stand der Transaktion über den Transaktions-Feed bereitgestellt, sodass die Systeme synchron bleiben können.
Die Einmalzahlung
Neben automatischen Zahlungen können auch sofortige Einmalzahlungen unterstützt werden, indem ein Zahlungslink über Twikey generiert wird. Dadurch können Kunden eine Rechnung direkt begleichen, ohne eine Vereinbarung zu erstellen, während die Integration vom zugrunde liegenden PSP entkoppelt bleibt und PSP-Wechsel ohne Auswirkungen auf die API oder den Geschäftsablauf möglich sind.
Aus Implementierungssicht fordert das System einen Zahlungslink über die Twikey-API an und leitet den Kunden zur gehosteten Zahlungsseite weiter. Sobald die Zahlung abgeschlossen, storniert oder fehlgeschlagen ist, leitet Twikey den Kunden zurück zu einer Return-URL, die steuerbar ist - beispielsweise eine Bestätigungsseite, die ursprüngliche Rechnungsansicht oder eine allgemeine Kontoübersicht - basierend auf dem Ergebnis. Ein Webhook benachrichtigt das System über das Zahlungsergebnis, sodass der Rechnungsstatus in Echtzeit aktualisiert werden kann.
Vollständiges Sequenzdiagramm anzeigen
Weitere Anwendungsfälle
Weitere Anwendungsfälle sind in Vorbereitung. In der Zwischenzeit deckt die API-Referenz alle verfügbaren Endpoints ab, und die Anleitungen erläutern jeden Produktbereich im Detail.