Der Token ist eine Referenz auf in der Plattform gespeicherte Informationen. Da diese Informationen sensibel oder unstrukturiert sein können, bieten wir Ihnen eine einfache Möglichkeit, diese Informationen in unserer Plattform zu speichern, indem Sie einen Token mit einer Referenz erstellen. Um die Informationen für die Zahlung zu verwenden, zum Beispiel mit einem Charge Flow oder einer Transaktion, können Sie diesen Token nutzen und müssen den Kunden nicht erneut nach den Informationen fragen.
Der Hauptanwendungsfall für Token ist die Speicherung kritischer Kreditkarteninformationen, da diese nur innerhalb PCI-zertifizierter Umgebungen gespeichert werden dürfen. Es gibt jedoch verschiedene andere Situationen, in denen die Verwendung von Token nützlich sein kann. Sie können für jeden Connector, der Tokenisierung unterstützt, einen Token erstellen.
Ein Kunde hat bereits online in Ihrem Shop mit SEPA-Lastschrift als Zahlart bestellt. Sie können diese Informationen mit einem Token für weitere Einkäufe speichern. Stellen Sie sich vor, er ruft nach 4 Monaten an und möchte einige Produkte nachbestellen. Sie können nun eine Transaktion ohne anwesenden Kunden erstellen, indem Sie die Token-Referenz verwenden, ohne erneut nach den Informationen zu fragen.
Alle Token-Operationen können über den Token Service durchgeführt werden. Erstellte Token können im Back Office unter Space > Zahlung > Token eingesehen werden
Nicht alle Zahlarten und Connector-Konfigurationen unterstützen die Token-Funktion. Wenn Sie prüfen möchten, ob die Zahlart sie unterstützt, finden Sie weitere Informationen in unserer Zahlarten-Referenz. Sie können dies tun, indem Sie Ihren Prozessor in unserer Connector-Liste öffnen und auf den Connector klicken. Dadurch öffnet sich ein Bildschirm, der die Funktionen der Payment Page anzeigt.
Wenn die wiederkehrende Zahlung ausgewählt ist, wird nach der ersten Zahlung ein Token erstellt.
Um einen Token zu erstellen, verwenden Sie den Token Service
mit der Operation create.
Sie können festlegen, ob der Token für One-Click-Zahlungen aktiviert werden soll. Wenn ein Token für One-Click-Zahlungen aktiviert ist, kann der Käufer den Token im iFrame oder auf der Payment Page auswählen, um mit dem Token zu bezahlen. Die Verwendung des Tokens reduziert die Anzahl der Schritte, die der Käufer durchlaufen muss. Der Käufer wird anhand der Kunden-ID auf der Transaktion erkannt. Das bedeutet, dass dem Käufer die zuvor verwendeten Token angezeigt werden, wenn wir einen Token haben, der dieselbe Kunden-ID wie die Transaktion hat. Zusätzlich muss die Zahlart so konfiguriert sein, dass One-Click-Zahlungen erlaubt sind.
Die untenstehende Anfrage erstellt einen neuen Token für den Test-Kunden. Die Zahlungsreferenz wird nun automatisch in der Token Version gespeichert.
Anfrage
{
"customerEmailAddress": "test@email.com",
"enabledForOneClickPayment": true,
"externalId": "1",
"tokenReference": "test-customer"
}Antwort
Die untenstehende Anfrage erstellt eine Transaktion mit dem erstellten Token.
{
"createdOn": "2017-12-07T14:53:20.285Z",
"customerEmailAddress": "test@email.com",
"enabledForOneClickPayment": true,
"externalId": "1",
"id": 1572,
"linkedSpaceId": 396,
"state": "ACTIVE",
"timeZone": "Europe/Zurich",
"tokenReference": "test-customer",
"version": 0
}Sie können den Token verwenden, um eine Transaktion zu erstellen. Geben Sie dazu einfach die id des Tokens in der
Transaction Create Operation an. Der Token kann nun auf
die folgenden Arten verwendet werden:
Sie können den Token über die iframe-Autorisierung anzeigen, wodurch Ihr Kunde den Token auswählen kann, um die Transaktion zu verarbeiten.
Sie können den Token über die Payment-Page-Autorisierung verwenden. Dadurch wird der
Kunde direkt belastet und je nachdem, ob der Token belastet werden konnte, zur successURL oder failedURL weitergeleitet.
Sie können einen Charge Flow auf die Transaktion anwenden, die einen Token verwendet. Dies führt zu einer direkten Belastung, oder die Charge-Flow-Stufen werden ausgelöst, falls der Token nicht belastet werden kann.
Anfrage
Die untenstehende Anfrage erstellt eine Transaktion mit dem erstellten Token.
{
"billingAddress": {
"city": "Zurich",
"country": "Switzerland",
"familyName": "Test",
"givenName": "Customer",
"street": "Teststreet 4"
},
"currency": "chf",
"lineItems": [{
"amountIncludingTax": "15",
"name": "Test",
"quantity": "1",
"type": "PRODUCT",
"uniqueId": "12354"
}],
"token": 1572
}Der One-Click-Checkout erhöht Ihre Conversion, da die Zahlungsinformationen Ihres Kunden für weitere Einkäufe sicher gespeichert werden können, sodass Ihr Kunde beim nächsten Mal direkt mit dem Token bezahlen kann. Diese Funktion ist in der Iframe- oder Payment-Page-Integration für alle Zahlarten verfügbar, die Token unterstützen (siehe oben).
Damit der One-Click-Checkout funktioniert, müssen Sie sicherstellen, dass die folgenden Voraussetzungen erfüllt sind:
Die Zahlart unterstützt Tokenisierung (prüfen Sie die Connector-Liste)
Sie geben die Eigenschaft customerId in der Transaction Create Operation an
Der One-Click-Zahlungsmodus muss in der Zahlarten-Konfiguration aktiviert sein (siehe unten)
Wenn diese Voraussetzungen erfüllt sind, initialisiert die Anwendung automatisch einen Token und speichert die Zahlungsinformationen sicher bei Ihrem Prozessor. Dies funktioniert bei der Payment-Page-Integration und bei der iframe-Integration.
Stellen Sie sicher, dass Sie für jede Zahlart, für die Sie One-Click aktivieren möchten, den One-Click-Zahlungsmodus aktivieren. Sie haben die Wahl zwischen 3 Optionen:
Deaktivieren (Standard): In diesem Fall wird kein Token erstellt
Speicherung erzwingen: In diesem Fall versucht die Anwendung immer, einen Token zu erstellen.
Speicherung erlauben: In diesem Fall wird der Kunde gefragt, ob er den Token speichern möchte. Er hat auch die Möglichkeit, die gespeicherten Token zu verwalten.
Sobald eine Kunden-ID angegeben ist, der One-Click-Modus aktiviert ist und ein Token hinterlegt ist, wird dem Käufer ein Token zum Bezahlen angezeigt, oder er hat die Möglichkeit, eine andere Zahlart zu verwenden.
Falls Sie den Token direkt belasten möchten, können Sie die tokenId direkt in der Transaction Create Operation angeben; in diesem Fall wird der Token direkt belastet.
