Tenant
collana pay Kunden werden zwei Tenants (Live und Sandbox) zur Verfügung gestellt. Die Tenant ID dient zur eindeutigen Identifikation eines Unternehmens und als Lizenzschlüssel für die Nutzung von collana pay.
Innerhalb des Tenants sind zwei API-Keys hinterlegt, die für die Authentifizierung bei der Kommunikation mit der API verwendet werden. Diese Schlüssel ermöglichen es externen Systemen oder Integrationen, sich gegenüber der collana pay API zu identifizieren und autorisierte Anfragen zu stellen.
Es wird nur ein API-Key benötigt. Der zweite API-Key dient als Backup.
Die Tenant ID wird für die Konfiguration der Business Central-App benötigt, um die erforderlichen Informationen aus der Datenbank abzurufen.
Auf der Startseite sind verschiedene Reiter zu sehen.
Providers
Ein Provider Account ist eine Kombination aus einem Payment Service Provider (PSP) und einer Zahlungsart. Die Einrichtung eines Provider Accounts im Reiter Providers ermöglicht die Konfiguration der gewünschten Zahlungsanbieter und Zahlungsmethoden.
Die für die Einrichtung notwendigen Informationen befinden sich im Backend des jeweiligen PSP und können je nach PSP variieren.
In diesem Artikel wird die generelle Anlage eines neuen Provider Accounts beschrieben.
Anleitungen zur Einrichtung der einzelnen PSPs sind im Support Center im Abschnitt Zahlungsdienstleister zu finden.
Wichtig ist, dass die Konfiguration nur das Verhalten von collana pay beeinflusst und keine Auswirkungen auf den PSP oder das integrierte System hat. Die Einstellungen im jeweiligen Backend des Payment Service Providers sollten daher analog zu den Einstellungen in copal vorgenommen werden. Wird in copal eine Einstellung vorgenommen, die vom jeweiligen PSP nicht unterstützt wird, wird eine entsprechende Fehlermeldung angezeigt.
Onboarding
Im Reiter Onboarding kann die Einrichtung der Authentifizierung mit einem PSP durch das Abrufen eines Tokens durchgeführt werden.
Zur Zeit kann ein Onboarding für die PSPs PayPal und Mollie durchgeführt werden.
Anleitungen sind hier zu finden.
Authentications
Im Reiter Authentications können die Authentifizierungsmethoden definiert werden, die für die asynchrone Kommunikation (Callbacks) verwendet werden sollen. Die Callbacks dienen beispielsweise dazu, Informationen über den Status einer Zahlung zu übermitteln. Wenn das System oder der Endpunkt, an den collana pay diese Nachrichten sendet, nicht öffentlich zugänglich ist, ist eine Authentifizierung notwendig.
Bei Nutzung der collana pay App in Business Central wird während der Anlage der Microsoft Entra-Anwendungen automatisch eine Authentication-ID in copal erzeugt.
Eine Anleitung zur manuellen Anlage einer Authentication-ID ist hier zu finden.
Contacts
Im Reiter Contacts können Kontaktpersonen hinterlegt werden, an die wir uns wenden können, wenn im Monitoring Auffälligkeiten festgestellt werden, um diese schnellstmöglich zu beheben.
Verknüpfung mit