Kundenkarten und wiederkehrende Kartengebühren

Die Karten werden so aufbewahrt, dass die Kunden gemäß dem von ihnen vereinbarten Zahlungsplan belastet werden können – sie werden nur mit Markenname und den letzten vier Ziffern angezeigt, versiegelt und nur zum Aufbau der Datei für die Bank entschlüsselt.

Abonnement, monatliche Gebühr, Ratenzahlung: Der Kunde stimmt einmalig zu und zahlt den Betrag nach einem festgelegten Zeitplan. Die Buchhaltung → Kartenzahlungen verwaltet alle drei Komponenten – die Karten, die Zahlungsvereinbarungen und die an die Bank übermittelten Zahlungsstapel. Sie entsprechen dem Sicherheitsstandard der Kartenindustrie (PCI DSS), sodass die Kartennummer das Einzige in TRANXACT ist, was niemand auf einem Bildschirm lesen kann.

Karten

Beim Hinzufügen einer Karte werden der Kunde, die Kartennummer, das Ablaufdatum, der Name des Karteninhabers und die Postleitzahl der Rechnungsadresse erfasst. Anschließend wird die Karte überall nur noch mit ihrer Marke und den letzten vier Ziffern angezeigt: auf dem Bildschirm, in Downloads, in ASK und im Prüfprotokoll.

Die Nummer ist versiegelt: Sie wird mit einem eigenen Schlüssel (AES-256-GCM) verschlüsselt, und dieser Schlüssel ist wiederum mit einem Schlüsselverschlüsselungsschlüssel verschlüsselt, den die Plattform außerhalb der Datenbank verwaltet. Eine Produktionsinstallation ohne diesen Schlüssel verweigert die Speicherung einer Karte vollständig.
Der Sicherheitscode (CVV oder CVC), eine PIN und die Daten des Magnetstreifens werden bei Übermittlung abgelehnt und niemals gespeichert.
Dieselbe Karte wird zweimal hinzugefügt, aber nur einmal gespeichert.
Die Bearbeitung ändert das Ablaufdatum, den Namen auf der Karte, die Postleitzahl der Rechnungsadresse oder den Status – niemals die Kartennummer. Eine neue Karte ist eine neue Karte: Fügen Sie sie hinzu, übertragen Sie die Berechtigungen darauf und löschen Sie dann die alte Karte.
Durch das Löschen wird der eigene Schlüssel der Karte zerstört, sodass die Nummer von niemandem wiederhergestellt werden kann, und die darauf befindlichen Mandate werden aufgehoben.

Kartenmandate

Ein Mandat ist die Zustimmung des Kunden zur Abbuchung: Es enthält die Kartendaten, den Betrag und die Währung, die Abbuchungshäufigkeit (einmalig, monatlich, vierteljährlich oder jährlich), das Datum der ersten Abbuchung und, falls vorhanden, das Enddatum. Die wortgetreue Zustimmung des Kunden ist maßgebend – auf diese Zustimmung wird bei einer strittigen Abbuchung reagiert. Ein Mandat kann pausiert, fortgesetzt oder storniert werden.

Kartenbelastungsstapel

Bei der Charge Due-Mandatenfunktion wird für jedes Mandat, das am Ausführungsdatum fällig ist, nur eine Gebühr erhoben, und nicht mehr: Wenn Sie es für dasselbe Datum erneut ausführen, wird niemand zweimal belastet.
Der Export für die Bank erstellt die Datei, die der Acquirer oder die Bank verwendet. Nur hier wird die Kartennummer entschlüsselt. Dafür ist eine eigene Berechtigung erforderlich (Karten-Batch-Export). Jeder Export wird protokolliert – allerdings ohne die Kartennummern. Laden Sie die Datei hoch und löschen Sie anschließend Ihre Kopie.
Die Antwort der Bank wird zu jeder einzelnen Gebühr protokolliert: beglichen oder abgelehnt.

Wer darf was tun?

Karten, Kartenmandate, Kartenzahlungsstapel, Kartenstapelexport und die Karten-API (externe Integrationen) werden wie alle anderen Bereiche unter Plattform → Rollen & Berechtigungen gewährt. ASK und Agenten wird unabhängig von ihrer Rolle jede Kartenverarbeitung verweigert.

Karten von Ihrer Website: die Karten-API

Eine Website oder App, die Kartendaten entgegennimmt, kann diese über die externe API speichern, sodass die Kartennummer niemals über eine Person weitergegeben wird.

Anruf	Was es tut
POST /api/accounting/card-api/v1/cards	Speichert eine Karte. Sendet einen Idempotenz-Schlüssel-Header: Derselbe Schlüssel wird zweimal gesendet, speichert die Karte einmal und gibt dieselbe Antwort zurück.
GET /api/accounting/card-api/v1/cards	Die Karten, maskiert – Marke und die letzten vier.
PATCH …/cards/{id}	Ablaufdatum, Name auf der Karte, Postleitzahl der Rechnungsadresse oder Status. Niemals die Kartennummer.
LÖSCHEN …/cards/{id}	Zerstört die Karte, genau wie die Funktion „Löschen“.
/api/accounting/card-api/v1/mandates	Erstellt und liest Mandate mit einem Idempotenzschlüssel auf die gleiche Weise.

Der Aufrufer meldet sich mit dem Token eines Dienstkontos an (siehe Dienstkonten). Die Rolle dieses Dienstkontos benötigt eine explizite Berechtigung für die Card API (externe Integrationen). Eine Rolle mit allen Berechtigungen oder eine Administratorrolle reichen nicht aus: Die Berechtigung muss namentlich erteilt werden.
Im Produktionsbetrieb werden Anrufe ausschließlich über HTTPS entgegengenommen.
Anrufe sind pro Konto begrenzt, und eine Reihe abgelehnter oder ungültiger Karten – ein typisches Anzeichen dafür, dass jemand gestohlene Nummern testet – führt zur Sperrung des Anrufers.