Mit der Funktion 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 integriert sind, können die Funktion Kundentresor aktivieren, um die Karteninformationen der Käufer in der sicheren und konformen Infrastruktur des 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 , 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:
  

  { "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  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 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  oder programmatisch über unsere REST-API ansehen und verwalten. 

Bedienoberfläche

Im 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

• Kunden

  • GET /customers – Eine Liste der Kunden abrufenEine Liste der Kunden abrufen.

  • GET /customers/{id} –Details eines bestimmten Kunden abrufenDetails eines bestimmten Kunden abrufen.

  • PATCH /customers/{id} –Kundendaten aktualisierenKundendaten aktualisieren.

  • DELETE /customers/{id} –Einen Kunden und alle zugehörigen Zahlungsmethoden löschenEinen Kunden und alle zugehörigen Zahlungsmethoden löschen.

• Zahlungsmethoden

  • GET /customers/{id}/paymentMethods –Alle Zahlungsmethoden für einen Kunden auflistenAlle Zahlungsmethoden für einen Kunden auflisten.

  • GET /customers/{customerId}/paymentMethods/{paymentMethodId} –Details einer bestimmten Zahlungsmethode abrufenDetails einer bestimmten Zahlungsmethode abrufen.

  • DELETE /customers/{customerId}/paymentMethods/{paymentMethodId} –Eine bestimmte Zahlungsmethode löschenEine bestimmte Zahlungsmethode löschen.

Webhook-Benachrichtigungen

Jedes Mal, wenn während der Zahlungsabwicklung ein neuer Kunde oder eine neue Zahlungsmethode im  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:

Kundentresor-Webhook-Benachrichtigung

Die an den Kundentresor-Webhook-Benachrichtigungsendpunkt gesendete Benachrichtigung enthält umfassende Informationen zu den im  gespeicherten Zahlungsmethodendaten. Die gesendeten Informationen basieren auf der Art der vom Kunden im Formular ausgeführten Aktion.

Eine neue Karte speichern

Parameterbeschreibung

Beispiel

Eine bestehende Karte löschen

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

Parameterbeschreibung

Beispiel