Zahlungen Zahlungsarten Kredit- / Debitkarte Tokenisierung auf Seiten des Kunden

 Tokenisierung auf Seiten des Kunden

Unser sicheres Zahlungsformular verfügt über eine Reihe von vorgefertigten Eingabeelementen, die Sie in die Lage versetzen, sensible Kartendaten auf Ihrer Checkout-Seite einzuholen. Novalnet tokenisiert (zwischenzeitlich) die sensiblen Zahlungsinformationen und Ihr Server kommt nur mit unseren tokenisierten Zahlungsdaten in Berührung.

Dieses Zahlungsformular beinhaltet folgende Merkmale:

  • Während der Eingabe der Kartendaten werden diese automatisch formatiert
  • Platzhalter können in die von Ihrem Käufer bevorzugte Sprache übersetzt werden.
  • Reaktionsschnelles Design
  • Anpassung des CSS-Stylesheets, sodass es mit dem Erscheinungsbild Ihrer Checkout-Seite übereinstimmt
  • Kartentyp, Kartennummer, Ablaufdatum und CVC werden dynamisch auf der Grundlage der Eingabe aktualisiert
  • Optionen um Ihr Zahlungsformular kompakter zu machen

NovalnetUtility einbinden

Sie müssen das NovalnetUtility-Skript auf Ihrer Checkout-Seite einbinden (wo Sie Ihr Kredit-/Debitkarten-Formular anzeigen werden). Es sollte direkt von https://cdn.novalnet.de/js/v2/ geladen und nicht von Ihnen selbst gehostet werden.

Es wird sehr empfohlen, https://cdn.novalnet.de/js/v2/NovalnetUtility-1.1.2.js im head-Tag Ihrer Zahlungs-/Checkout-Seite einzufügen.

Einen iFrame zu Ihrem Zahlungsformular hinzufügen

Fügen Sie dort ein iFrame HTML-Tag in der Template-Datei Ihrer Zahlungs-/Checkoutseite ein, wo Sie das Zahlungsformular anzeigen wollen.

Fügen Sie dann die folgenden, versteckten Felder hinzu, um die notwendigen Daten zu speichern, welche Sie während des Tokenisierungsvorgangs erhalten, sodass diese an Novalnet übergeben werden können.

panHash:

Speicherung des eindeutigen Bezeichners von Novalnet für die angegebenen Zahlungsdaten

unique_id:

Speicherung der Zufalls-ID, welche zu einem bestimmten pan_hash gehört

do_redirect:

Ist der Wert 1, dann sollten Sie die Zahlung als a Umleitung verarbeiten

Zum Paymentzugriffsschlüssel

Der Paymentzugriffsschlüssel ist ein eindeutiger, öffentlicher Schlüssel, welcher mit Ihrem Account verbunden ist. Wir authentifizieren dann Ihre Aufrufe von Kundenseite auf der Grundlage Ihres Paymentzugriffsschlüssels. Hier setzen wir Ihre Domain auf eine Whitelist, von welcher nur Sie Ihre Aufrufe von Kundenseite durchführen können. Daher benötigen Sie Ihren Paymentzugriffsschlüssel für die folgenden Zwecke:

  • Anzeige des abgesicherten Zahlungsformulars
  • (Temporäre) Tokenisierung von sensiblen Informationen

Sie müssen den Paymentzugriffsschlüssel nicht während Ihrer serverseitigen Aufrufe an die API verwenden.

Whitelist für die Domain(s)

Wir erlauben Aufrufe von Kundenseite nur von der auf der Whitelist zugelassenen Domain Ihres jeweiligen Projekts. Die Domain auf der Whitelist sollte eine gültige, abgesicherte (https://) Domain sein.

Im TEST MODE funktioniert die Domain auf der Whitelist sowohl für nicht abgesicherte (http://) und abgesicherte (https://) Protokolle und Umgebungen. Der Wert für den Port sollte auch mit angegeben werden (falls anwendbar).

Sobald Ihr Projekt angelegt wurde, werden wir standardmäßig die URL Ihrer Hauptseite auf die Whitelist setzen (welche Sie während der Erstellung des Projekts angegeben haben).

So erhalten Sie Ihren Paymentzugriffsschlüssel

Sie finden Ihren Paymentzugriffsschlüssel in Ihrem Novalnet Admin-Portal unter dem folgenden Pfad Projekte -> [Wählen Sie Ihr gewünschtes Projekt aus] -> API-Anmeldeinformationen -> Client-Key

Sie können Ihren client_key (Paymentzugriffsschlüssel) auch über die API von Novalnet merchant/details zusammen mit Ihren Händlerdaten erhalten.

Verwalten Sie Ihre Domains

Sie können Domains hinzufügen oder entfernen, welche Sie für die Authentifizierung von Kundenseite aus auf die Whitelist setzen wollen und zwar in Ihrem Novalnet Admin-Portal, wenn Sie dort dem folgenden Pfad folgen: Projekte -> [Wählen Sie Ihr gewünschtes Projekt aus] -> API-Anmeldeinformationen -> Zugelassene Domains -> Bearbeiten, ohne Ihren Paymentzugriffsschlüssel zu ändern.

Sie können selbst bis zu 4 Domains über das Novalnet Admin -Portal auf die Whitelist setzen. Kontaktieren Sie bitte unser Support-Team, wenn Sie mehr als 4 Domains hinzufügen wollen.

Setzen Ihres Paymentzugriffsschlüssels

Sie müssen Ihren Paymentzugriffsschlüssel in der Novalnet Javascript-Bibliothek setzen, indem Sie die Funktion - NovalnetUtility.setClientkey("###YOUR_CLIENT_KEY###"); verwenden. Auf dieser Grundlage authentifizieren wir Ihre Domain.

Sobald Sie den Paymentzugriffsschlüssel in Ihrer Novalnet Javascript-Bibliothek gesetzt haben, können Sie auf unterstützende Funktionen zugreifen, um fortzufahren.

Formular für Kredit-/Debitkarten anlegen

Jetzt müssen Sie das Objekt für die Konfiguration an die Funktion der NovalnetUtility-Programmbibliothek library function - NovalnetUtility.createCreditCardForm(object) übergeben. Diese Funktion wird das Zahlungsformular innerhalb des iFrame anlegen und anzeigen.

Liste der Parameter

Jede Anfrage ist in sogenannte Objekte aufgeteilt, welche eine Einheit beschreiben.

Jeder Parameter ist mit Attributen versehen Pflichtfeld, Bedingungsabhängig, Freiwillig. Auf der Grundlage Ihrer Anforderungen können Sie diese Parameter entsprechend einsetzen.

callback
Objekt
iframe
Objekt
customer
Objekt
transaction
Objekt
custom
Objekt

Zahlungsdaten erhalten

Sobald der Käufer die Kartendaten eingibt, sollte Ihr Skript die Funktion - NovalnetUtility.getPanHash() aufrufen. Dann können Sie die Werte für pan_hash, unique_id und do_redirect erhalten, indem Sie die Funktion starten - NovalnetUtility.getPanHash()

Im Allgemeinen können Sie die Funktion NovalnetUtility.getPanHash() beim Absenden des Formulars oder einem Ereignis zu einem Klick aufrufen.

Erhalten Sie die Höhe des Zahlungsformulars

Wenn die Höhe des Zahlungsformulars nicht in Ihrem Container festgelegt ist (z.B. während der Aktivierung mit einem Klick), dann können Sie die genaue Höhe nach einem bestimmten Szenario / Ereignis (nach dem Öffnen mit einem Klick) setzen, indem Sie die Funktion NovalnetUtility.setCreditCardFormHeight() aufrufen.

Beispielskript

Sehen Sie sich bitte unten die vorgefertigte Novalnet-Beispiellösung an, welche alle diese Dinge erledigt, einschließlich des Erstellens des iFrame und des Zahlungsformulars und der Einrichtung der Kommunikation mit Novalnet:

Ausführen