collana pay Tenant / copal

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. Die Tenant ID wird für die Konfiguration der Business Central-App benötigt, um die erforderlichen Informationen aus der Datenbank abzurufen.

Im Bereich Tenants stehen die Reiter Provider Accounts, Fehlerverwaltung und Einstellungen zur Verfügung.

Provider Accounts

Ein Provider Account ist eine Kombination aus einem Payment Service Provider (PSP) und einer Zahlungsart. Die Einrichtung eines Provider Accounts im Reiter Provider Accounts 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.

Die Konfiguration beeinflusst nur das Verhalten von collana pay und hat keine Auswirkungen auf den PSP oder das integrierte System. 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.

Fehlerverwaltung

Im Bereich Fehlerverwaltung werden Schwellenwerte für Alarmierungen sowie die zugehörigen Kontaktpersonen verwaltet.

Deadletter-Queue-Einstellungen

Im Abschnitt Deadletter-Queue-Einstellungen wird ein Schwellenwert für die Anzahl nicht zustellbarer Callbacks an ein Drittsystem (Shop oder ERP-System) festgelegt. Wird dieser Schwellenwert erreicht, wird automatisch eine Alert-Mail an die im Abschnitt Kontakte hinterlegten Alarmkontakte versendet.

Kontakte

Im Abschnitt Kontakte können Kontaktpersonen als Alarmkontakt hinterlegt werden, an die sich collana pay wendet, wenn im Monitoring Auffälligkeiten festgestellt werden oder der in den Deadletter-Queue-Einstellungen definierte Schwellenwert erreicht wird.

Einstellungen

Der Bereich Einstellungen umfasst die Unterpunkte PSP-Onboarding, Authentifizierung und API-Schlüssel.

PSP-Onboarding

Im Abschnitt PSP-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, Mollie und Stripe durchgeführt werden.

Anleitungen sind hier zu finden.

Authentifizierung

Im Abschnitt Authentifizierung 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.

Eine Anleitung zur manuellen Anlage einer Authentication-ID ist hier zu finden.

API-Schlüssel

Im Abschnitt API-Schlüssel sind die 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. 

Über den Button Neuen Schlüssel erzeugen können neue API-Keys erzeugt werden. 
Nicht mehr verwendete API-Keys können aus der Liste gelöscht werden.