Nach erfolgreicher Installation der collana pay App können in der collana pay Einrichtung alle notwendigen Einstellungen vorgenommen werden.
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.
Umgebung
| API-Version | Gibt an, welche API-Version von collana pay verwendet werden soll. collana pay unterstützt zwei API-Versionen: api und api/v2. Die API-Version sollte auf "api/v2" eingestellt werden. |
|
API-Schlüssel |
Ein 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. In Business Central SaaS ist eine Basis Authentifizierung (mit Benutzernamen und Passwort) nicht mehr zugelassen. 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. |
| 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" (Sandbox oder Produktion) verwendet werden. |
| 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. |
| 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. 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. Das Feld Sandbox Autentifizierungs-ID wird eingeblendet, sobald der Schieberegler im Feld "Use Authentification Id" aktiviert ist. Im gleichen Step werden die Felder Sandbox Benutzername und Sandbox Passwort ausgeblendet. Die Autentifizierungs-ID wird aktuell durch einen Request an die collana hive GmbH erstellt und übermittelt. |
|
Produktive Basis-URL |
Die produktive Basis-URL der collana pay Service-Plattform. https://live.collanapay.com |
|
Produktiv Autentifizierungs-ID |
Gibt die Autentifizierungs-ID in der Produktivumgebung an. In einer SaaS-Umgebung von Business Central ist eine Basis Authentifizierung mit Produktiver Benutzernamen und Produktives Passwort nicht mehr zulässig. Stattdessen muss die oAuth 2.0-Authentifizierung verwendet werden. 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 eingeblendet. Die Produktiv Authentifizierungs-ID ist nach der Einrichtung der Authentifizierung im collana pay Admin Portal verfügbar. |
Zahlungsformen
| Zahlungsformcode | 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. |
| Transaktionsstatus bei Import | Gibt den Status einer im Webshop gestarteten Transaktion für die jeweilige Zahlart beim Import 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 unter "Buchung" konfiguriert ist. "Gebucht" bedeutet, dass der Betrag bereits gebucht ist, wenn die Informationen von collana pay abgerufen werden. |
| collana pay Importer verwenden |
Gibt an, ob für eine Zahlungsmethode der collana pay Importer verwendet werden soll. Die Entscheidung ist abhängig davon, ob die collana pay App im Webshop integriert ist oder nicht. Weitere Informationen zu den Anbindungsarten: |
|
Benachrichtigung erforderlich-Flag benutzen |
Gibt an, ob der collana pay Importer die erforderliche Flag-Benachrichtigung verwenden soll oder nicht. Wenn diese Option ausgewählt ist, benötigt collana pay bereits eine Benachrichtigung für einen Zahlungsanbieter, bevor der Import verwendet wird. Liegt bei collana pay noch keine Benachrichtigung vor, wird der Import abgelehnt. |
| Netto-Beträge verwenden | Gibt an, ob die Berechnung des Betrags mit Nettobeträgen statt mit Bruttobeträgen erfolgt. |
| Buchung | Gibt an, wann der Capture (z. B. das Abbuchen des Betrags von der Kreditkarte) erfolgen soll. "Manuell" bedeutet, dass die Capture-Anfrage manuell im 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. Dieses kann manuell, bei der Buchung der Verkaufsgutschrift oder per Job ausgelöst werden. |
| Starten einer Zahlung aus BC | Gibt an, ob diese Zahlungsmethode einen Zahlungsprozess in Business Central starten kann. Wenn aktiviert, können Sie einen Zahlungsvorgang manuell aus dem Kundenauftrag oder der Verkaufsrechnung heraus starten. |
| 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 Zahlungsart verlängert werden. |
| Aktualisierung des Warenkorbs zulassen | Gibt an, ob für diese Zahlungsmethode die Warenkorbaktualisierung in COPAL aktiviert ist oder nicht. Wenn aktiviert, kann der Warenkorb-Update-Endpunkt für diese Zahlungsmethode verwendet werden. |
| Automatische PSP Stornierung aktiviert | Gibt an, ob für diese Zahlungsmethode die automatische PSP-Stornierung in COPAL aktiviert ist oder nicht. Wenn aktiviert, werden zu keinem Zeitpunkt Void-Interaktionen gesendet. |
| Kommunikationsmodus | Gibt an, ob die Kommunikation simuliert oder mit der collana pay core API durchgeführt werden soll. |
| Zahlungsanbieter | Gibt den Zahlungsdienstleister (PSP) der ausgewählten Zahlungsmethode an. |
| Zahlungsmethode | Gibt den Zahlungsmethodentyp für den Anbieter der Zahlungsmethode an. |
Zuordnung von Zahlungsanbietern
| Zahlungsform | Gibt die Zahlungsmethode an. |
| Zahlungsanbieter Referenz |
Unterscheidungsmerkmal für eine bestimmte Zahlart in einem Mandantensetup (z. B. bei mehreren Webshops), die im Business Central Verkaufsauftrag enthalten sein muss, wenn die gleiche Zahlart im gleichen Land beim gleichen PSP mit der gleichen Währung verwendet wird. Das Merkmal ist frei definierbar. |
| Währungscode | Gibt den Währungscode an. |
| Zahlungsland | Gibt das Zahlungsland an. |
| Anbieter-Kontonummer | Gibt die Provider-Konto-ID an. Die ID finden Sie im collana pay Admin-Portal. |
Erweitert
| 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.
Hinweis: Diese Funktion sollte ausgeschaltet werden, sofern sich der Freigabeprozess in Ihrem System vom Standard unterscheidet und es wichtig ist, dass ein Auftrag, in gewissen Konstellationen, im Status Offen verbleiben soll. Grundsätzlich ist zu beachten, dass collana pay mit freigegeben Aufträgen arbeitet und das auch erwartet. Anwendungsbeispiel wäre hier ein Teillieferungsprozess mit separaten Warenausgängen, bei dem der Auftragsstatus zuvor auf Offen stehen muss. |
| 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://collanapay.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. |
Simulation
|
Kommunikationssimulation verfügbar |
Zeigt an, ob die Simulation verfügbar ist. |
| Tenant Simulation |
Zeigt an, ob die Mandantensimulation verfügbar ist. |
| PSP-Simulation | Zeigt an, ob die PSP-Simulation verfügbar ist. |
Es ist zu beachten, dass im collana pay Setup die Aufgabenwarteschlangenposten aktiviert werden müssen. Dazu kann in der Einrichtung über Einrichtung -> Aufgaben Warteschlange die Aufgabenwarteschlangenposten aufgerufen und die Jobs über Status auf 'Bereit' festlegen aktiviert werden.