Zahlungsbeschreibungen in der Abrechnung mit Connect festlegen

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 kennen.

Statische Komponente für ein verbundenes Konto festlegen

Zahlungsbeschreibungen enthalten eine statische Komponente und optional einen dynamischen Teil. Die statische Komponente bezieht sich auf:

• Die gesamte Zahlungsbeschreibung in der Abrechnung ist statisch (settings.payments.statement_descriptor).
• Die erste Hälfte der Zahlungsbeschreibung in der Abrechnung ist statisch (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 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
• 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 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 aufrufen. Wenn während des von Stripe gehosteten oder eingebetteten Onboardings settings.payments.statement_descriptor oder settings.card_payments.statement_descriptor_prefix nicht festgelegt ist, legt Stripe diese anhand der Informationen, die während des Onboardings über das Konto bereitgestellt wurden, fest. Wenn keine ausreichenden Informationen verfügbar sind, fordert Stripe verbundene Konten auf, beim Onboarding ihre eigenen Zahlungsbeschreibungen in der Abrechnung 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 aufrufen.

Für Konten, bei denen die Plattform das Onboarding übernimmt, müssen Sie die Zahlungsbeschreibung in der Abrechnung festlegen.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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"

Ab der API-Version vom 16.10.2023 gibt es eine neue Logik für die Aktualisierung von Zahlungsbeschreibungen in der Abrechnung.

• 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 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 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

Die Verwendung der statischen Komponente von einem verbundenen Konto setzt voraus, dass das Konto über die Funktion card_payments verfügt.

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 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.

Verhaltensweisen von on_behalf_of

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 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.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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

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.

Richten Sie den statement_descriptor und das statement_descriptor_prefix ein, um bei der Festlegung von Zahlungsbeschreibungen für Abbuchungen flexibel zu sein.

Wenn die Zahlungsbeschreibung für Kartenzahlungen eingerichtet ist und kein Präfix festgelegt ist, kürzt Stripe die Zahlungsbeschreibung in der Abrechnung für das Konto nach Bedarf, um den Präfixwert festzulegen.

Ein dynamisches Suffix für ein verbundenes Konto festlegen

Dynamische Suffixe werden nur für Kartenzahlungen unter Verwendung des Parameters statement_descriptor_suffix unterstützt. Erfahren Sie mehr über dynamische Suffixe oder sehen Sie sich die verketteten Zahlungsbeschreibungen (Präfix* Suffix) im Dashboard an.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_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:

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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]"="カナメイサイ"

Sie können dynamische Kanji- und Kana-Suffixe festlegen, wenn Sie Kartenzahlungen mit payment_method_options[card][statement_descriptor_suffix_kanji] und payment_method_options[card][statement_descriptor_suffix_kana] erstellen.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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.