Versions Compared

Old Version 2

changes.mady.by.user Peter Posse

Saved on

compared with

New Version Current

changes.mady.by.user Peter Posse

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEWORK and version Dokumentation

Table of Contents

Mit der Funktion

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptWording (veraltet)
Kundentresor können Sie Ihren Kunden ein nahtloses Bezahlerlebnis bieten.Mit dieser Funktion können Kunden ihre Karten für zukünftige Transaktionen sicher speichern. Das beschleunigt und vereinfacht Folgekäufe und verbessert die Konversionsrate.

Händler, die über eine Gehostete Zahlungsseite oder Gehostete Formulare in das

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Name
PageWithExcerptWording (veraltet)
integriert sind, können die Funktion
Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptWording (veraltet)
 Kundentresor aktivieren, um die Karteninformationen der Käufer in der sicheren und konformen Infrastruktur des 
Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording (veraltet)
s zu speichern.

Wenn Ihre Kunden über das Kartenformular bezahlen, haben sie die Möglichkeit, ihre Kartendaten zu speichern.Gespeicherte Karten stehen Ihnen für zukünftige Einkäufe in Ihrem Shop zur Verfügung. Kunden können:

  • beim Bezahlvorgang aus ihren gespeicherten Karten auswählen

  • Karten jederzeit entfernen.


Erste Schritte

  • Wenden Sie sich an den
    Multiexcerpt include
    SpaceWithExcerptDE
    MultiExcerptNameHelpdesk-Name
    PageWithExcerptWording (veraltet)
    , um diese Funktion zu aktivieren, wenn Sie über eine gehostete Zahlungsseite oder gehostete Formulare integriert sind.
  • Nach der Aktivierung müssen Sie die merchantCustomerId in Ihrer Zahlungsanforderung angeben:
    Code Block
    {
    "customerInfo": {
        "merchantCustomerId": "cus_1234567890abcdef",
        "firstName": "Max",
        "lastName": "Mustermann",
        "email": "customer@example.com",
        "phone": {
            "countryCode": "+49",
            "number": "1236547890"
        }
    }
}


Benutzererfahrung im Zahlungsablauf

Neukundenregistrierung

Sobald die Funktion für Ihr Händlerprofil aktiviert ist und Sie die merchantCustomerId in der Anfrage angegeben haben, wird den Kunden ein zusätzliches Kontrollkästchen zur Speicherung ihrer Kartendaten für zukünftige Einkäufe angezeigt. Wenn der Kunde zustimmt, werden die Kundendaten und Kartendetails im 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Name
PageWithExcerptWording (veraltet)
gespeichert.

Wiederkehrende Kunden

Wiederkehrende Kunden (identifiziert durch die in der Zahlungsanforderung übermittelte merchantCustomerId) sehen alle ihre gespeicherten Karten, können daraus auswählen und schneller bezahlen.


Kunden verwalten

Für jeden gespeicherten Kunden speichert das

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Name
PageWithExcerptWording (veraltet)
ein Kundenobjekt und für jede karte ein Zahlungsmethodenobejtk. Ein Kunde kann mehrere Zahlungsmethodenobjekte verknüpft haben, wenn er mehrere Karten gespeichert hat.

Sie können Kundendaten über die Benutzeroberfläche des 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameMerchantPortal-Kurz
PageWithExcerptWording (veraltet)
oder programmatisch über unsere REST-API ansehen und verwalten. 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameMerchantPortal-Kurz
PageWithExcerptWording (veraltet)
 Bedienoberfläche

Im

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNameMerchantPortal-Kurz
PageWithExcerptWording (veraltet)
steht Ihnen ein neuer Kundenbereich zur Verfügung. Hier können Sie:

  • Eine Liste aller Kunden anzeigen

  • Einzelne Kundendetails anzeigen

  • Alle von jedem Kunden gespeicherten Karten anzeigen

  • Kundendetails aktualisieren

  • Einen Kunden löschen (löscht auch dessen Zahlungsmethoden)

  • Eine bestimmte Zahlungsmethode löschen.

So haben Sie die volle Kontrolle über die Datensätze der Kunden und Zahlungsmethoden.

REST-API

Alle Aktionen zur Verwaltung von Kunden und Zahlungsmethoden sind auch über unsere REST-API verfügbar. So können Sie Ihre eigene Bedienoberfläche erzeugen oder die Funktionalität in Ihre Systeme integrieren.

Verfügbare Endpunkte


Webhook-Benachrichtigungen

Jedes Mal, wenn während der Zahlungsabwicklung ein neuer Kunde oder eine neue Zahlungsmethode im 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Name
PageWithExcerptWording (veraltet)
hinzugefügt wird, werden die Informationen an den in der Zahlungsanforderung angegebenen urls.webhook und den für Ihr Händlerprofil konfigurierten Kundentresor-spezifischen Webhook-Benachrichtigungsendpunkt gesendet.

Webhook-URL 

Ein neuer Parameter vaultInteraction wird an die urls.webhook gesendet, nachdem die Zahlungs abgeschlossen ist. Dieser informiert Sie über die Interaktion des Kunden mit dem Kundentresor im Kartenformular.

Mögliche Werte:

WertBeschreibung
PAYMENT_METHOD_ADDEDWenn eine neue Karte für einen neuen Kunden oder ein bestehendes Kundenprofil hinzugefügt wird.
PAYMENT_METHOD_USED Wenn eine vorhandene gespeicherte Karte zur Zahlung verwendet wurde.
NONE Der Kunde hat keinen Tresor oder ein bestehender Kunde hat mit einer neuen Karte bezahlt, diese aber nicht gespeichert.

Kundentresor-Webhook-Benachrichtigung

Die an den Kundentresor-Webhook-Benachrichtigungsendpunkt gesendete Benachrichtigung enthält umfassende Informationen zu den im 

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording (veraltet)
gespeicherten Zahlungsmethodendaten. Die gesendeten Informationen basieren auf der Art der vom Kunden im Formular ausgeführten Aktion.

Eine neue Karte speichern

Parameterbeschreibung

Table FilterdefaultBeschreibungisFirstTimeEnterfalsehideColumnstruesparkNameSparklinehidePanetruedatepatterndd M yyid1757937196076_-1990469439worklog

dd M yy
365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
Multiexcerpt
MultiExcerptNamecustomer_vault_newcard
Table Transformer
dateFormat
export-wordfalse
show-sourcefalse
export-csvfalse
id1757937196078_-1457315336
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*
ParameterTypeCND
Description
Beschreibung
gatewayCustomerIdstring (32)M
Unique identifer of the customer assigned by
Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptEN:Wording

Vom

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording

(veraltet)

vergebene eindeutige Kennung des Kunden

merchantCustomerIdstring (64)M
Unique identifer of the customer assigned by merchant
Vom Händler vergebene eindeutige Kennung des Kunden
merchantIdstringM
Merchant ID
Händler-ID
scopestringM
Scope of the customer vault configured at merchant level
Umfang des auf Händlerebene konfigurierten Kundentresors
paymentMethod.actionenumM
Describes whether the card was created or deleted. For saving a new card the value is "create"
Beschreibt, ob die Karte angelegt oder gelöscht wurde.Beim Speichern einer neuen Karte lautet der Wert „create“.
paymentMethod.id string (32)M
Unique ID assigned by Multiexcerpt includeSpaceWithExcerptEN
MultiExcerptNamePlatform-KurzPageWithExcerptEN:Wording for the payment method record

Vom

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording

(veraltet)

vergebene eindeutige ID für den Datensatz der Zahlungsmethode

paymentMethod.typeenumM

Determines type of payment method. Possible values: card

Bestimmt die Art der Zahlungsmethode.Mögliche Werte: card

paymentMethod.last4Digitsstring (4)M
Last 4 digits of the card
Letzte 4 Ziffern der Karte
paymentMethod.pseudoCardNumbernumber (16)C
Pseudo card number
Pseudo-Kartennummer
paymentMethod.cardHolderNamestringM
Cardholder name
Name des Karteninhabers
paymentMethod.brandstringM
Type of card brand (Visa, Mastercard, etc.)
Kartenmarke (Visa, Mastercard usw.)
paymentMethod.expiryDatenumber (6)M
Expiry date of the card
Ablaufdatum der Karte
paymentMethod.createdAtdatetimestampM
Creation date of payment method record
Erstellungsdatum des Datensatzes der Zahlungsmethode
paymentMethod.updatedAtdatetimestampM
Last updated date of the payment method record
Letztes Aktualisierungsdatum des Datensatzes der Zahlungsmethode
paymentMethod.lastUsedAtdatetimestampM
Last used date of the payment method record
Letztes Verwendungsdatum des Datensatzes der Zahlungsmethode



Beispiel

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamecustomer_vault_newcard_sample
PageWithExcerptEN:REST API Computop Customer Vault


Eine bestehende Karte löschen

Diese Benachrichtigung wird gesendet, wenn der Kunde die Karte aus dem Zahlungsformular löscht.

Parameterbeschreibung

Table FilterdefaultBeschreibungisFirstTimeEnterfalsehideColumnstruesparkNameSparklinehidePanetruedatepatterndd M yy

id1757937196079_1829210739
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
Multiexcerpt
MultiExcerptNamecustomer_vault_deletecard
Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1757937196082_-134176444
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*
ParameterTypeCND
Description
Beschreibung
gatewayCustomerIdstring (32)M

Unique identifer of the customer assigned by

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptEN:Wording

Vom

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording

(veraltet)

vergebene eindeutige Kennung des Kunden

merchantCustomerIdstring (64)M
Unique identifer of the customer assigned by merchant
Vom Händler vergebene eindeutige Kennung des Kunden
merchantIdstringM
Merchant ID
Händler-ID
scopestringM
Scope of the customer vault configured at merchant level
Umfang des auf Händlerebene konfigurierten Kundentresors
paymentMethod.actionenumM
Describes whether the card was created or deleted. For deleting an existing card the value is "delete".
Beschreibt, ob die Karte angelegt oder gelöscht wurde.Zum Löschen einer bestehenden Karte lautet der Wert „delete“.
paymentMethod.id string (32)M
Unique ID assigned by
Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptEN:Wording
for the payment method record

Vom

Multiexcerpt include
SpaceWithExcerptDE
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording

(veraltet)

vergebene eindeutige ID für den Datensatz der Zahlungsmethode

paymentMethod.typeenumM
Determines type of payment method. Possible values: card

Bestimmt die Art der Zahlungsmethode.Mögliche Werte: card



Beispiel

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamecustomer_vault_deletecard_sample
PageWithExcerptEN:REST API Computop Customer Vault