# Zahlungsbeschreibungen in der Abrechnung mit Connect festlegen Erfahren Sie, wie Zahlungsbeschreibungen in der Abrechnung mit Connect funktionieren. Mit Zahlungsbeschreibungen werden Abbuchungen oder Zahlungen in Kontoauszügen beschrieben. Sie enthalten Informationen, die Banken und Kartennetzwerke benötigen, damit Kundinnen und Kunden ihre Kontoauszüge besser nachvollziehen können. Im Folgenden lernen Sie die [Anforderungen an Zahlungsbeschreibungen in der Abrechnung](https://docs.stripe.com/get-started/account/statement-descriptors.md) kennen. ## Statische Komponente für ein verbundenes Konto festlegen Zahlungsbeschreibungen in der Abrechnung enthalten eine statische Komponente und optional einen dynamischen Teil. Die statische Komponente kann Folgendes bedeuten: - Die gesamte Zahlungsbeschreibung in der Abrechnung ist statisch ([settings.payments.statement_descriptor](https://docs.stripe.com/api/accounts/object.md#account_object-settings-payments-statement_descriptor)). - Die erste Hälfte der Zahlungsbeschreibung in der Abrechnung ist statisch ([settings.card_payments.statement_descriptor_prefix](https://docs.stripe.com/api/accounts/object.md#account_object-settings-card_payments-statement_descriptor_prefix)), und die zweite Hälfte wird dynamisch anhand der Zahlung festgelegt. Für Ihre Plattform und die verbundenen Konten mit der Funktion `card_payments` muss eine Zahlungsbeschreibung in der Abrechnung und optional ein Präfix der Zahlungsbeschreibung in der Abrechnung eingerichtet sein. Beide Werte müssen mindestens 5 Zeichen lang sein. Für eine bestimmte Zahlung gilt je nach [Zahlungstyp](https://docs.stripe.com/connect/charges.md) die Zahlungsbeschreibung der Plattform oder des verbundenen Kontos. Die Zahlungsbeschreibung in der Abrechnung wird auf eine der folgenden Arten festgelegt: - Mit einem API-Aufruf zum [Erstellen oder Aktualisieren eines Kontos](https://docs.stripe.com/api/accounts.md) - Während des von Stripe gehosteten oder eingebetteten Onboardings - Über das vollständige Stripe-Dashboard oder das Express-Dashboard Verbundene Konten mit *Zugriff auf ein von Stripe gehostetes Dashboard* (Platforms can provide connected accounts with access to the full Stripe Dashboard or the Express Dashboard. Otherwise, platforms build an interface for connected accounts using embedded components or the Stripe API) können ihre eigenen Einstellungen für Zahlungsbeschreibungen in der Abrechnung aktualisieren. Sie können die Zahlungsbeschreibung in der Abrechnung und das Präfix eines Kontos vorab ausfüllen, wenn Sie den Endpoint [Konto erstellen](https://docs.stripe.com/api/accounts/create.md) aufrufen. Wenn während dem von Stripe gehosteten oder eingebetteten Onboarding `settings.payments.statement_descriptor` nicht festgelegt ist, generiert Stripe es durch Verknüpfen der folgenden Zeichenfolgen: 1. `business_profile.name` 1. „Doing Business As“ 1. `business_profile.url` 1. Der Name der juristischen Person (entweder `individual.first_name` + `individual.last_name` oder `company.name`). Wenn `settings.payments.statement_descriptor_prefix` nicht vorausgefüllt ist, legt Stripe es mit den ersten 10 Zeichen der Zahlungsbeschreibung in der Abrechnung fest. Wenn die erforderlichen Informationen nicht verfügbar sind, fordert das von Stripe gehostete oder eingebettete Onboarding das Konto auf, eine eigene Zahlungsbeschreibung in der Abrechnung und ein Präfix festzulegen. Nach dem Onboarding eines Kontos, das keinen Zugriff auf das vollständige Stripe-Dashboard hat, können Sie dessen `settings.payments.statement_descriptor` und `settings.card_payments.statement_descriptor_prefix` aktualisieren, indem Sie den Endpoint [Konto aktualisieren](https://docs.stripe.com/api/accounts/update.md) aufrufen. Für Konten, bei denen die Plattform das Onboarding übernimmt, müssen Sie die Zahlungsbeschreibung in der Abrechnung festlegen. #### Mit Controller-Eigenschaften ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d "controller[stripe_dashboard][type]=none" \ -d "controller[fees][payer]=application" \ -d "controller[losses][payments]=application" \ -d "controller[requirement_collection]=application" \ -d country=US \ -d business_type=company \ -d "business_profile[name]=Runners Club" \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[payments][statement_descriptor]=RUNNERS CLUB" ``` #### Mit Kontotyp ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d type=custom \ -d country=US \ -d business_type=company \ -d "business_profile[name]=Runners Club" \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[payments][statement_descriptor]=RUNNERS CLUB" ``` Wenn Sie den `business_profile.name` oder die `business_profile.url` eines Unternehmens oder den Namen des Unternehmens oder der Einzelperson aktualisieren, und die vorhandene Zahlungsbeschreibung in der Abrechnung auf Daten mit niedrigerer Priorität basiert, setzt Stripe die Zahlungsbeschreibung automatisch auf den Wert mit höherer Priorität zurück. Wenn die Zahlungsbeschreibung beispielsweise automatisch anhand der URL festgelegt wird und Sie den `business_profile.name` festlegen oder aktualisieren, setzt Stripe die Zahlungsbeschreibung zurück, damit sie dem Namen des Unternehmensprofils entspricht. Wenn die Zahlungsbeschreibung automatisch anhand des `business_profile.name` festgelegt wird und Sie den Namen des Unternehmens oder der Einzelperson festlegen oder aktualisieren, wird die Zahlungsbeschreibung nicht zurückgesetzt, da der `business_profile.name` eine höhere Priorität hat. Die Rangfolge ist `business_profile.name`, `business_profile.url` und dann der Name des Unternehmens oder der Einzelperson. Jede Aktualisierung der vollständigen Zahlungsbeschreibung in der Abrechnung veranlasst Stripe, das Präfix der Zahlungsbeschreibung automatisch auf eine verkürzte Version der aktualisierten Zahlungsbeschreibung festzulegen, auch wenn das vorherige Präfix manuell festgelegt wurde. ## Nutzung von Zahlungsbeschreibungen in der Abrechnung Die vollständige Zahlungsbeschreibung in der Abrechnung wird der Bank oder dem Kartennetzwerk zur Verfügung gestellt, die die Zahlung abwickelt. Bei Kartenzahlungen werden nur die ersten 22 Zeichen der vollständigen Zahlungsbeschreibung übermittelt. In der Abrechnung der Kundin/des Kunden wird die [statische Komponente](https://docs.stripe.com/connect/statement-descriptors.md#set-the-static-component-for-a-connected-account) des Plattformkontos für die folgenden Zahlungstypen verwendet: - Destination Charges ohne `on_behalf_of` - Separate Zahlungen und Überweisungen ohne `on_behalf_of` In der Abrechnung der Kundin/des Kunden wird die [statische Komponente](https://docs.stripe.com/connect/statement-descriptors.md#set-the-static-component-for-a-connected-account) des verbundenen Kontos für die folgenden Zahlungstypen verwendet: - Direct Charges - Destination Charges mit `on_behalf_of` - Separate Zahlungen und Überweisungen mit `on_behalf_of` Um die statische Komponente eines verbundenen Kontos nutzen zu können, muss das Konto über die Funktion `card_payments` verfügen. > Für API Versionen `2019-02-19` und neuer wird der [`statement_descriptor`](https://docs.stripe.com/api/charges/create.md#create_charge-statement_descriptor)-Parameter `/v1/charges` als dynamische Komponente behandelt und entspricht der Bereitstellung von `statement_descriptor_suffix`. > > Wenn sowohl `statement_descriptor_suffix` als auch `statement_descriptor` angegeben werden, wird nur `statement_descriptor_suffix` verwendet. > > Bei API-Versionen vor `2019-02-19` werden die Parameter für die Zahlungsbeschreibung in der Abrechnung `/v1/charges` ignoriert und es wird die statische Zahlungsbeschreibung in der Abrechnung der Plattform verwendet. Zusammen mit einer Zahlungsbeschreibung in der Abrechnung werden zusätzliche Informationen zum Unternehmen gesendet, die auf dem Kontoauszug des Kunden/der Kundin angezeigt werden (zum Beispiel Adresse, E-Mail-Adresse, Telefonnummer und URL). Die zusätzlichen Informationen sind standardmäßig die Support-Eigenschaften des [business_profile](https://docs.stripe.com/api/accounts/object.md#account_object-business_profile) des Kontos. Wenn kein Support-Feld angegeben wird, wird das Plattform-Support-Feld verwendet. Ist das Feld „Plattformunterstützung“ nicht verfügbar, werden stattdessen die Identitätsinformationen des Kontos angegeben. ### on_behalf_of behaviors Bei Zahlungen, für die `on_behalf_of` festgelegt ist, werden die Zahlungsbeschreibung in der Abrechnung und die Unternehmensinformationen zuerst im angegebenen Konto nachgeschlagen. Wenn diese Informationen nicht festgelegt sind, werden die Informationen der Plattform verwendet. - Wenn die Zahlung eine dynamische Komponente hat, wird die statische Komponente [settings.card_payments.statement_descriptor_prefix](https://docs.stripe.com/api/accounts/object.md#account_object-settings-payments-statement_descriptor_prefix) des verbundenen Kontos verwendet. Wenn für das verbundene Konto kein Präfix für die Zahlungsbeschreibung eingerichtet ist, wird stattdessen das Präfix der Zahlungsbeschreibung der Plattform verwendet. - Wenn die Geschäftsprofilinformationen des verbundenen Kontos nicht festgelegt sind, werden stattdessen die Informationen der Plattform verwendet (zuerst das Geschäftsprofil der Plattform, dann die Identitätsinformationen der Plattform). Wenn für das verbundene Konto beispielsweise keine `support_phone` festgelegt ist, wird die `support_phone`- oder Identitätstelefonnummer der Plattform angegeben. Wenn Sie ein dynamisches Suffix für eine Zahlung nutzen, die eine statische Zahlungsbeschreibung für verbundene Konten verwendet, empfehlen wir, ein Präfix auf für das verbundene Konto festzulegen, damit die gesamte Zahlungsbeschreibung in der Abrechnung wie vorgesehen angezeigt wird. #### Mit Controller-Eigenschaften ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d "controller[stripe_dashboard][type]=none" \ -d "controller[fees][payer]=application" \ -d "controller[losses][payments]=application" \ -d "controller[requirement_collection]=application" \ -d country=US \ -d business_type=company \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[card_payments][statement_descriptor_prefix]=RUNCLUB" ``` #### Mit Kontotyp ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d type=custom \ -d country=US \ -d business_type=company \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[card_payments][statement_descriptor_prefix]=RUNCLUB" ``` Das statische Präfix muss zwischen 2 und 10 Zeichen lang sein. Kartennetzwerke erhalten nur die ersten 22 Zeichen (einschließlich des Symbols `*` und des Leerzeichens, das das statische Präfix und das dynamische Suffix verkettet) der vollständigen Zahlungsbeschreibung in der Abrechnung. Legen Sie sowohl die Zahlungsbeschreibung als auch das Präfix fest, um die Festlegung von Zahlungsbeschreibung in der Abrechnung für Abbuchungen flexibel zu gestalten. Wenn die Zahlungsbeschreibung in der Abrechnung für Kartenabbuchungen festgelegt ist und kein Präfix gesetzt ist, kürzt Stripe die Zahlungsbeschreibung in der Abrechnung des Kontos nach Bedarf, um den Präfixwert festzulegen. ## Ein dynamisches Suffix für ein verbundenes Konto festlegen Dynamische Suffixe werden nur für Kartenbelastungen mithilfe des Parameters [statement_descriptor_suffix](https://docs.stripe.com/api/payment_intents/object.md?api-version=preview) von PaymentIntents unterstützt. Weitere Informationen zu [dynamischen Suffixen](https://docs.stripe.com/get-started/account/statement-descriptors.md#dynamic) finden Sie in den verketteten Zahlungsbeschreibungen in der Abrechnung im [Dashboard](https://dashboard.stripe.com/settings/public). ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d amount=1000 \ -d currency=usd \ -d "payment_method_types[]=card" \ -d "statement_descriptor_suffix=Custom suffix" ``` ## Japanische Zahlungsbeschreibungen in der Abrechnung festlegen Wir empfehlen, die statischen Komponenten der Zahlungsbeschreibungen in der Abrechnung in Kanji und Kana für verbundene japanische Konten festzulegen. Sie können alle Zahlungsbeschreibungen und ihre zugehörigen Präfixe festlegen, wenn Sie ein japanisches verbundenes Konto erstellen: #### Mit Controller-Eigenschaften ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d "controller[stripe_dashboard][type]=none" \ -d "controller[fees][payer]=application" \ -d "controller[losses][payments]=application" \ -d "controller[requirement_collection]=application" \ -d country=JP \ -d business_type=company \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[card_payments][statement_descriptor_prefix]=example prefix" \ -d "settings[card_payments][statement_descriptor_prefix_kanji]=漢字プリフィックス" \ -d "settings[card_payments][statement_descriptor_prefix_kana]=カナプリフィックス" \ -d "settings[payments][statement_descriptor]=example descriptor" \ -d "settings[payments][statement_descriptor_kanji]=漢字明細" \ -d "settings[payments][statement_descriptor_kana]=カナメイサイ" ``` #### Mit Kontotyp ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d type=custom \ -d country=JP \ -d business_type=company \ -d "capabilities[card_payments][requested]=true" \ -d "capabilities[transfers][requested]=true" \ -d "settings[card_payments][statement_descriptor_prefix]=example prefix" \ -d "settings[card_payments][statement_descriptor_prefix_kanji]=漢字プリフィックス" \ -d "settings[card_payments][statement_descriptor_prefix_kana]=カナプリフィックス" \ -d "settings[payments][statement_descriptor]=example descriptor" \ -d "settings[payments][statement_descriptor_kanji]=漢字明細" \ -d "settings[payments][statement_descriptor_kana]=カナメイサイ" ``` Sie können dynamische Kanji- und Kana-Suffixe festlegen, wenn Sie Kartenzahlungen mit [payment_method_options[card][statement_descriptor_suffix_kanji]](https://docs.stripe.com/api/payment_intents/create.md?api-version=preview#create_payment_intent-payment_method_options-card-statement_descriptor_suffix_kanji) und [payment_method_options[card][statement_descriptor_suffix_kana]](https://docs.stripe.com/api/payment_intents/create.md?api-version=preview#create_payment_intent-payment_method_options-card-statement_descriptor_suffix_kana) erstellen. ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -d amount=1000 \ -d currency=jpy \ -d "payment_method_types[]=card" \ -d "statement_descriptor_suffix=example descriptor" \ -d "payment_method_options[card][statement_descriptor_suffix_kanji]=漢字サフィックス" \ -d "payment_method_options[card][statement_descriptor_suffix_kana]=カナサフィックス" ``` Weitere Informationen finden Sie unter [Japanische Zahlungsbeschreibungen in der Abrechnung](https://docs.stripe.com/get-started/account/statement-descriptors.md#set-japanese-statement-descriptors).