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 das vollständige Stripe-Dashboard oder das Express-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.
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 diebusiness_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 denbusiness_profile.name
festlegen oder aktualisieren, setzt Stripe die Zahlungsbeschreibung zurück, damit sie dem Namen des Unternehmensprofils entspricht. Wenn die Zahlungsbeschreibung automatisch anhand desbusiness_profile.name
festgelegt wird und Sie den Namen des Unternehmens oder der Einzelperson festlegen oder aktualisieren, wird die Zahlungsbeschreibung nicht zurückgesetzt, da derbusiness_profile.name
eine höhere Priorität hat. Die Rangfolge istbusiness_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 verbundenen Kontos für die folgenden Zahlungstypen verwendet:
- Direct Charges
- Destination Charges mit
on_behalf_of
- Separate Zahlungen und Überweisungen mit
on_behalf_of
Vorsicht
Die Plattform stellt die statische Komponente für /v1/charges
-Anforderungen mit on_behalf_of
für API-Versionen vor 2019-02-19
zur Verfügung.
Die Verwendung der statischen Komponente für verbundene Konten erfordert die Funktion card_payments.
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
Alle weiteren in der Abrechnung von Kund/innen angezeigten Informationen werden von dem Konto mit der entsprechenden statischen Komponente bereitgestellt (zum Beispiel Support-Adresse oder Support-Telefonnummer). Wenn das verbundene Konto diese Informationen nicht zur Verfügung gestellt hat, werden für Zahlungen vom Typ on_behalf_of
die Informationen des Plattformkontos verwendet.
Wenn Sie ein dynamisches Suffix für eine Zahlung verwenden, die eine statische Zahlungsbeschreibung für verbundene Konten verwendet, können Sie ein Präfix festlegen, damit in der Abrechnung die gesamte Zahlungsbeschreibung ordnungsgemäß angezeigt wird.
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.
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 Beschreibungen und ihre entsprechenden Präfixe beim Erstellen eines japanischen verbundenen Custom-Kontos wie folgt festlegen:
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.
Weitere Informationen finden Sie unter Japanische Zahlungsbeschreibungen in der Abrechnung.