Kundennamen erfassen

Namen von Unternehmen und Einzelpersonen als Felder erster Klasse beim Bezahlvorgang erfassen.

Sie können die Namenserfassung im Zahlungsformular aktivieren, um Namen von Unternehmen oder Einzelpersonen von Ihren Kund/innen zu erfassen. Die Informationen sind nach Abschluss der Sitzung verfügbar.

Diese Namen der ersten Klasse sind von den Namen, die mit den Abrechnungs- und Versandinformationen erfassten Informationen getrennt und erscheinen immer als übergeordnete Namensfelder auf dem Zahlungsformular, sofern aktiviert.

Namensfelder der ersten Klasse im Formular des Bezahlvorgangs

Bei Checkout werden dem Zahlungsformular Namensfelder der obersten Ebene hinzugefügt.

Erfassung des Namens aktivieren

Erstellen Sie einen Bezahlvorgang und geben Sie gleichzeitig die Einstellungen für die Namenserfassung an. Um die Namenserfassung zu aktivieren, konfigurieren Sie das Objekt name_Einzug beim Erstellen eines Bezahlvorgangs. Sie können Namen von Unternehmen, Einzelpersonen oder beides erfassen und jedes Feld je nach Bedarf als erforderlich oder optional festlegen.

Notiz

Wenn Sie die Erfassung des Unternehmensnamens als erforderlich festlegen, werden Express Checkout und Schaltflächen mit einem Klick, wie Apple Pay, an den unteren Rand des Zahlungsformulars verschoben oder deaktiviert.

Erfasste Namen abrufen

Nach der Sitzung können Sie die Namen der Unternehmen oder Einzelpersonen der Kunden aus den resultierenden Customer- oder Bezahlvorgang-Objekten abrufen:

Zum Kunden

Checkout speichert erfasste Namen in den jeweiligen Eigenschaften business_name oder individual_name des Kundenobjekts, auf Sie programmgesteuert zugreifen können, indem Sie entweder das Kundenobjekt direkt über die API abrufen oder indem Sie das Ereignis customer.created in einem Webhook überwachen.

Der Name des Kundenobjekts wird in dieser Bestellung ebenfalls auf den Namen des Unternehmens business_name oder der Einzelperson individual_name festgelegt.

{
  "object": {
    "id": "cus_HQmikpKnGHkNwW",
    "object": "customer",
    ...
    "name": "Stripe, Inc."
    "business_name": "Stripe, Inc."
    ...
    "individual_name": "Jenny Rosen"
    ...
  }
}

Sie können die Namen der Kunden/Kundinnen auch im Dashboard anzeigen.

Zur Checkout-Sitzung

Die Namen des Kunden werden auch im Hash collected_information und customer_details der Checkout-Sitzung gespeichert.

{
  "object": {
    "id": "cs_test_a1dJwt0TCJTBsDkbK7RcoyJ91vJxe2Y",
    "object": "checkout.session",
    ...
    "collected_information": {
      "business_name": "Stripe, Inc.",
      "individual_name": "Jenny Rosen"
    },
    ...
    "customer": "cus_id_of_new_customer",
    "customer_details": {
      ...
      "business_name": "Stripe, Inc.",
      "individual_name": "Jenny Rosen",
      "name": "Stripe, Inc."
    },
    ...
  }
}

Nach jedem erfolgreichen Bezahlvorgang sendet Stripe das Ereignis checkout.session.completed, das das Objekt der Checkout-Sitzung und die erfassten Werte enthält, die Sie in einem Webhook überwachen können.