# Bezahlvorgang mit benutzerdefinierten Komponenten erweitern Zeigen Sie in Checkout-Sitzungen benutzerdefinierten Text an und erfassen Sie zusätzliche Informationen. # Gehostete Seite > This is a Gehostete Seite for when platform is web and payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/custom-components?platform=web&payment-ui=stripe-hosted. ## Benutzerdefinierte Felder hinzufügen 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. > Verwenden Sie keine nutzerdefinierten Felder, um persönliche, geschützte 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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-custom_fields) 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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-locale) verwenden, um die Sprache Ihrer Checkout-Sitzung an die Sprache Ihrer Label anzupassen. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" \ -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" ``` ![](https://d37ugbyn3rpeym.cloudfront.net/videos/checkout/custom_fields_embedded.mov) ### Benutzerdefinierte Felder abrufen Wenn Ihr Kunde/Ihre Kundin die Checkout-Sitzung abschließt, senden wir eine [checkout.session.completed](https://docs.stripe.com/api/events/types.md#event_types-checkout.session.completed) *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) mit den ausgefüllten Feldern. Beispiel-Nutzlast für `checkout.session.completed`: ```json { "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" } ``` Sie können benutzerdefinierte Feldwerte auch im Dashboard nachschlagen und bearbeiten, indem Sie auf der Registerkarte [Transaktionen](https://dashboard.stripe.com/payments) auf eine bestimmte Zahlung klicken oder benutzerdefinierte Feldwerte beim Exportieren Ihrer Zahlungen aus dem [Dashboard](https://dashboard.stripe.com/payments) einfügen. ### Benutzerdefiniertes 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. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" \ -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" ``` ![](https://b.stripecdn.com/docs-statics-srv/assets/optional.bf0c1564296ff02264bd5e8c066a6034.png) #### 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. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" \ -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](https://b.stripecdn.com/docs-statics-srv/assets/dropdown.4501d199ebe009030c2be6935cfdf2dd.png) #### 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. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" \ -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](https://docs.stripe.com/api/checkout/sessions/list.md#list_checkout_sessions-subscription) können Sie die mit einem Abonnement verknüpften nutzerdefinierten Felder abrufen, indem Sie die Checkout-Sitzung abfragen, die den Parameter erstellt hat. ```curl curl -G https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "subscription={{SUBSCRIPTION_ID}}" ``` #### Validierungen der Zeichenlänge hinzufügen Sie können optional eine [Anforderung](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-custom_fields-numeric-maximum_length) für die minimale und die maximale Zeichenlänge für die Feldtypen `text` und `numeric` festlegen. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" \ -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](https://b.stripecdn.com/docs-statics-srv/assets/between-validation.20431cd8e0c03a028843945d1f1ea314.png) #### Standardwerte hinzufügen Optional können Sie einen Standardwert für die Feldtypen [Text](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-custom_fields-text-default_value), [Zahlen](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-custom_fields-numeric-default_value) und [Dropdown](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-custom_fields-dropdown-default_value) angeben. Standardwerte werden auf der Bezahlseite automatisch ausgefüllt. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" \ -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" ``` ## Text und Richtlinien anpassen Wenn Kundinnen und Kunden mit Stripe Checkout bezahlen, können Sie zusätzlichen Text wie Versand- und Bearbeitungszeiten anzeigen. > Es ist Ihnen nicht gestattet, diese Funktion zu verwenden, um nutzerdefinierten Text zu erstellen, der gegen den von Stripe generierten Text für Checkout, Ihre Verpflichtungen aus Ihrer Vereinbarung mit Stripe, die Richtlinien von Stripe und geltende Gesetze verstößt oder Unklarheiten hervorruft. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d mode=payment \ -d "shipping_address_collection[allowed_countries][0]=US" \ --data-urlencode "custom_text[shipping_address][message]=Please note that we can't guarantee 2-day delivery for PO boxes at this time." \ --data-urlencode "custom_text[submit][message]=We'll email you instructions on how to get started." \ --data-urlencode "custom_text[after_submit][message]=Learn more about **your purchase** on our [product page](https://www.stripe.com/)." \ --data-urlencode "success_url=https://example.com/success" ``` ![Benutzerdefinierter Text in der Nähe der Versandadressenerfassung](https://b.stripecdn.com/docs-statics-srv/assets/shipping-address-custom-text.b0b578d66d2bd415d0b0fe03106d27df.png) Benutzerdefinierter Text neben den Feldern zur Erfassung der Versandadresse ![Benutzerdefinierter Text über der Schaltfläche zum Bezahlen](https://b.stripecdn.com/docs-statics-srv/assets/submit-custom-text.bf46135c06b7c33c1ce9c9b09e4206c9.png) Benutzerdefinierter Text über der Schaltfläche **Bezahlen** ![Benutzerdefinierter Text unter der Schaltfläche zum Bezahlen](https://b.stripecdn.com/docs-statics-srv/assets/custom-text-after-submit.32dbd97008b3f189145bcd07c4562bb4.png) Benutzerdefinierter Text nach der Schaltfläche **Bezahlen** Ihr nutzerdefinierter Text kann bis zu 1200 Zeichen lang sein. Stripe Checkout ist jedoch auf Konversion ausgerichtet und das Hinzufügen zusätzlicher Informationen kann sich auf Ihre Konversionsrate auswirken. Sie können wichtige Informationen per Fettdruck hervorheben oder über die [Markdown-Syntax](https://www.markdownguide.org/cheat-sheet/) einen Link einfügen. ### Die Schaltfläche „Absenden“ anpassen Um Checkout besser auf Ihr Geschäftsmodell abzustimmen, konfigurieren Sie den Text, der auf der Checkout-Schaltfläche „Absenden“ für einmalige Käufe angezeigt wird. Definieren Sie einen `submit_type` in Ihrer Sitzung. In diesem Beispiel (für eine Spende von 5 USD) zeigt Ihre benutzerdefinierte Checkout-Absendeschaltfläche **5,00 USD spenden** an. Eine vollständige Liste der Optionen für `submit_type` finden Sie in der [API-Dokumentation](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-submit_type). ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d submit_type=donate \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" ``` ## Lokalisierung und unterstützte Sprachen Standardmäßig stellt Checkout den Standort des Browsers Ihrer Kundin/Ihres Kunden fest und zeigt eine übersetzte Version der Seite in deren/dessen Sprache an, sofern Stripe dies [unterstützt](https://support.stripe.com/questions/supported-languages-for-stripe-checkout). Sie können das Browser-Gebietsschema für Checkout überschreiben, indem Sie beim Erstellen einer Checkout-Sitzung den [Parameter](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-locale) `locale` übergeben. Checkout nutzt das Gebietsschema auch zur Formatierung von Zahlen und Währungen. Wenn Sie beispielsweise ein Produkt verkaufen, dessen Preis in EUR festgelegt wurde und die Region auf `auto` festgelegt ist, zeigt ein auf Englisch (`en`) konfigurierter Browser 25.00 € an, ein auf Deutsch (`de`) konfigurierter Browser stattdessen 25,00 €. ### Richtlinien und Kontaktinformationen anpassen In Checkout können Sie Ihren Kundinnen und Kunden Ihre Richtlinien für Rückgabe und Rückerstattung und sonstige rechtliche Hinweise sowie Ihre Support-Kontaktinformationen anzeigen lassen. In den [Checkout-Einstellungen](https://dashboard.stripe.com/settings/checkout) können Sie unter anderem folgende Anzeigeeinstellungen konfigurieren: - Details zu Ihren Richtlinien für Rückgabe und Rückerstattung - Ihre Support-Telefonnummer, E-Mail-Adresse und Website - Links zu Ihren Allgemeinen Geschäftsbedingungen und Ihrer Datenschutzerklärung Wenn Sie diese Informationen anzeigen lassen, können Sie das Vertrauen potenzieller Käuferinnen und Käufer gewinnen und Kaufabbrüche minimieren. ### Support-Informationen und Richtlinien konfigurieren Fügen Sie in den [Checkout-Einstellungen](https://dashboard.stripe.com/settings/checkout) Support-Kontaktinformationen zu Ihren Sitzungen hinzu, indem Sie **Kontaktinformationen** aktivieren. Auf ähnliche Weise fügen Sie Links zu Ihren **Allgemeinen Geschäftsbedingungen** und Ihrer **Datenschutzerklärung** zu Ihren Sitzungen hinzu, indem Sie die **Rechtlichen Hinweise** aktivieren. Wenn Kundinnen/Kunden nach Durchführung des Bezahlvorgangs implizit Ihren rechtlichen Hinweisen zustimmen müssen, aktivieren Sie das Kontrollkästchen **Zustimmung zu rechtlichen Bedingungen anzeigen**. Sie müssen Ihre Support-Kontaktinformationen und Links zu rechtlichen Richtlinien in Ihren [Einstellungen für öffentliche Details](https://dashboard.stripe.com/settings/public) hinzufügen. In der folgenden Vorschau sehen Sie, wie Checkout ein Dialogfeld mit den Support-Kontaktinformationen, Links zu den rechtlichen Hinweisen des Geschäfts und Informationen zu den Zahlungsbedingungen anzeigt. ![Eine Bezahlseite mit Kontaktinformationen.](https://b.stripecdn.com/docs-statics-srv/assets/contact-modal.2b81bc2e74657f7c94a45a743439c81f.png) Vorschau der Kontaktinformationen in Checkout. ![Eine Bezahlseite mit rechtlichen Hinweisen.](https://b.stripecdn.com/docs-statics-srv/assets/legal-modal.9351cb51408c2a9f5c0ae23aab03e138.png) Vorschau der rechtlichen Hinweise in Checkout. ### Richtlinien für Rückgabe und Rückerstattung konfigurieren Sie können Ihre Richtlinien für Rückgabe, Rückerstattung oder Umtausch anzeigen lassen, indem Sie **Rückgabe- und Rückerstattungsrichtlinien** aktivieren. Unternehmen, die physische Waren verkaufen, haben in den meisten Fällen Rückgaberichtlinien, Unternehmen mit digitalen Artikeln oder kundenspezifischen physischen Produkten in der Regel Rückerstattungsrichtlinien. Da sie sich nicht gegenseitig ausschließen, können Sie beide Optionen auswählen, wenn Ihr Unternehmen Waren beider Kategorien verkauft. Sie können unter anderem folgende Rückgabe- und Rückerstattungsdetails bearbeiten: - Ob Sie Rückgabe, Rückerstattung oder Umtausch akzeptieren - Ob Rückgabe, Rückerstattung oder Umtausch kostenlos ist oder eine Gebühr fällig wird - Wie viele Tage nach dem Kauf Rückgaben, Rückerstattungen oder Umtausch möglich ist - Wie Kundinnen/Kunden Artikel zurückgeben können - Ob Sie Rückgaben im Geschäft akzeptieren - Link zur vollständigen Richtlinie für Rückgabe und Rückerstattung - Eine individuelle Benachrichtigung Wenn Sie Rückgabe, Rückerstattung oder Umtausch akzeptieren, hebt Checkout die Richtlinie für Kundinnen/Kunden hervor. In der folgenden Vorschau sehen Sie, wie Checkout eine Rückgaberichtlinie anzeigt. In diesem Beispiel deckt die Richtlinie Käufe ab, die 60 Tage lang gegen Erstattung oder Umtausch zurückgesendet oder im Geschäft zurückgegeben werden können. Ähnliche Informationen können Sie für Rückerstattungen anzeigen. ![Vorschau der Rückgaberichtlinien in Checkout](https://b.stripecdn.com/docs-statics-srv/assets/return-policy-modal.0c7a9ff71b8bc2c155842532801e06a8.png) Vorschau der Rückgaberichtlinien in Checkout. ![Vorschau der hervorgehobenen Richtlinien in Checkout](https://b.stripecdn.com/docs-statics-srv/assets/policy-highlight.334828420693a33d376977a2c0fe5851.png) Vorschau der hervorgehobenen Richtlinien in Checkout. #### Vereinbarung über die Allgemeinen Geschäftsbedingungen einholen Unternehmen verlangen oft von ihren Kundinnen/Kunden, dass sie deren Nutzungsbedingungen zustimmen, bevor sie bezahlen können. Dies kann von der Art des Produkts oder Abonnements abhängen. Checkout hilft Ihnen, die erforderliche Zustimmung einzuholen, indem Kund/innen aufgefordert werden, Ihre Bedingungen vor der Zahlung zu akzeptieren. ![Vereinbarung über die Nutzungsbedingungen erfassen](https://b.stripecdn.com/docs-statics-srv/assets/terms-of-service-consent-collection.dec90bde6d1a3c5d4c0b3e7b8e644a52.png) Vereinbarung über die Nutzungsbedingungen erfassen Sie können eine Vereinbarung über die allgemeinen Geschäftsbedingungen mit Stripe Checkout abschließen, wenn Sie eine Sitzung erstellen: ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d mode=payment \ --data-urlencode "success_url=https://example.com/success" \ -d "consent_collection[terms_of_service]=required" \ --data-urlencode "custom_text[terms_of_service_acceptance][message]=I agree to the [Terms of Service](https://example.com/terms)" ``` Wenn `consent_collection.terms_of_service='required'`, zeigt Checkout dynamisch ein Kontrollkästchen zur Erfassung der Vereinbarung über die Nutzungsbedingungen des/der Kund/in an. Wenn `consent_collection.terms_of_service='none'` ist, zeigt Checkout das Kontrollkästchen nicht an und fordert die Kundinnen/Kunden nicht auf, die Allgemeinen Geschäftsbedingungen zu akzeptieren. Bevor Sie die Zustimmung zu Ihren Bedingungen einholen, legen Sie die URL Ihrer allgemeinen Geschäftsbedingungen in den [öffentlichen Details](https://dashboard.stripe.com/settings/public) Ihres Unternehmens fest. Das Festlegen einer URL für die Datenschutzerklärung ist optional. Checkout verweist auch auf Ihre Datenschutzerklärung, wenn in Ihren [öffentlichen Details](https://dashboard.stripe.com/settings/public) eine URL zu Ihrer Datenschutzerklärung festgelegt ist. Nachdem der Bezahlvorgang kundenseitig abgeschlossen ist, können Sie überprüfen, ob Ihre allgemeinen Geschäftsbedingungen akzeptiert wurden, indem Sie das Session-Objekt im Webhook `checkout.session.completed` anzeigen oder die Sitzung über die API abrufen. Wenn die Bedingungen akzeptiert wurden, wird das Feld [consent.terms_of_service](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-consent) der Sitzung auf `accepted` gesetzt. Sie können den Text, der neben dem Kontrollkästchen angezeigt wird, mithilfe von `custom_text.terms_of_service_acceptance` anpassen. Sie müssen `consent_collection.terms_of_service='required'` festlegen. Um Ihre eigenen Bedingungen zu verwenden, fügen Sie einen Markdown-Link ein. Beispiel: `I agree to the [Terms of Service](https://example.com/terms)` > Wenden Sie sich an Ihre Rechts- und Compliance-Beratung, bevor Sie Änderungen an diesem Text vornehmen. Sie dürfen diese Funktion nicht verwenden, um benutzerdefinierten Text anzuzeigen, der gegen den von Stripe generierten Text für Checkout, Ihre Verpflichtungen aus Ihrer Vereinbarung mit Stripe, die Richtlinien von Stripe und geltende Gesetze verstößt oder Unklarheiten hervorruft. #### Zustimmung für Werbe-E-Mails einholen Sie können Werbe-E-Mails versenden, um Kundinnen/Kunden über neue Produkte zu informieren und Gutscheine und Rabatte zu teilen. Bevor Sie dies tun, müssen Sie [ihre Zustimmung zum Erhalt von Werbe-E-Mails einholen](https://docs.stripe.com/payments/checkout/promotional-emails-consent.md). ## Wiederverwendungsvereinbarung und Abonnementbedingungen für Zahlungsmethoden anpassen Wenn sich eine Sitzung entweder im Modus `setup` oder im Modus `subscription` befindet oder wenn sie sich im Modus `payment` mit festgelegtem `setup_future_usage` befindet, zeigt Checkout eine Meldung über die Wiederverwendung der Zahlungsmethode des Kunden/der Kundin an. Die Meldung kann Informationen speziell für die ausgewählte Zahlungsmethode enthalten. Sie können den Standardtext ausblenden oder anpassen, nicht jedoch den Text speziell für die Zahlungsmethode. Bei einem Abonnement kann der nutzerdefinierte Text beispielsweise folgende Informationen enthalten: - Ein Link zu Ihren Abonnementbedingungen - Ein Link zu Ihrem Kundenportal - Stornomechanismen und -richtlinien ![Standardanzeige der Wiederverwendungsvereinbarung für Zahlungsmethoden im Abonnementmodus](https://b.stripecdn.com/docs-statics-srv/assets/default-subscription-mode-payment-method-reuse-agreement.caee311155d9948637a53aafded801af.png) Standardmäßige Wiederverwendungsvereinbarung für Zahlungsmethoden im Abonnementmodus > Wenn Sie diesen Text anpassen, sind Sie für die Einhaltung jeglicher Vorschriften verantwortlich. Dies umfasst auch die Aktualisierung dieses Textes, wenn sich die Regeln der Kartennetzwerke und lokale Vorschriften ändern. Verwenden Sie diese Funktion nur, wenn Sie sich mit Ihrer Rechtsabteilung beraten oder nutzerdefinierten Text festgelegt haben, der Informationen zur Wiederverwendung der Zahlungsmethode enthält. Stellen Sie sicher, dass Ihr benutzerdefinierter Text alle Modi abdeckt, die Sie unterstützen möchten. Um den Text der Wiederverwendungsvereinbarung für Zahlungsmethoden auszublenden, legen Sie `consent_collection.payment_method_reuse_agreement.position='hidden'` fest. Checkout nicht die Standardsprache für die Wiederverwendung der Zahlungsmethode an. Wenn Sie Ihren eigenen Text anstelle der Standardsprache von Stripe festlegen möchten, legen Sie `custom_text.after_submit.message` fest. Sie können auch `custom_text.submit` oder `custom_text.terms_of_service_acceptance` verwenden, um Ihre eigene Version dieser Sprache anzuzeigen. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d mode=subscription \ --data-urlencode "success_url=https://example.com/success" \ -d "consent_collection[payment_method_reuse_agreement][position]=hidden" \ --data-urlencode "custom_text[after_submit][message]=You can cancel your subscription at any time by [logging into your account](https://www.example.com/)" ``` # Eingebettete Seite > This is a Eingebettete Seite for when platform is web and payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/checkout/custom-components?platform=web&payment-ui=embedded-form. Sie können dem Zahlungsformular benutzerdefinierte Felder hinzufügen, um zusätzliche Informationen von Ihren Kundinnen und Kunden zu erfassen. Außerdem können Sie den Text, den Ihre Kundinnen und Kunden sehen, sowie die von Checkout angezeigten Richtlinien anpassen. ## Benutzerdefinierte Felder hinzufügen 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. > Verwenden Sie keine nutzerdefinierten Felder, um persönliche, geschützte 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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-custom_fields) 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](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-locale) verwenden, um die Sprache Ihrer Checkout-Sitzung an die Sprache Ihrer Label anzupassen. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" \ -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" ``` ![](https://d37ugbyn3rpeym.cloudfront.net/videos/checkout/custom_fields_embedded.mov) ### Benutzerdefinierte Felder abrufen Wenn Ihr Kunde/Ihre Kundin die Checkout-Sitzung abschließt, senden wir eine [checkout.session.completed](https://docs.stripe.com/api/events/types.md#event_types-checkout.session.completed) *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) mit den ausgefüllten Feldern. Beispiel-Nutzlast für `checkout.session.completed`: ```json { "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" } ``` Sie können benutzerdefinierte Feldwerte auch im Dashboard nachschlagen und bearbeiten, indem Sie auf der Registerkarte [Transaktionen](https://dashboard.stripe.com/payments) auf eine bestimmte Zahlung klicken oder benutzerdefinierte Feldwerte beim Exportieren Ihrer Zahlungen aus dem [Dashboard](https://dashboard.stripe.com/payments) einfügen. ### Benutzerdefiniertes 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. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" \ -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" ``` ![](https://b.stripecdn.com/docs-statics-srv/assets/optional.bf0c1564296ff02264bd5e8c066a6034.png) #### 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. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" \ -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](https://b.stripecdn.com/docs-statics-srv/assets/dropdown.4501d199ebe009030c2be6935cfdf2dd.png) #### 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. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" \ -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](https://docs.stripe.com/api/checkout/sessions/list.md#list_checkout_sessions-subscription) können Sie die mit einem Abonnement verknüpften nutzerdefinierten Felder abrufen, indem Sie die Checkout-Sitzung abfragen, die den Parameter erstellt hat. ```curl curl -G https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "subscription={{SUBSCRIPTION_ID}}" ``` #### Validierungen der Zeichenlänge hinzufügen Sie können optional eine [Anforderung](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-custom_fields-numeric-maximum_length) für die minimale und die maximale Zeichenlänge für die Feldtypen `text` und `numeric` festlegen. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" \ -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](https://b.stripecdn.com/docs-statics-srv/assets/between-validation.20431cd8e0c03a028843945d1f1ea314.png) #### Standardwerte hinzufügen Optional können Sie einen Standardwert für die Feldtypen [Text](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-custom_fields-text-default_value), [Zahlen](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-custom_fields-numeric-default_value) und [Dropdown](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-custom_fields-dropdown-default_value) angeben. Standardwerte werden auf der Bezahlseite automatisch ausgefüllt. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" \ -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" ``` ## Text und Richtlinien anpassen Wenn Kundinnen und Kunden mit Stripe Checkout bezahlen, können Sie zusätzlichen Text wie Versand- und Bearbeitungszeiten anzeigen. > Es ist Ihnen nicht gestattet, diese Funktion zu verwenden, um nutzerdefinierten Text zu erstellen, der gegen den von Stripe generierten Text für Checkout, Ihre Verpflichtungen aus Ihrer Vereinbarung mit Stripe, die Richtlinien von Stripe und geltende Gesetze verstößt oder Unklarheiten hervorruft. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d mode=payment \ -d "shipping_address_collection[allowed_countries][0]=US" \ --data-urlencode "custom_text[shipping_address][message]=Please note that we can't guarantee 2-day delivery for PO boxes at this time." \ --data-urlencode "custom_text[submit][message]=We'll email you instructions on how to get started." \ --data-urlencode "custom_text[after_submit][message]=Learn more about **your purchase** on our [product page](https://www.stripe.com/)." \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` ![Benutzerdefinierter Text in der Nähe der Versandadressenerfassung](https://b.stripecdn.com/docs-statics-srv/assets/shipping-address-custom-text.b0b578d66d2bd415d0b0fe03106d27df.png) Benutzerdefinierter Text neben den Feldern zur Erfassung der Versandadresse ![Benutzerdefinierter Text über der Schaltfläche zum Bezahlen](https://b.stripecdn.com/docs-statics-srv/assets/submit-custom-text.bf46135c06b7c33c1ce9c9b09e4206c9.png) Benutzerdefinierter Text über der Schaltfläche **Bezahlen** ![Benutzerdefinierter Text unter der Schaltfläche zum Bezahlen](https://b.stripecdn.com/docs-statics-srv/assets/custom-text-after-submit.32dbd97008b3f189145bcd07c4562bb4.png) Benutzerdefinierter Text nach der Schaltfläche **Bezahlen** Ihr nutzerdefinierter Text kann bis zu 1200 Zeichen lang sein. Stripe Checkout ist jedoch auf Konversion ausgerichtet und das Hinzufügen zusätzlicher Informationen kann sich auf Ihre Konversionsrate auswirken. Sie können wichtige Informationen per Fettdruck hervorheben oder über die [Markdown-Syntax](https://www.markdownguide.org/cheat-sheet/) einen Link einfügen. ### Die Schaltfläche „Absenden“ anpassen Um Checkout besser auf Ihr Geschäftsmodell abzustimmen, konfigurieren Sie den Text, der auf der Checkout-Schaltfläche „Absenden“ für einmalige Käufe angezeigt wird. Definieren Sie einen `submit_type` in Ihrer Sitzung. In diesem Beispiel (für eine Spende von 5 USD) zeigt Ihre benutzerdefinierte Checkout-Absendeschaltfläche **5,00 USD spenden** an. Eine vollständige Liste der Optionen für `submit_type` finden Sie in der [API-Dokumentation](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-submit_type). ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d submit_type=donate \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d mode=payment \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` ## Lokalisierung und unterstützte Sprachen Standardmäßig stellt Checkout den Standort des Browsers Ihrer Kundin/Ihres Kunden fest und zeigt eine übersetzte Version der Seite in deren/dessen Sprache an, sofern Stripe dies [unterstützt](https://support.stripe.com/questions/supported-languages-for-stripe-checkout). Sie können das Browser-Gebietsschema für Checkout überschreiben, indem Sie beim Erstellen einer Checkout-Sitzung den [Parameter](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-locale) `locale` übergeben. Checkout nutzt das Gebietsschema auch zur Formatierung von Zahlen und Währungen. Wenn Sie beispielsweise ein Produkt verkaufen, dessen Preis in EUR festgelegt wurde und die Region auf `auto` festgelegt ist, zeigt ein auf Englisch (`en`) konfigurierter Browser 25.00 € an, ein auf Deutsch (`de`) konfigurierter Browser stattdessen 25,00 €. ### Richtlinien und Kontaktinformationen anpassen In Checkout können Sie Ihren Kundinnen und Kunden Ihre Richtlinien für Rückgabe und Rückerstattung und sonstige rechtliche Hinweise sowie Ihre Support-Kontaktinformationen anzeigen lassen. In den [Checkout-Einstellungen](https://dashboard.stripe.com/settings/checkout) können Sie unter anderem folgende Anzeigeeinstellungen konfigurieren: - Details zu Ihren Richtlinien für Rückgabe und Rückerstattung - Ihre Support-Telefonnummer, E-Mail-Adresse und Website - Links zu Ihren Allgemeinen Geschäftsbedingungen und Ihrer Datenschutzerklärung Wenn Sie diese Informationen anzeigen lassen, können Sie das Vertrauen potenzieller Käuferinnen und Käufer gewinnen und Kaufabbrüche minimieren. ### Support-Informationen und Richtlinien konfigurieren Fügen Sie in den [Checkout-Einstellungen](https://dashboard.stripe.com/settings/checkout) Support-Kontaktinformationen zu Ihren Sitzungen hinzu, indem Sie **Kontaktinformationen** aktivieren. Auf ähnliche Weise fügen Sie Links zu Ihren **Allgemeinen Geschäftsbedingungen** und Ihrer **Datenschutzerklärung** zu Ihren Sitzungen hinzu, indem Sie die **Rechtlichen Hinweise** aktivieren. Wenn Kundinnen/Kunden nach Durchführung des Bezahlvorgangs implizit Ihren rechtlichen Hinweisen zustimmen müssen, aktivieren Sie das Kontrollkästchen **Zustimmung zu rechtlichen Bedingungen anzeigen**. Sie müssen Ihre Support-Kontaktinformationen und Links zu rechtlichen Richtlinien in Ihren [Einstellungen für öffentliche Details](https://dashboard.stripe.com/settings/public) hinzufügen. In der folgenden Vorschau sehen Sie, wie Checkout ein Dialogfeld mit den Support-Kontaktinformationen, Links zu den rechtlichen Hinweisen des Geschäfts und Informationen zu den Zahlungsbedingungen anzeigt. ![Eine Bezahlseite mit Kontaktinformationen.](https://b.stripecdn.com/docs-statics-srv/assets/contact-modal.2b81bc2e74657f7c94a45a743439c81f.png) Vorschau der Kontaktinformationen in Checkout. ![Eine Bezahlseite mit rechtlichen Hinweisen.](https://b.stripecdn.com/docs-statics-srv/assets/legal-modal.9351cb51408c2a9f5c0ae23aab03e138.png) Vorschau der rechtlichen Hinweise in Checkout. ### Richtlinien für Rückgabe und Rückerstattung konfigurieren Sie können Ihre Richtlinien für Rückgabe, Rückerstattung oder Umtausch anzeigen lassen, indem Sie **Rückgabe- und Rückerstattungsrichtlinien** aktivieren. Unternehmen, die physische Waren verkaufen, haben in den meisten Fällen Rückgaberichtlinien, Unternehmen mit digitalen Artikeln oder kundenspezifischen physischen Produkten in der Regel Rückerstattungsrichtlinien. Da sie sich nicht gegenseitig ausschließen, können Sie beide Optionen auswählen, wenn Ihr Unternehmen Waren beider Kategorien verkauft. Sie können unter anderem folgende Rückgabe- und Rückerstattungsdetails bearbeiten: - Ob Sie Rückgabe, Rückerstattung oder Umtausch akzeptieren - Ob Rückgabe, Rückerstattung oder Umtausch kostenlos ist oder eine Gebühr fällig wird - Wie viele Tage nach dem Kauf Rückgaben, Rückerstattungen oder Umtausch möglich ist - Wie Kundinnen/Kunden Artikel zurückgeben können - Ob Sie Rückgaben im Geschäft akzeptieren - Link zur vollständigen Richtlinie für Rückgabe und Rückerstattung - Eine individuelle Benachrichtigung Wenn Sie Rückgabe, Rückerstattung oder Umtausch akzeptieren, hebt Checkout die Richtlinie für Kundinnen/Kunden hervor. In der folgenden Vorschau sehen Sie, wie Checkout eine Rückgaberichtlinie anzeigt. In diesem Beispiel deckt die Richtlinie Käufe ab, die 60 Tage lang gegen Erstattung oder Umtausch zurückgesendet oder im Geschäft zurückgegeben werden können. Ähnliche Informationen können Sie für Rückerstattungen anzeigen. ![Vorschau der Rückgaberichtlinien in Checkout](https://b.stripecdn.com/docs-statics-srv/assets/return-policy-modal.0c7a9ff71b8bc2c155842532801e06a8.png) Vorschau der Rückgaberichtlinien in Checkout. ![Vorschau der hervorgehobenen Richtlinien in Checkout](https://b.stripecdn.com/docs-statics-srv/assets/policy-highlight.334828420693a33d376977a2c0fe5851.png) Vorschau der hervorgehobenen Richtlinien in Checkout. #### Vereinbarung über die Allgemeinen Geschäftsbedingungen einholen Unternehmen verlangen oft von ihren Kundinnen/Kunden, dass sie deren Nutzungsbedingungen zustimmen, bevor sie bezahlen können. Dies kann von der Art des Produkts oder Abonnements abhängen. Checkout hilft Ihnen, die erforderliche Zustimmung einzuholen, indem Kund/innen aufgefordert werden, Ihre Bedingungen vor der Zahlung zu akzeptieren. ![Vereinbarung über die Nutzungsbedingungen erfassen](https://b.stripecdn.com/docs-statics-srv/assets/terms-of-service-consent-collection.dec90bde6d1a3c5d4c0b3e7b8e644a52.png) Vereinbarung über die Nutzungsbedingungen erfassen Sie können eine Vereinbarung über die allgemeinen Geschäftsbedingungen mit Stripe Checkout abschließen, wenn Sie eine Sitzung erstellen: ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=2" \ -d mode=payment \ -d "consent_collection[terms_of_service]=required" \ --data-urlencode "custom_text[terms_of_service_acceptance][message]=I agree to the [Terms of Service](https://example.com/terms)" \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" ``` Wenn `consent_collection.terms_of_service='required'`, zeigt Checkout dynamisch ein Kontrollkästchen zur Erfassung der Vereinbarung über die Nutzungsbedingungen des/der Kund/in an. Wenn `consent_collection.terms_of_service='none'` ist, zeigt Checkout das Kontrollkästchen nicht an und fordert die Kundinnen/Kunden nicht auf, die Allgemeinen Geschäftsbedingungen zu akzeptieren. Bevor Sie die Zustimmung zu Ihren Bedingungen einholen, legen Sie die URL Ihrer allgemeinen Geschäftsbedingungen in den [öffentlichen Details](https://dashboard.stripe.com/settings/public) Ihres Unternehmens fest. Das Festlegen einer URL für die Datenschutzerklärung ist optional. Checkout verweist auch auf Ihre Datenschutzerklärung, wenn in Ihren [öffentlichen Details](https://dashboard.stripe.com/settings/public) eine URL zu Ihrer Datenschutzerklärung festgelegt ist. Nachdem der Bezahlvorgang kundenseitig abgeschlossen ist, können Sie überprüfen, ob Ihre allgemeinen Geschäftsbedingungen akzeptiert wurden, indem Sie das Session-Objekt im Webhook `checkout.session.completed` anzeigen oder die Sitzung über die API abrufen. Wenn die Bedingungen akzeptiert wurden, wird das Feld [consent.terms_of_service](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-consent) der Sitzung auf `accepted` gesetzt. Sie können den Text, der neben dem Kontrollkästchen angezeigt wird, mithilfe von `custom_text.terms_of_service_acceptance` anpassen. Sie müssen `consent_collection.terms_of_service='required'` festlegen. Um Ihre eigenen Bedingungen zu verwenden, fügen Sie einen Markdown-Link ein. Beispiel: `I agree to the [Terms of Service](https://example.com/terms)` > Wenden Sie sich an Ihre Rechts- und Compliance-Beratung, bevor Sie Änderungen an diesem Text vornehmen. Sie dürfen diese Funktion nicht verwenden, um benutzerdefinierten Text anzuzeigen, der gegen den von Stripe generierten Text für Checkout, Ihre Verpflichtungen aus Ihrer Vereinbarung mit Stripe, die Richtlinien von Stripe und geltende Gesetze verstößt oder Unklarheiten hervorruft. #### Zustimmung für Werbe-E-Mails einholen Sie können Werbe-E-Mails versenden, um Kundinnen/Kunden über neue Produkte zu informieren und Gutscheine und Rabatte zu teilen. Bevor Sie dies tun, müssen Sie [ihre Zustimmung zum Erhalt von Werbe-E-Mails einholen](https://docs.stripe.com/payments/checkout/promotional-emails-consent.md). ## Wiederverwendungsvereinbarung und Abonnementbedingungen für Zahlungsmethoden anpassen Wenn sich eine Sitzung entweder im Modus `setup` oder im Modus `subscription` befindet oder wenn sie sich im Modus `payment` mit festgelegtem `setup_future_usage` befindet, zeigt Checkout eine Meldung über die Wiederverwendung der Zahlungsmethode des Kunden/der Kundin an. Die Meldung kann Informationen speziell für die ausgewählte Zahlungsmethode enthalten. Sie können den Standardtext ausblenden oder anpassen, nicht jedoch den Text speziell für die Zahlungsmethode. Bei einem Abonnement kann der nutzerdefinierte Text beispielsweise folgende Informationen enthalten: - Ein Link zu Ihren Abonnementbedingungen - Ein Link zu Ihrem Kundenportal - Stornomechanismen und -richtlinien ![Standardanzeige der Wiederverwendungsvereinbarung für Zahlungsmethoden im Abonnementmodus](https://b.stripecdn.com/docs-statics-srv/assets/default-subscription-mode-payment-method-reuse-agreement.caee311155d9948637a53aafded801af.png) Standardmäßige Wiederverwendungsvereinbarung für Zahlungsmethoden im Abonnementmodus > Wenn Sie diesen Text anpassen, sind Sie für die Einhaltung jeglicher Vorschriften verantwortlich. Dies umfasst auch die Aktualisierung dieses Textes, wenn sich die Regeln der Kartennetzwerke und lokale Vorschriften ändern. Verwenden Sie diese Funktion nur, wenn Sie sich mit Ihrer Rechtsabteilung beraten oder nutzerdefinierten Text festgelegt haben, der Informationen zur Wiederverwendung der Zahlungsmethode enthält. Stellen Sie sicher, dass Ihr benutzerdefinierter Text alle Modi abdeckt, die Sie unterstützen möchten. Um den Text der Wiederverwendungsvereinbarung für Zahlungsmethoden auszublenden, legen Sie `consent_collection.payment_method_reuse_agreement.position='hidden'` fest. Checkout nicht die Standardsprache für die Wiederverwendung der Zahlungsmethode an. Wenn Sie Ihren eigenen Text anstelle der Standardsprache von Stripe festlegen möchten, legen Sie `custom_text.after_submit.message` fest. Sie können auch `custom_text.submit` oder `custom_text.terms_of_service_acceptance` verwenden, um Ihre eigene Version dieser Sprache anzuzeigen. ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -d "line_items[0][price]={{PRICE_ID}}" \ -d "line_items[0][quantity]=1" \ -d mode=subscription \ -d ui_mode=embedded_page \ --data-urlencode "return_url=https://example.com/return" \ -d "consent_collection[payment_method_reuse_agreement][position]=hidden" \ --data-urlencode "custom_text[after_submit][message]=You can cancel your subscription at any time by [logging into your account](https://www.example.com/)" ``` # Checkout Elements > This is a Checkout Elements for when platform is web and payment-ui is elements. View the full page at https://docs.stripe.com/payments/checkout/custom-components?platform=web&payment-ui=elements. Benutzerdefinierte Komponenten sind bei Verwendung von Checkout Elements nicht erforderlich. Sie können die Elements in Ihrer eigenen Oberfläche zusammenstellen und bei Bedarf Ihre eigenen benutzerdefinierten Komponenten dazwischen einfügen.