Einleitung
Die Idee vom besteht darin, Kundendaten wie Kreditkartendaten, Rechnungs-/Lieferadresse sicher im
zu speichern und diese Daten basierend auf der CustomerId wiederzuverwenden.
Customer Data Storage (CDS) bezieht sich auf einen Bereich, der verwendet werden kann, um dieselben CDS-Daten mit mehreren Ihrer MerchantIds zu teilen.
Nachdem Customer Data Storage für Ihre MerchantId im aktiviert wurde:
- erste Verwendung / Verbraucher hat noch keine Daten gespeichert
- Sie können die CustomerId in
-Requests senden
- der Verbraucher wird auf der Hosted Payment Page / dem Kreditkartenformular (PaySSL) gefragt, ob die Zahlungsdaten gespeichert werden sollen
- die Zahlungsanforderung ist abgeschlossen
- und Sie werden über Aktualisierung im Customer Data Storage benachrichtigt
- Sie können die CustomerId in
- nachfolgende Verwendung / Verbraucher hat bereits Daten gespeichert
- Sie senden weiterhin die CustomerId im
- die Kreditkartendaten werden auf der Hosted Payment Page / dem Kreditkartenformular (PaySSL) vorausgefüllt
- der Verbraucher muss nur die CVC ergänzen – da die CVC zu keinem Zeitpunkt gespeichert werden darf
- die Zahlungsanforderung ist abgeschlossen
- Sie senden weiterhin die CustomerId im
Wir können eine von Ihnen bereitgestellte Benachrichtigungs-URL einrichten. Bei jeder Änderung der CDS-Daten (Customer Data Storage) erhalten Sie eine Benachrichtigung mit der CustomerReferenceId. Damit können diese Daten dann bei CDS abgefragt werden.
Derzeit wird nur die Speicherung von Kreditkartendaten unterstützt. Unterstützung für andere Zahlungsdaten und andere Verbraucherdaten kann zu einem späteren Zeitpunkt hinzugefügt werden.
Prozessdiagramm
Der Customer Data Storage wird über die CustomerId angesprochen und in die Zahlungsabwicklung des eingebettet.
-Schnittstelle
Benachrichtigungen über Aktualisierungen des Customer Data Storage
Bei der Aktivierung des Customer Data Storage (CDS) durch müssen Sie eine URL angeben, um Benachrichtigungen über CDS-Updates zu erhalten. Die Daten werden als POST-Anfrage gesendet und sind Teil des Anfragetextes.
Benachrichtigungen über CDS-Updates sind nicht verschlüsselt, da sie keine sensiblen Daten enthalten.
es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden
die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
Key | Format | CND | Beschreibung | ||||||
|---|---|---|---|---|---|---|---|---|---|
CustomerReferenceId | an..32 | M | Vom | ||||||
| Type | enum | M | Art der im Customer Data Storage (CDS) referenzierten Daten
| ||||||
| Action | enum | M | Aktion im Customer Data Storage (CDS)
|
Customer Data Storage (CDS) Anfragen – GetDetails
CDS-Anfrage
CDS-Anfragen im geben gespeicherte CDS-Daten für eine bestimmte CustomerId oder CustomerReferenceId zurück.
|
Key | Format | CND | Beschreibung | ||||
|---|---|---|---|---|---|---|---|
MerchantID | ans..30 | M | HändlerID, die von | ||||
EventToken | enum | M |
| ||||
| CustomerId | an1..64 | C | Verweis auf Daten im Customer Data Storage mittels CustomerId erlaubte Zeichen: A-Z,a-z,0-9, Minus, Unterstrich (es muss entweder CustomerId oder CustomerReferenceId verwendet werden) | ||||
| CustomerReferenceId | an32 | C | Verweis auf Daten im Customer Data Storage mittels CustomerReferenceId (es muss entweder CustomerId oder CustomerReferenceId verwendet werden) |
Parameter für CDS-Anfragen über Socket-Verbindungen
CDS-Antwort
Key | Format | CND | Beschreibung | |
|---|---|---|---|---|
Status | a..50 | M | OK oder FAILED als Status der Abfrage, nicht der angefragten Transaktion | |
| Code | n8 | M | Fehlercode gemäß Falls CustomerId/CustomerReferenceId nicht gefunden wird, wird Code=23341536 zurückgegeben. | |
CustomerId | an1..64 | O | CustomerId im Datensatz des Customer Data Storage | |
CustomerReferenceId | an32 | O | CustomerReferenceId im Datensatz des Customer Data Storage | |
CustomerInfos | JSON | O | Base64-codierte Zeichenfolge, die eine JSON-Struktur mit CDS-Daten enthält | |
Antwortparameter bei CDS-Anfragen über Socket-Verbindungen
CustomerInfos-Details (Typ: CreditCard), Base64-decodiert
CDS GetDetails Anfrage / Antwort, Beispiel
Customer Data Storage (CDS) Anfragen – Löschen
CDS-Anfrage
CDS-Anfragen im können gespeicherte CDS-Daten für eine bestimmte CustomerId oder CustomerReferenceId löschen.
|
Key | Format | CND | Beschreibung | ||||
|---|---|---|---|---|---|---|---|
MerchantID | ans..30 | M | HändlerID, die von | ||||
EventToken | enum | M |
| ||||
Type | enum | M |
| ||||
| CustomerId | an1..64 | C | Verweis auf Daten im Customer Data Storage mittels CustomerId erlaubte Zeichen: A-Z,a-z,0-9, Minus, Unterstrich (es muss entweder CustomerId oder CustomerReferenceId verwendet werden) | ||||
| CustomerReferenceId | an32 | C | Verweis auf Daten im Customer Data Storage mittels CustomerReferenceId (es muss entweder CustomerId oder CustomerReferenceId verwendet werden) |
Parameter für CDS-Anfragen über Socket-Verbindungen
CDS-Antwort
Key | Format | CND | Beschreibung | |||||
|---|---|---|---|---|---|---|---|---|
Type | enum | M |
| |||||
Status | a..50 | M | OK oder FAILED als Status der Abfrage, nicht der angefragten Transaktion | |||||
| Code | n8 | M | Fehlercode gemäß Falls CustomerId/CustomerReferenceId nicht gefunden wird, wird Code=23341536 zurückgegeben. | |||||
CustomerId | an 1..64 | O | CustomerId im Datensatz des Customer Data Storage | |||||
CustomerReferenceId | an32 | O | CustomerReferenceId im Datensatz des Customer Data Storage | |||||
Antwortparameter bei CDS-Anfragen über Socket-Verbindungen
CDS Löschen Anfrage / Antwort, Beispiel
Unterstützte Vorlagen
Derzeit werden diese Vorlagen unterstützt
- Speicherung von Kreditkartendaten im Customer Data Storage – wenn für die spezifische Kunden-ID noch keine Daten gespeichert sind
- Vorausfüllen
Vorlagennamen:
- ct_responsive
- ct_cards_v1
Beispiele
Kunde gibt Kreditkartendaten erstmalig ein
- Kunden gibt Kreditkartendaten erstmalig ein
- und stimmt zu, diese Daten für zukünftige Einkäufe zu speichern