Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden
ÜbersichtAktualisieren Sie Ihre Integration
Integration starten
Payment scenarios
Persönliche Zahlungen
Other Stripe products

Benutzerdefinierte Felder hinzufügen

Fügen Sie mit Checkout zusätzliche Felder zu einer vordefinierten Zahlungsseite hinzu.

Sie können dem Zahlungsformular benutzerdefinierte Felder hinzufügen, um zusätzliche Informationen von Ihren Kund/innen zu erfassen. Die Informationen stehen nach Abschluss der Zahlung zur Verfügung und sind nützlich, um den Kauf abzuschließen.

Nutzerdefinierte Felder haben die folgenden Einschränkungen:

  • Bis zu drei Felder zulässig.
  • Nicht verfügbar im setup-Modus.
  • Unterstützung von bis zu 255 Zeichen in Textfeldern.
  • Support von bis zu 255 Ziffern in numerischen Feldern.
  • Unterstützung von bis zu 200 Optionen in Dropdown-Feldern.

Vorsicht

Verwenden Sie keine benutzerdefinierten Felder, um geschützte, persönliche oder sensible Daten oder Informationen zu erfassen, die gesetzlich eingeschränkt sind.

Checkout-Sitzung erstellen

Erstellen Sie eine Checkout-Sitzung und geben Sie dabei eine Reihe von nutzerdefinierten Feldern an. Jedes Feld muss einen eindeutigen key haben, den Ihre Integration zum Abgleichen des Felds verwendet. Geben Sie auch eine Bezeichnung für das Feld an, das Sie Ihren Kundinnen/Kunden anzeigen. Label für nutzerdefinierte Felder werden nicht übersetzt. Sie können den Parameter locale verwenden, um die Sprache Ihrer Checkout-Sitzung an die Sprache Ihrer Label anzupassen.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=1 \
  -d "custom_fields[0][key]"=engraving \
  -d "custom_fields[0][label][type]"=custom \
  -d "custom_fields[0][label][custom]"="Personalized engraving" \
  -d "custom_fields[0][type]"=text
Eine Zahlungsseite mit benutzerdefinierten Feldern

Benutzerdefinierte Felder abrufen

Wenn Ihr Kunde/Ihre Kundin die Checkout-Sitzung abschließt, senden wir eine checkout.session.completed webhook mit den ausgefüllten Feldern.

Beispiel-Nutzlast von checkout.session.completed:

{
  "id": "evt_1Ep24XHssDVaQm2PpwS19Yt0",
  "object": "event",
  "api_version": "2022-11-15",
  "created": 1664928000,
  "data": {
    "object": {
      "id": "cs_test_MlZAaTXUMHjWZ7DcXjusJnDU4MxPalbtL5eYrmS2GKxqscDtpJq8QM0k",
      "object": "checkout.session",
      "custom_fields": [{
        "key": "engraving",
        "label": {
          "type": "custom",
          "custom": "Personalized engraving"
        },
        "optional": false,
        "type": "text",
        "text": {
          "value": "Jane",
        }
      }],
      "mode": "payment",
    }
  },
  "livemode": false,
  "pending_webhooks": 1,
  "request": {
    "id": null,
    "idempotency_key": null
  },
  "type": "checkout.session.completed"
}

Nutzerdefiniertes Feld verwenden

Ein Feld als optional kennzeichnen

Standardmäßig müssen Kund/innen alle Felder ausfüllen, bevor sie die Zahlung abschließen können. Um ein Feld als optional zu kennzeichnen, geben Sie optional=true ein.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=1 \
  -d "custom_fields[0][key]"=engraving \
  -d "custom_fields[0][label][type]"=custom \
  -d "custom_fields[0][label][custom]"="Personalized engraving" \
  -d "custom_fields[0][type]"=text \
  -d "custom_fields[0][optional]"=true

Dropdown-Feld hinzufügen

Ein Dropdown-Feld präsentiert Ihren Kund/innen eine Liste von Optionen zur Auswahl. Um ein Dropdown-Feld zu erstellen, geben Sie type=dropdown und eine Liste von Optionen mit jeweils einem label und einem value an. Das label wird dem Kunden/der Kundin angezeigt, während Ihre Integration den value verwendet, um abzugleichen, welche Option der/die Kund/in ausgewählt hat.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=1 \
  -d "custom_fields[0][key]"=sample \
  -d "custom_fields[0][label][type]"=custom \
  -d "custom_fields[0][label][custom]"="Free sample" \
  -d "custom_fields[0][optional]"=true \
  -d "custom_fields[0][type]"=dropdown \
  -d "custom_fields[0][dropdown][options][0][label]"="Balm sample" \
  -d "custom_fields[0][dropdown][options][0][value]"=balm \
  -d "custom_fields[0][dropdown][options][1][label]"="BB cream sample" \
  -d "custom_fields[0][dropdown][options][1][value]"=cream
Eine Zahlungsseite mit einem Dropdown-Feld

Ein reines Zahlenfeld hinzufügen

Bei einem reinen Zahlenfeld handelt es sich um ein Textfeld, in dem Ihre Kund/innen nur numerische Werte mit bis zu 255 Ziffern eingeben können. Um ein reines Zahlenfeld zu erstellen, geben Sie type=numeric an.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=1 \
  -d "custom_fields[0][key]"=invoice \
  -d "custom_fields[0][label][type]"=custom \
  -d "custom_fields[0][label][custom]"="Invoice number" \
  -d "custom_fields[0][type]"=numeric

Nutzerdefinierte Felder für ein Abonnement abrufen

Mit dem Parameter Abonnement können Sie die mit einem Abonnement verknüpften nutzerdefinierten Felder abrufen, indem Sie die Checkout-Sitzung abfragen, die den Parameter erstellt hat.

Command Line
curl -G https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d subscription=
{{SUBSCRIPTION_ID}}

Zeichenlängenvalidierungen hinzufügen

Sie können optional eine Anforderung für die minimale und die maximale Zeichenlänge für die Feldtypen text und numeric festlegen.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=1 \
  -d "custom_fields[0][key]"=engraving \
  -d "custom_fields[0][label][type]"=custom \
  -d "custom_fields[0][label][custom]"="Personalized engraving" \
  -d "custom_fields[0][type]"=text \
  -d "custom_fields[0][text][minimum_length]"=10 \
  -d "custom_fields[0][text][maximum_length]"=20 \
  -d "custom_fields[0][optional]"=true
Ein Feld mit Zeichenbeschränkungen

Standardwerte hinzufügen

Optional können Sie einen Standardwert für die Feldtypen Text, Zahlen und Dropdown angeben. Standardwerte werden auf der Bezahlseite automatisch ausgefüllt.

Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel" \
  -d "line_items[0][price]"=
{{PRICE_ID}}
 \
  -d "line_items[0][quantity]"=1 \
  -d "custom_fields[0][key]"=engraving \
  -d "custom_fields[0][label][type]"=custom \
  -d "custom_fields[0][label][custom]"="Personalized engraving" \
  -d "custom_fields[0][type]"=text \
  -d "custom_fields[0][text][default_value]"=Stella \
  -d "custom_fields[1][key]"=size \
  -d "custom_fields[1][label][type]"=custom \
  -d "custom_fields[1][label][custom]"=Size \
  -d "custom_fields[1][type]"=dropdown \
  -d "custom_fields[1][dropdown][default_value]"=small \
  -d "custom_fields[1][dropdown][options][0][value]"=small \
  -d "custom_fields[1][dropdown][options][0][label]"=Small \
  -d "custom_fields[1][dropdown][options][1][value]"=large \
  -d "custom_fields[1][dropdown][options][1][label]"=Large
War diese Seite hilfreich?
JaNein
Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unseren Produkt-Changelog an.
Fragen? Sales-Team kontaktieren.
Unterstützt von Markdoc
Auf dieser Seite
Checkout-Sitzung erstellen
Benutzerdefinierte Felder abrufen
Nutzerdefiniertes Feld verwenden
Ein Feld als optional kennzeichnen
Dropdown-Feld hinzufügen
Ein reines Zahlenfeld hinzufügen
Nutzerdefinierte Felder für ein Abonnement abrufen
Zeichenlängenvalidierungen hinzufügen
Standardwerte hinzufügen
Verwendete Produkte
Checkout
Payments