Alphabetische Übersicht zentraler Begriffe, die in der collana pay Dokumentation verwendet werden.

A

API (Application Programming Interface)

Programmierschnittstelle, über die Systeme miteinander kommunizieren. collana pay stellt zwei REST-APIs bereit: die Transaction API (Zahlungsabwicklung) und die Administration API (Konfiguration und Verwaltung).

API-Key

Schlüssel zur Authentifizierung gegenüber der Transaction API. Liegt im GUID-Format vor und wird bei jedem Request im HTTP-Header ApiKey übermittelt. Pro Tenant werden zwei Keys bereitgestellt, um eine schnelle Rotation im Verlustfall zu ermöglichen.

Autorisierung

Im Zahlungskontext: Prüfung und Freigabe einer Zahlung durch den PSP. Bestätigt, dass der Betrag auf dem Zahlungsmittel des Kunden verfügbar ist und reserviert werden kann. In collana pay entspricht dies dem Reservation-Schritt.

B

Buttonzahlarten

Zahlarten, die über einen markentypischen Button des Zahlungsanbieters (z. B. „Mit Amazon Pay bezahlen") ausgelöst werden. Buttonzahlarten sind häufig Expresszahlarten, bei denen der Kunde bereits hinterlegte Daten beim PSP nutzt und der Checkout verkürzt wird. Sie können jedoch auch am Ende eines regulären Checkouts eingesetzt werden (z. B. Amazon Pay als abschließende Zahlungsoption). → Vergleiche: Expresszahlarten

Business Central → Microsoft Dynamics 365 Business Central

C

Callback / Callback-URL

URL eines Integrationssystems (z. B. Webshop, ERP), an die collana pay asynchrone Antwortnachrichten sendet. Das integrierende System stellt diese URL bereit und verarbeitet eingehende Nachrichten. Die Callback-URL ist die technische Grundlage des asynchronen Kommunikationsmodells von collana pay.

Cancel → Void

Capture

Einzug eines zuvor reservierten Zahlungsbetrags beim PSP. Nach einem erfolgreichen Capture wird der Betrag vom Zahlungsmittel des Kunden abgebucht. Der Capture kann manuell oder, insbesondere in der Business Central App, automatisiert ausgelöst werden.

copal (collana pay Admin Portal)

Webbasiertes Administrations-Portal von collana pay. Bietet eine grafische Oberfläche für die Verwaltung von Tenants, Provider Accounts, Zahlungsarten, Benutzern und Transaktionen. copal setzt auf der Administration API auf. → Siehe auch: Was ist copal?

Credit

Rückerstattung eines Betrags an den Kunden ohne Warenkorbbezug. Im Gegensatz zum Refund wird beim Credit kein Bezug zu einzelnen Warenkorbpositionen hergestellt. Typischer Einsatzfall sind Wertgutschriften aus Kulanz oder pauschale Gutschriften. → Vergleiche: Refund

D

Dead-Letter-Queue (Deadletter)

Warteschlange für Callback-Nachrichten, die collana pay nicht erfolgreich an das Integrationssystem übermitteln konnte. Fehlgeschlagene Nachrichten können über die API oder copal eingesehen und erneut verarbeitet werden.

E

EmbedmentUri

URL zu einer einbettbaren Eingabemaske (z. B. iFrame), die dem Kunden zur Eingabe seiner Zahlungsdaten direkt auf der Shop-Seite angezeigt wird. Wird von collana pay asynchron als Teil der Callback-Response übermittelt. → Vergleiche: RedirectUri

ERP (Enterprise Resource Planning)

Unternehmensweite Softwarelösung zur Verwaltung von Geschäftsprozessen wie Buchhaltung, Lager und Vertrieb. Im collana pay Kontext ist damit primär Microsoft Dynamics 365 Business Central gemeint.

Expresszahlarten

Zahlarten mit beschleunigtem Checkout-Ablauf (z. B. PayPal Express, Amazon Pay), bei denen der Kunde Liefer- und Rechnungsdaten beim PSP hinterlegt hat und der Checkout dadurch verkürzt wird. Expresszahlarten erfordern einen angepassten Prozessablauf gegenüber regulären Zahlarten. Expresszahlarten werden häufig als Buttonzahlarten angeboten. → Vergleiche: Buttonzahlarten

I

Interaktion (Interaction)

Einzelner Teilschritt innerhalb einer Transaktion (z. B. Prepare, Reservation, Capture, Refund). Jede Interaktion wird durch eine eindeutige interactionId identifiziert. Die Ergebnisse einer Interaktion werden asynchron über die Callback-URL übermittelt.

interactionId

Eindeutiger Bezeichner einer einzelnen Interaktion innerhalb einer Transaktion. Wird zusammen mit der transactionId in der synchronen Antwort zurückgeliefert und ermöglicht die Zuordnung der asynchronen Callback-Response.

M

Mandat

Einwilligung eines Kunden zur Durchführung wiederkehrender Zahlungen (Recurring Payments). Wird einmalig im Rahmen des Reserve-Schritts erteilt und ermöglicht nachfolgende Zahlungseinzüge ohne erneute Authentifizierung durch den Kunden. Ein Mandat kann über den Cancel-Endpunkt widerrufen werden.

Microsoft Dynamics 365 Business Central (BC)

ERP-System von Microsoft. collana pay bietet eine spezialisierte App-Extension für Business Central, die die Zahlungsabwicklung, inklusive automatischer Captures, Refunds und Stornierungen, direkt im ERP-System ermöglicht.

Microsoft Entra ID (Azure AD B2C)

Identity Provider von Microsoft, der von collana pay für die Authentifizierung gegenüber der Administration API (OAuth2) eingesetzt wird. Verwaltet Benutzerrollen und Zugriffsrechte.

Multi-Payment-Orchestration

Ansatz, bei dem mehrere PSPs und Zahlungsarten über eine einheitliche Schnittstelle (Middleware) orchestriert werden. Integrierte Systeme können PSPs wechseln oder neue Zahlungsarten hinzufügen, ohne die eigene Integration anpassen zu müssen. collana pay ist eine Multi-Payment-Orchestration-Plattform as a Service.

N

No Cart

Feature, das die Zahlungskommunikation ohne Warenkorb-Daten ermöglicht. Vereinfacht Zahlungsprozesse, bei denen keine detaillierten Artikeldaten vorliegen oder benötigt werden (z. B. bei Dienstleistungen oder Pauschalbeträgen).

O

OAuth2

Weit verbreitetes Autorisierungsprotokoll für den sicheren Zugriff auf APIs. Die Administration API von collana pay setzt OAuth2 über Microsoft Entra ID ein. 

Onboarding (PSP-Onboarding)

Prozess zur Einrichtung und Aktivierung eines neuen PSPs innerhalb eines Tenants in collana pay. Wird über copal oder die Administration API angestoßen und umfasst die Konfiguration von Zahlungsarten, Ländern, Währungen und PSP-spezifischen Einstellungen.

P

PassThroughValue

Frei definierbares Feld, das vom integrierenden System auf Transaktions- oder Interaktionsebene befüllt werden kann. collana pay verarbeitet den Wert nicht, gibt ihn aber bei den entsprechenden Callbacks unverändert zurück. Ermöglicht integrierenden Systemen eine individuelle Zuordnung von Transaktionen oder Interaktionen zu eigenen Datensätzen (z. B. interne Bestellnummern, Session-IDs oder sonstige Referenzen).

Pay By Link

Feature, das es ermöglicht, Zahlungen direkt aus Microsoft Dynamics 365 Business Central zu starten und Zahlungslinks per E-Mail an Kunden zu versenden. Wird z. B. für telefonische Bestellungen oder Nachzahlungen eingesetzt.

PCI DSS (Payment Card Industry Data Security Standard)

Sicherheitsstandard für die Verarbeitung, Speicherung und Übertragung von Kreditkartendaten. PSPs, die Kreditkartenzahlungen abwickeln, müssen PCI DSS zertifiziert sein. collana pay selbst verarbeitet keine Kreditkartendaten direkt, sondern leitet die Eingabe an den PSP weiter.

POS (Point of Sale)

Kassensystem oder physischer Verkaufspunkt, an dem Zahlungen vor Ort abgewickelt werden. collana pay unterstützt auch POS-Integrationen, z. B. über Adyen Terminal.

Prepare

Interaktion zur Vorbereitung einer Zahlung. Liefert asynchron ggf. eine RedirectUri, EmbedmentUri oder ScriptSourceUri, über die der Kunde seine Zahlungsdaten eingeben kann bzw. über die der Zahlungs-Button gerendert wird. Prepare ist der zweite Schritt im regulären Zahlungsprozess (nach Create).

Provider Account (ProviderAccount)

Konfigurationsobjekt in collana pay, das ein PSP-Konto eines Tenants repräsentiert. Enthält Einstellungen zu unterstützten Zahlungsarten, Ländern, Währungen und PSP-spezifischen Parametern. Ein Tenant kann mehrere Provider Accounts für verschiedene PSPs oder Konfigurationen besitzen.

PSP (Payment Service Provider)

Zahlungsdienstleister, der die eigentliche Zahlungsabwicklung zwischen Händler und Kunde übernimmt (z. B. Adyen, Mollie, Braintree, PayPal). collana pay fungiert als Middleware zwischen Integrationssystem und PSP und abstrahiert die PSP-spezifischen Schnittstellen.

R

Recurring Payments (Wiederkehrende Zahlungen)

Feature zur Durchführung wiederkehrender Zahlungen auf Basis eines einmal vom Kunden erteilten Mandats. Wird z. B. für Abonnements oder Ratenzahlungen eingesetzt. Im Gegensatz zu regulären Transaktionen entfällt der Prepare-Schritt; der Betrag wird pro Capture individuell angegeben.

RedirectUri

URL, zu der der Kunde für die Eingabe seiner Zahlungsdaten weitergeleitet wird (z. B. auf eine gehostete PSP-Seite). Wird von collana pay asynchron als Teil der Callback-Response übermittelt. → Vergleiche: EmbedmentUri

Refund

Rückerstattung eines bereits erfassten (gecapturten) Betrags an den Kunden mit Warenkorbbezug. Der Refund referenziert konkrete Warenkorbpositionen der ursprünglichen Transaktion. Kann vollständig oder teilweise erfolgen. → Vergleiche: Credit

Reservation

Reservierung eines Zahlungsbetrags beim PSP. Der Betrag wird auf dem Zahlungsmittel des Kunden blockiert, aber noch nicht eingezogen. Entspricht der klassischen Autorisierung im Zahlungsverkehr. Auf eine Reservation folgt typischerweise ein Capture oder Void.

Reversal → Void

REST API

Architekturstil für Web-APIs, der auf standardisierten HTTP-Methoden (GET, POST, PUT, DELETE) und zustandsloser Kommunikation basiert. Beide collana pay APIs (Transaction und Administration) sind als REST-APIs implementiert und verwenden JSON als Transportformat.

S

Sandbox-Umgebung

Testumgebung von collana pay, in der Integrationen und Zahlungsabläufe ohne echte Transaktionen erprobt werden können. API-Keys, Konfigurationen und Zugänge der Sandbox sind von der Live-Umgebung vollständig getrennt.

ScriptSourceUri

URL zu einem JavaScript, das von collana pay asynchron als Teil der Callback-Response übermittelt wird. Das Script wird vom Integrationssystem geladen und dient dem Rendern des markentypischen Buttons einer Buttonzahlart (z. B. Amazon Pay Button). → Vergleiche: Buttonzahlarten, EmbedmentUri, RedirectUri

SCA (Strong Customer Authentication)

Starke Kundenauthentifizierung gemäß EU-Zahlungsdiensterichtlinie PSD2. Erfordert bei Online-Zahlungen mindestens zwei Authentifizierungsfaktoren (Wissen, Besitz, Inhärenz). Die Umsetzung erfolgt durch den PSP; collana pay leitet den Kunden ggf. via RedirectUri oder EmbedmentUri zur Authentifizierung weiter.

T

Tenant

Mandant in collana pay. Jede Organisation (Kunde oder Partner) erhält einen eigenen, abgegrenzten Tenant, über den alle Konfigurationen, Provider Accounts und Transaktionen verwaltet werden. Pro Tenant können separate Sandbox- und Live-Instanzen eingerichtet werden.

Transaktion (Transaction)

Vollständige Abwicklung einer Zahlung innerhalb von collana pay. Umfasst alle Interaktionen (Create, Prepare, Reservation, Capture etc.) unter einer gemeinsamen transactionId. Eine Transaktion endet entweder mit einem erfolgreichen Capture, einem Void oder einer Fehlermeldung. Nach einem erfolgreichen Capture kann zusätzlich ein Refund oder Credit erfolgen.

transactionId

Eindeutiger Bezeichner einer Transaktion in collana pay. Wird beim Create-Schritt angelegt und muss für alle weiteren Interaktionen der Transaktion angegeben werden. Ermöglicht die Zuordnung asynchroner Callback-Responses.

V

Void

Stornierung einer bestehenden Reservierung. Gibt den reservierten Betrag frei, ohne ihn einzuziehen. Entspricht dem Cancel einer Transaktion nach erfolgter Reservation. Auch bezeichnet als Cancel oder Reversal.

W

WAF (Web Application Firewall)

Sicherheitsschicht, die eingehende HTTP-Anfragen analysiert und vor bekannten Angriffsvektoren (z. B. SQL-Injection, DDoS) schützt. Die Transaction-API-Endpunkte von collana pay sind durch eine WAF abgesichert.

Webshop

Online-Shop-System, das collana pay über die Transaction API integriert, um Zahlungen für Endkunden abzuwickeln. Der Webshop interagiert mit collana pay serverseitig (Backend-zu-Backend) und stellt eine Callback-URL für asynchrone Responses bereit.

Z

Zahlungsart (Payment Method)

Die vom Kunden gewählte Zahlungsmethode (z. B. CreditCard, PayPal, DirectDebit, KlarnaSofort, IDeal, Invoice, Terminal). In collana pay wird die Zahlungsart über den HTTP-Header x-payment-method-type angegeben und ist PSP-unabhängig definiert. Die Zuordnung zum konkreten PSP erfolgt über die Konfiguration im Provider Account.