Unzer

Hinweis: Eine Integration von Unzer ist mit dem Modul Unzer Enterprise möglich. Bevor Sie mit der Einrichtung beginnen, stellen Sie bitte sicher, dass Sie dieses Modul bei Unzer gebucht haben. Eine Integration mit dem gebuchten Modul Unzer Direkt kann derzeit nicht konfiguriert werden.

Bitte beachten Sie:

Bitte beachten Sie, bevor Sie mit der Implementierung von SubscriptionJS auf Ihrer Anmeldeseite beginnen, dass die ProcessPaymentData-Methode von diesem PSP nicht unterstützt wird.

1. Konfiguration Ihres Unzer-Accounts

Sie müssen die folgende Konfiguration in Ihrem Unzer-Konto einstellen:

• In Ihrem Unzer-Konto müssen Sie Benachrichtigungen aktivieren. Geben Sie dazu die folgende URL als Empfängeradresse ein:

  https://app.billwerk.com/PSPWebhooks/UnzerPushNotifications

Sie können diese Einstellungen nicht selbst ändern. Bitte wenden Sie sich an den Unzer-Kundensupport, um die Änderungen zu veranlassen.

2. Konfiguration in Ihrem Frisbii Transform Konto

Sie finden die Unzer-Einstellungen in Frisbii Transform unter "Einstellungen > Zahlungseinstellungen > Unzer".

Hinweis: In den Einstellungen können Sie den Frisbii Transform API-Modus auswählen. Belassen Sie diese Einstellung auf "Unzer". Der Wert "Heidelpay" dient lediglich zur Kompatibilität mit älteren Anbindungen.

3. 3. SEPA-Referenzzeile konfigurieren

Sie können die SEPA-Referenzzeile manuell konfigurieren. Weitere Informationen finden Sie in dem Artikel SEPA-Referenz konfigurieren.

4. Testdaten

Um erfolgreiche Anmeldungen zu erstellen, müssen auch für Testkunden eine E-Mail-Adresse und eine vollständige Rechnungsadresse übergeben werden.

Sie müssen Unzer die folgende URL als Empfangsadresse für Benachrichtigungen für Ihr Testkonto eingeben lassen: https://sandbox.billwerk.com/PSPWebhooks/UnzerPushNotifications

Um Unzer auf der Frisbii Transform-Sandbox zu testen, wählen Sie ''Test'' für Plattform und ''Integrator Test'' für Transaktionsmodus.

Kreditkarte

VISA

MasterCard

Lastschriftverfahren Deutschland

Sollten die Testdaten nicht funktionieren, sehen Sie bitte hier nach: https://docs.unzer.com/reference/test-data/ für aktuelle Testdaten.

5. Besondere Hinweise bei einer technischen Integration

Bei einer Integration von SubscriptionJS oder dem Payment iFrame sind folgende Hinweise zu beachten:

Erfolgsrückrufe / Unzer

Die Unzer-Integration weicht aus technischer Notwendigkeit von der Standardintegration der anderen Zahlungsanbieter ab. Der Frisbii Transform Standard-Workflow sieht zwei verschiedene Fälle für die Bearbeitung von Zahlungsdaten vor. Entweder können die Daten direkt an den Zahlungsanbieter übermittelt werden (1) oder im Order-Workflow müssen diese an den Zahlungsprovider weitergeleitet werden (2), der am Ende wiederum die angegebene providerReturnUrl aufruft.

In Fall (1) ohne Weiterleitung wird z. B. bei paySignupInteractive() der Success-Callback aufgerufen und als Resultat einer erfolgreiche Order die ContractId und Customer Id mitgeteilt. Der Order Workflow ist hier zu Ende.

In Fall (2) mit Weiterleitung wird z. B. bei paySignupInteractive() ebenfalls der Success-Callback aufgerufen, diesmal jedoch mit einer Provider Url, an die der Success-Callback weiterleiten muss. Ruft der Provider danach wiederum die providerReturnUrl auf, wird dort Finalize() aufgerufen, dass im Erfolgsfall dessen Success Callback aufruft und die Contract Id und Customer Id übergibt.

Im Falle von Unzer muss die Kontrolle über die Zahlungsdaten in Frisbii Transform mit einer POST-Anfrage an Unzer übertragen werden. Anschließend wird von Unzer die providerReturnUrl aufgerufen, die Finalize() enthält.

Mit Unzer wird in beiden Fällen zuerst der Finalize Success-Callback aufgerufen, da technisch bedingt immer intern eine Weiterleitung an Unzer stattfinden muss. Im Endeffekt ist es eher der Fall (2) (siehe Finalize Page in https://docs.frisbii-transform.com/docs/subscriptionjs), ohne dass die Umleitung manuell im ersten Erfolgs-Callback stattfindet. Die Behandlung im Success-Callback ist in beiden Fällen gleich, bei Unzer jedoch nur im Finalize Success-Callback.

Fehlerhafte Zahlungsdaten

Im Normalfall werden fehlhafte Eingaben beim Aufruf von paySignupInteractive / payUpgradeInteractive / paymentChange im Error Callback vom Zahlungsprovider zurückgegeben und können entsprechend behandelt werden, bevor ein Zahlungsversuch stattfindet. Dies ist bei Unzer nicht möglich. Es kann passieren, dass ein Zahlungsversuch mit falschen Zahlungsdaten stattfindet, der dann folgerichtig fehlschlägt. Da der Zahlungsversuch fehlgeschlagen ist, muss in solchen Fällen eine neue Order angelegt werden.

6. Weitere Hinweise

Nach einer Rücklastschrift wird die betroffene IBAN automatisch von Unzer auf eine Blacklist gesetzt und Folgeabbuchungen sind über diese IBAN nicht mehr möglich.

Optional können Sie bei Unzer schriftlich den Verzicht auf die generelle Verwendung der Blacklist und deren Schutzmechanismen beantragen. Beachten Sie jedoch, dass dadurch die mehrfache Nutzung eines bereits auffälligen Zahlungsmittels in Kauf genommen wird, sowie die Chargeback-Quote steigen kann, was zusätzliche Rücklastschriftgebühren seitens der Banken nach sich ziehen kann.