Nach erfolgreicher Installation der collana pay App können in der collana pay Einrichtung alle notwendigen Einstellungen vorgenommen werden.
Eine inititale Einrichtung kann, wie hier beschrieben, über das Assisted Setup vorgenommen werden.
Menü
Im oberen Menüband gibt es folgende Möglichkeiten:
| Menüpunkt | Beschreibung |
| Entra Registration | Mit Klick auf den Button wird ein Eintrag in den Microsoft Entra-Anwendungen angelegt. |
| Verbindung testen | Hier kann die Verbindung zur collana pay API getestet werden. |
| Unterstützte Einrichtung | Führt das Assisted Setup aus. |
| Einrichtung der Berichtsauswahl | Hier können Berichte ausgewählt und angepasst werden, die im Zusammenhang mit collana pay verwendet werden, beispielsweise zum Versand eines Zahlungslinks. |
| Anredearten Einrichtung | Hier können die Anredecodes für die Kommunikation mit collana pay zugeordnet werden. Weitere Infos dazu am Ende dieses Artikels. |
| Einrichten der Aufbewahrungsrichtlinie | Einrichtung der Aufbewahrungsrichtlinie für die berechtigten collana pay Tabellen |
| Bevorstehende Reservierungsverlängerungen | Zeigt die anstehenden Reservierungsverlängerungen an. |
| Anstehende automatische Captures | Zeigt die anstehenden automatischen Captures an, die vom Job verarbeitet werden. |
| Aufgaben Warteschlange | Öffnet die Aufgabenwarteschlangenposten. Hier kann der Status eingesehen und die Aufgabenwarteschlangenposten manuell gestartet werden. |
Abschnitt Allgemein
| Menüpunkt | Beschreibung |
| API-Schlüssel | Der API-Schlüssel ist ein Code, der zur Identifizierung und Authentifizierung des Tenants in collana pay dient. Der Code wird automatisiert bei der Einrichtung des Tenants generiert. Dieser API-Schlüssel wird für die gesamte Kommunikation zwischen der collana pay Service Plattform und der collana pay Anwendung für Microsoft Business Central benötigt. Jeder Kunde hat einen eigenen API-Schlüssel. Dieser wird normalerweise nicht geändert. |
| Callback Typ | Gibt an, in welchem Format Rückmeldungen an collana pay gesendet werden sollen. Der Wert hängt von der im Webservice eingerichteten Codeunit ab (5516495 für SOAP, 5516518 für ODataV4). Für BC SaaS sollte ODataV4 eingestellt werden, da SOAP nicht mehr unterstützt wird. Für BC onPremise kann SOAP weiterhin eine Option sein. Es wird dennoch empfohlen, den ODataV4-Webservice einzurichten und ihn anstelle von SOAP zu verwenden. Denken Sie daran, die „Callback-URI“ zu ändern, wenn Sie diesen Wert ändern. |
| Callback URI |
Die Callback-URI ist die Adresse von Business Central, an der die (Rück-)Meldungen von collana pay empfangen werden. Pro Tenant wird eine eigene Callback URI vergeben. Die Kommunikation zwischen der collana pay Service Plattform und der collana pay Anwendung findet ausschließlich asynchron statt. Daher wird für die Benachrichtigung, die die Service-Plattform von den Zahlungsdienstleistern erhält und in verarbeiteter Form an Business Central weiterleitet, eine Callback-URI benötigt. Die Callback URI ist in BC SaaS Umgebungen folgendermaßen aufgebaut: https://api.businesscentral.dynamics.com/v2.0/<Tenant Name>/<Umgebungsname>/ODataV4/ReceiveCollanaPayNotification_ReceiveNotification?company=<Mandantenname> |
| Sandbox Modus | Gibt an, ob in einer Sandbox-Umgebung gearbeitet werden soll. Eine Sandbox ist eine sichere Umgebung zum Testen, d.h. es handelt sich um eine Nichtproduktivumgebung. Wenn der Sandbox Modus aktiv ist, wird in einer Test- Umgebung gearbeitet. |
| Authentifizierungs-ID verwenden | Aktiviert die Authentifizierung mit einer Authentifizierungs ID. In einer SaaS-Umgebung von Business Central ist eine Basis Authentifizierung mit Benutzernamen und Passwort nicht mehr zulässig. Stattdessen muss die oAuth 2.0-Authentifizierung verwendet werden. Nachdem diese eingerichtet ist, sollte diese Option zusammen mit einer gültigen Authentifizierungs ID verwendet werden. |
| Sandbox Basis-URL | Die Sandbox-Basis-URL für die collana pay Service-Plattform. https://sandbox.collanapay.com |
| Sandbox-Authentifizierungs-ID |
Gibt die Autentifizierungs-ID in der Testumgebung an. Das Feld Sandbox Autentifizierungs-ID wird eingeblendet, sobald der Schieberegler im Feld "Use Authentification Id" aktiviert ist. Im gleichen Schritt werden die Felder Sandbox Benutzername und Sandbox Passwort ausgeblendet. Die ID wird bei der Entra Registierung automatisch in copal erzeugt und in der collana pay Einrichtung hinterlegt. Die manuelle Anlage einer Authentifizierungs ID erfolgt über copal. |
| Produktive Basis-URL | Die produktive Basis-URL der collana pay Service-Plattform. |
| Produktiv Autentifizierungs-ID |
Gibt die Autentifizierungs-ID in der Produktivumgebung an. Das Feld Produktiv Autentifizierungs-ID wird eingeblendet, sobald der Schieberegler im Feld "Authentifizierungs ID verwenden" aktiviert ist. Im gleichen Schritt werden die Felder Produktiv Benutzername und Produktiv Passwort ausgeblendet. Die ID wird bei der Entra Registierung automatisch in copal erzeugt und in der collana pay Einrichtung hinterlegt. Die manuelle Anlage einer Authentifizierungs ID erfolgt über copal. |
Zahlungsformen
Nach der Installation von collana pay in Business Central ist automatisch eine Zahlungsform mit Zahlungsformcode COLLANAPAY zu sehen. Diese Zeile kann gelöscht und durch eigene Zahlungsformcodes ersetzt werden.
| Menüpunkt | Beschreibung |
| Zahlungsmethodencode | Gibt den Code für die jeweilige Zahlungsform an, die für Transaktionen mit collana pay zugelassen sind. Die Zahlungsformen müssen in der Übersicht der Zahlungsformen angelegt sein. |
| Importer verwenden |
Gibt an, ob für eine Zahlungsmethode der collana pay Importer verwendet werden soll. Die Entscheidung ist abhängig davon, ob collana pay im Webshop integriert ist oder nicht. Weitere Informationen zu den Anbindungsarten: |
| Initialer Transaktionsstatus | Gibt den Status einer Transaktion für die jeweilige Zahlart bei der Anlage in Business Central an. Nicht autorisiert bedeutet, dass die Reservierung des Betrags noch nicht stattgefunden hat und angestoßen werden muss. Autorisiert bedeutet, dass der Betrag bereits reserviert ist. Die Buchung erfolgt zum Zeitpunkt, der in der Spalte Buchung konfiguriert ist. Gebucht bedeutet, dass der Betrag bereits gebucht ist, z.B. bei Auto-Capture Zahlarten. |
| Buchung | Gibt an, wann der Capture (der Einzug der Zahlung) erfolgen soll. Manuell bedeutet, dass die Capture-Anfrage manuell im PSP-Backend angestoßen wird (z. B. bei Klärfällen). Freigabe bedeutet, dass die Capture-Anfrage bei Freigabe des Verkaufsauftrags angestoßen wird. Hier wird der gesamte Betrag gecaptured. Buchung bedeutet, dass die Capture-Anfrage mit der Buchung des Warenausgangs angestoßen wird. Hier wird nur der Betrag von den Artikeln abgebucht, die auch wirklich versendet werden. Job bedeutet, dass der Auftrag gebucht werden kann und ein Capture-Eintrag mit Status New entsteht bis ein Job (Aufgabenwarteschlangenposten) im Hintergrund den Capture-Aufruf zu einem späteren Zeitpunkt anstößt. |
| Rückerstattung / Gutschrift | Gibt an, wann die Rückerstattung / Gutschrift erfolgen soll. Sie kann manuell, bei Buchung der Verkaufsgutschrift oder per Job ausgelöst werden. |
| Zahlung starten | Gibt an, ob diese Zahlungsmethode einen Zahlungsprozess in Business Central starten kann. Wenn aktiviert, kann ein Zahlungsvorgang manuell aus dem Verkaufsauftrag oder der Verkaufsrechnung heraus gestartet werden. Weitere Informationen sind im Artikel zu Pay By Link zu finden. |
| Wiederkehrende Zahlung |
Gibt an, ob diese Zahlungsart für wiederkehrende Zahlungen verwendet wird. Wenn aktiviert, kann diese Zahlungsart nur für wiederkehrende Zahlungen verwendet werden. Weitere Informationen sind im Artikel zu Wiederkehrenden Zahlungen zu finden. |
| Zahlungsanbieter | Gibt den Zahlungsdienstleister (PSP) der ausgewählten Zahlungsmethode an. |
| Zahlungsmethode | Gibt den Zahlungsmethodentyp für den Anbieter der Zahlungsmethode an. |
| Anbieter Unterart | Gibt den Subtyp zur Zahlungsmethode an (z.B. Mollie PayByLink über den Anbieter Klarna) |
Über Karte anzeigen lassen sich weitere Einstellungsmöglichkeiten zu einer Zahlungsform vornehmen.
| Menüpunkt | Beschreibung |
| GUID einrichten | Gibt die eindeutige Kennung für die Setup-Zeile an. |
| Kommunikationsmodus | Gibt an, ob die Kommunikation simuliert oder mit der collana pay API durchgeführt werden soll. |
| Netto-Beträge verwenden | Gibt an, ob die Berechnung des Betrags mit Nettobeträgen statt mit Bruttobeträgen erfolgt. |
| Reservierungsverlängerung zulassen | Gibt an, ob für diese Zahlungsmethode die Reservierungsverlängerung in copal aktiviert ist oder nicht. Bei Aktivierung kann die Reservierung für diese Zahlungsmethode verlängert werden. |
| Aktualisierung des Warenkorbs zulassen | Gibt an, ob für diese Zahlungsmethode die Warenkorbaktualisierung in copal aktiviert ist oder nicht. Bei Aktivierung kann der Warenkorb-Update-Endpunkt für diese Zahlungsmethode verwendet werden. |
| Automatische PSP Stornierung aktiviert | Gibt an, ob für diese Zahlungsmethode die automatische Stornierung einer Zahlung durch den PSP in copal aktiviert ist oder nicht. Bei Aktivierung wird von diesem System keine Reservierungsauflösung (void) gesendet, es sei denn, die Transaktion wurde nie verarbeitet (vollständige Stornierung, es existiert kein Capture Logeintrag). |
| Spätes automatisches Capture | Gibt an, ob vor Ablauf der Reservierung automatisch ein Capture ausgelöst werden soll. Für die Ausführung des automatischen Captures wird ein Eintrag in der Aufgabenwarteschlange verwendet. Ist diese Option aktiviert, muss zusätzlich das Feld „Auto Capture - Tage vor Ablauf“ gesetzt werden. |
Zuordnung von Zahlungsanbietern
| Menüpunkt | Beschreibung |
| Zahlungsform | Gibt den Zahlungsformcode an. |
| Zahlungsanbieter Referenz | Unterscheidungsmerkmal für eine bestimmte Zahlungsmethode in einem Mandantenaufbau (z.B. für mehrere Webshops), das in den Business Central Verkaufsauftrag aufgenommen werden muss, wenn die gleiche Zahlungsmethode im gleichen Land für den gleichen PSP mit der gleichen Währung verwendet wird. Das Merkmal ist benutzerdefiniert. |
| Währungscode | Gibt den Währungscode an. |
| Zahlungsland | Gibt das Zahlungsland an. |
| Anbieter-Kontonummer | Gibt die Provider Account ID an. Die ID ist in COPAL ersichtlich. |
Erweitert
| Menüpunkt | Beschreibung | |
| Folgeprozesse nach Transaktionserstellung auslösen |
Durch die asynchrone Natur von collana pay, können Freigabeprozesse unterbrochen werden. Immer dann, wenn collana pay kommuniziert, kann es sein, dass der Auftrag zurückgesetzt wird, da auf eine Antwort von collana pay bzw. dem Zahlungsanbieter gewartet wird. Das kommt in der Regel beim Importprozess vor, der bei der Freigabe ausgelöst wird. Die Zahlungsinformationen müssen beim Zahlungsanbieter abgefragt und in die collana pay Datenbank geschrieben werden. Erst danach bekommt der Verkaufsauftrag seine Transaktions-ID und erhält seinen Status. Wenn diese Funktion aktiv ist, wird nach Verarbeitung der Import Benachrichtigung der Auftrag sofort erneut versucht freizugeben. Dies hat dann zur Folge, dass der Auftrag, wie ursprünglich geplant, freigeben ist. Unabhängig vom Import Prozess und sofern das Capture bei Freigabe erfolgen soll, wird auch dieser Vorgang automatisch eingeleitet. Nachdem die Antwort vom Zahlungsanbieter eingetroffen ist, wird der Verkaufsauftrag nach erfolgreicher Verarbeitung automatisch freigegeben. Die Asynchronität wird mit Hilfe von den vorkonfigurierten Aufgabenwarteschlangen gehandhabt.
|
|
| Buchungsprozess automatisch auslösen |
Analog zu dem oben beschriebenen Szenario, ist diese Funktion dafür da, dass bei Buchungsprozessen, bei denen auf Antwort von collana pay oder des Zahlungsanbieters gewartet werden muss, der Buchungsprozess nach Erhalt der Antwort automatisch vollendet wird. Beispiel: Das Capture soll beim Buchen des Verkaufsauftrages durchgeführt werden, da allerdings vorerst auf eine positive Antwort von collana pay bzw. des Zahlungsanbieters gewartet werden muss, wird erst beim nächsten Durchlauf der Warteschlangenposten, nach erfolgreicher Capture-Meldung, der Buchungsprozess erneut angestoßen und somit die Verkaufsrechnung erzeugt. |
|
| Anzahl der automatischen Wiederholungen | Automatische Transaktionen werden maximal bis zu dieser Anzahl ausgeführt. Damit wird verhindert, dass Transaktionen unnötig oft ausgeführt werden. | |
| Rundungspriorität | Gibt an, welcher Wert beim Runden von Steuer- und Nettobeträgen Vorrang hat. Der ausgewählte Wert legt fest, welcher Betrag aufgerundet wird, wenn beide Werte genau .005 sind. | |
| Redirect URI Success | Die URL, auf die der Kunde nach erfolgreicher Zahlung weitergeleitet wird (z. B. https://google.com/success). | |
| Redirect URI Failure | Die URL, auf die der Kunde nach fehlgeschlagener Zahlung weitergeleitet wird (z. B. https://google.com/failure). | |
| Redirect URI Cancellation | Die URL, auf die der Kunde nach abgebrochener Zahlung weitergeleitet wird (z. B. https://google.com/cancellation). | |
| Anzahl der Tage vor Ablauf der Reservierung | Gibt die Anzahl der Tage an, nach denen die Reservierungsverlängerung beginnt, bevor die Reservierung abläuft. | |
| Anzahl der Tage nach Ablauf der Reservierung | Gibt die Anzahl der Tage an, nach denen die Reservierungsverlängerung beginnt, nachdem die Reservierung abgelaufen ist. Einige Zahlungsanbieter erlauben eine längere Reservierungsverlängerung als angegeben. | |
| Maximale Anzahl fehlgeschlagener Reservierungsverlängerungen | Gibt die maximale Anzahl automatischer Versuche an, eine Reservierung zu erneuern. Wenn dieser Wert niedrig gehalten wird, kann dies die Kommunikation mit dem Zahlungsanbieter verringern. | |
| Ausgeschlossene Kartenmarken | Gibt die Kartenmarken an, die vom Reservierungsverlängerungsprozess ausgeschlossen werden sollen. Die Marken werden durch Kommas getrennt. |
Es ist zu beachten, dass im collana pay Setup die Aufgabenwarteschlangenposten aktiviert werden müssen. Dazu kann in der Einrichtung die Aufgabenwarteschlangenposten aufgerufen und die Jobs über Status auf 'Bereit' festlegen aktiviert werden.
Anredearten Einrichtung
In der Menüleiste kann die Option Einrichtung und dann Anredearten Einrichtung gewählt werden.
collanapay unterstützt nur die drei Anredearten Männlich, weiblich divers. Sollten in Business Central mehr Anredearten konfiguriert sein, müssen diese in der Einrichtung auf die drei collana pay Anredearten gemappt werden.