Benutzerdefinierte Felder hinzufügen
Vorsicht
Verwenden Sie keine benutzerdefinierten Felder, um geschützte, persönliche oder sensible Daten oder Informationen zu erfassen, die gesetzlich eingeschränkt sind.
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.
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.
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 Kund/innen 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.
Benutzerdefinierte Felder abrufen
Wenn Ihr/e Kunde/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" }