Mit der Funktion

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

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
  SpaceWithExcerpt DE MultiExcerptName Helpdesk-Name PageWithExcerpt Wording

  , 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 

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

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

Multiexcerpt include
SpaceWithExcerpt DE MultiExcerptName MerchantPortal-Kurz PageWithExcerpt Wording

Bedienoberfläche

Im

• 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 

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 

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