# Abonnements mit Stripe Billing erstellen Mit Connect können Sie Abonnements für Ihre Kund/innen oder verbundenen Konten erstellen. In der [Übersicht](https://docs.stripe.com/connect.md) erfahren Sie mehr über *Connect* (Connect is Stripe's solution for multi-party businesses, such as marketplace or software platforms, to route payments between sellers, customers, and other recipients). Transaktionen für *Abonnements* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis) basieren auf den [Preisen von Stripe Billing](https://stripe.com/billing/pricing). Software as a Service (SaaS) und Marktplätze nutzen Stripe Connect, um Zahlungen zwischen sich selbst, Kund/innen und verbundenen Konten weiterzuleiten. Sie können Connect für die Weiterleitung von Zahlungen oder *Auszahlungen* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit) und Stripe Billing verwenden, um Ihr wiederkehrendes Umsatzmodell zu unterstützen. ## Anwendungsszenarien Sie können [Abonnements](https://docs.stripe.com/billing/subscriptions/overview.md) für Connect-Konten erstellen, wodurch mehrere Ansätze für den Zahlungseinzug unterstützt werden. Sie können Abonnements für die Kundinnen/Kunden Ihres verbundenen Kontos mit Direct Charges oder Destination Charges erstellen, damit Ihre Endkundinnen/Endkunden direkte Transaktionen mit Ihrer Plattform durchführen können und um Ihren verbundenen Konten eine Gebühr für die Nutzung Ihrer Plattform zu berechnen. (See full diagram at https://docs.stripe.com/connect/subscriptions) ```text [customer] --> [platform] [customer] --> [account] [account] --> [platform] ``` In den folgenden Anwendungsszenarien wird beschrieben, wie Sie mit Stripe Billing Abonnements von Endkund/innen für verbundene Konten erstellen, Plattform-Endkund/innen abrechnen und verbundene Konten abrechnen können. | Anwendungsszenario | Beschreibung | | --- | --- | | [Abonnements vom Endkunden zum verbundenen Konto erstellen](https://docs.stripe.com/connect/subscriptions.md#customer-connected-account) | Erstellen Sie Abonnements für Endkunden für Ihre verbundenen Konten, was mehrere Ansätze für den Einzug von Zahlungen unterstützt. In diesem Beispiel befinden sich [Preise](https://docs.stripe.com/api/prices.md) im verbundenen Konto. | | [Abonnements für Endkunden von Plattformen erstellen](https://docs.stripe.com/connect/subscriptions.md#customer-platform) | Marktplätze können Abonnements direkt anbieten, ohne dass Ihr verbundenes Konto involviert ist. In diesem Beispiel befinden sich [Preise](https://docs.stripe.com/api/prices.md) auf der Plattform. | | [Abonnements zur Abrechnung verbundener Konten erstellen](https://docs.stripe.com/connect/subscriptions.md#connected-account-platform) | Plattformen können Abonnements für ihre verbundenen Konten erstellen. In diesem Beispiel befinden sich [Preise](https://docs.stripe.com/api/prices.md) auf der Plattform. | ### Einschränkungen Für die Verwendung von Abonnements mit Connect gelten folgende Einschränkungen: - Ihre Plattform kann ein Abonnement, das eine andere Plattform erstellt hat, nicht aktualisieren oder kündigen. - Ihre Plattform kann keinen `application_fee_amount` zu einer Rechnung hinzufügen, die sie nicht erstellt hat, noch zu einer Rechnung, die Rechnungsposten enthält, die die Plattform nicht erstellt hat. - Nur verbundene Konten mit Zugriff auf das vollständige Stripe-Dashboard können die Abonnements ihrer Kundinnen/Kunden verwalten. Bei anderen verbundenen Konten muss die Plattform die Abonnements ihrer Kundinnen und Kunden verwalten. - Abonnements werden nicht automatisch gekündigt, wenn Sie die Verbindung zur Plattform trennen. Nach der Trennung müssen Sie das Abonnement kündigen. Sie können [Webhooks verwenden, um die Aktivität verbundener Konten zu überwachen](https://docs.stripe.com/connect/webhooks.md). ## Abonnements vom Endkunden zum verbundenen Konto erstellen Wenn Sie eine Plattform erstellen, können Sie Abonnements für die Kund/innen Ihrer verbundenen Konten erstellen und optional eine Gebühr pro Zahlung für Ihre Plattform erheben. (See full diagram at https://docs.stripe.com/connect/subscriptions) ```text [customer] --> [account] [account] --> [platform] ``` In diesem Beispiel wird eine Online-Veröffentlichungsplattform erstellt, über die Kund/innen ihre Lieblingsautoren abonnieren und ihnen eine monatliche Gebühr für den Erhalt von Premium-Blogposts der einzelnen Autoren zahlen können. ## Before you begin Bevor Sie Abonnements für Ihre Kund/innen oder verbundenen Konten erstellen können, müssen Sie: 1. Erstellen Sie für jede Person, die auf Ihrer Plattform Geld erhält, ein verbundenes Konto. Folgen Sie der [SaaS-Kontoeinrichtung](https://docs.stripe.com/connect/saas/tasks/create.md) für Direct Charges oder der [Marketplace-Kontoeinrichtung](https://docs.stripe.com/connect/marketplace/tasks/create.md) für Destination Charges. In unserem Beispiel für Online-Publishing stellt ein verbundenes Konto eine Autorin oder einen Autor dar. 2. Erstellen Sie ein Preismodell. Für dieses Beispiel erstellen wir ein [Pauschalpreismodell](https://docs.stripe.com/products-prices/pricing-models.md#flat-rate), um Kundinnen/Kunden eine wiederkehrende Gebühr zu berechnen. Preise pro Nutzer/in und nutzungsbasierter Preis auch unterstützt. 3. Erstellen Sie für jede Person, die ein verbundenes Konto abonniert, [eine Kundin/einen Kunden, mit der gewünschten Zahlungsmethode](https://docs.stripe.com/billing/customer.md#manage-customers). In unserem Beispiel zur Online-Veröffentlichung erstellen Sie eine Kundin/einen Kunden für jedes Lesegerät, das eine Autorin/einen Autor abonniert. ### Wählen Sie ein Zahlungs- und Zahlungsabwicklungsmodell aus Sie können Direct Charges oder Destination Charges verwenden, um die Zahlung einer Kundin oder eines Kunden zwischen dem verbundenen Konto und Ihrer Plattform aufzuteilen. Bevor Sie ein Abonnement erstellen, wählen Sie aus, wo Zahlungen erstellt werden sollen und welches Konto der *Merchant of Record* (The legal entity responsible for facilitating the sale of products to a customer that handles any applicable regulations and liabilities, including sales taxes. In a Connect integration, it can be the platform or a connected account) ist. Der *Merchant of Record* (The legal entity responsible for facilitating the sale of products to a customer that handles any applicable regulations and liabilities, including sales taxes. In a Connect integration, it can be the platform or a connected account), also der eingetragene Händler, legt fest, wessen Zahlungsbeschreibung in der Abrechnung und Unternehmensangaben für die Zahlung gelten. | Modell | Zahlung erstellt auf | *Merchant of Record* (The legal entity responsible for facilitating the sale of products to a customer that handles any applicable regulations and liabilities, including sales taxes. In a Connect integration, it can be the platform or a connected account) | Wählen Sie den Zeitpunkt aus | | --- | --- | --- | --- | | Direct Charge | Verbundenes Konto | Verbundenes Konto | Kundinnen und Kunden führen Transaktionen direkt mit dem verbundenen Konto durch und sehen dessen Zahlungsbeschreibung in der Abrechnung. | | Destination Charge ohne `on_behalf_of` | Plattform | Plattform | Kundinnen und Kunden führen Transaktionen mit Ihrer Plattform durch und sehen Ihre Zahlungsbeschreibung in der Abrechnung. | | [Destination Charge mit on_behalf_of](https://docs.stripe.com/connect/subscriptions.md#on-behalf-of) | Plattform | Verbundenes Konto | Kundinnen und Kunden führen Transaktionen mit dem verbundenen Konto über Ihre Plattform durch und sehen die Zahlungsbeschreibung in der Abrechnung und die geltenden Unternehmensangaben des verbundenen Kontos. | In unserem Beispiel aus dem Online-Publishing bedeuten Direct Charges, dass die Leserschaft direkt mit den Autorinnen und Autoren interagiert und den Namen der Autorin/des Autors anstelle des Namens Ihrer Plattform in der Zahlungsbeschreibung in der Abrechnung sieht. Rückerstattungen und Zahlungsanfechtungen belasten das Guthaben des verbundenen Kontos. Die Verantwortung für Gebühren und negative Salden hängt von Ihrer Kontokonfiguration ab. Direct Charges werden für verbundene Konten mit Zugriff auf das vollständige Stripe-Dashboard empfohlen. Dies umfasst auch Standard-Konten. Im selben Online-Publishing-Beispiel mit Destination Charges belastet Stripe Ihr Plattformguthaben für Gebühren, Rückerstattungen und Zahlungsanfechtungen, unabhängig davon, ob Sie `on_behalf_of` festlegen oder nicht. Legen Sie `on_behalf_of` fest, um die Autorin/den Autor oder die Plattform als *Merchant of Record* (The legal entity responsible for facilitating the sale of products to a customer that handles any applicable regulations and liabilities, including sales taxes. In a Connect integration, it can be the platform or a connected account) zu benennen. Destination Charges werden für verbundene Konten mit Zugriff auf das Express-Dashboard oder verbundene Konten ohne Zugriff auf ein von Stripe gehostetes Dashboard empfohlen. Dies umfasst auch Express und Custom-Konten. Weitere Informationen zu den verschiedenen Arten von Connect Zahlungen finden Sie unter [Zahlungsarten](https://docs.stripe.com/connect/charges.md#types). ### Verwenden Sie Direct Charges, um ein Abonnement zu erstellen Um ein Abonnement zu erstellen, bei dem [Zahlungen](https://docs.stripe.com/api/charges/object.md) dem verbundenen Konto zugeordnet sind, [erstellen Sie ein Abonnement](https://docs.stripe.com/api.md#create_subscription), während [Sie sich als das verbundene Konto authentifizieren](https://docs.stripe.com/connect/authentication.md#stripe-account-header). Achten Sie darauf, die Kundin/den Kunden mit der Standardzahlungsmethode und dem [Preis](https://docs.stripe.com/api/prices.md) für das verbundene Konto zu definieren. Um eine Kundin/einen Kunden ohne Standardzahlungsmethode zu verwenden, legen Sie `payment_behavior: "default_incomplete"` fest. Mehr erfahren über das [Zahlungsverhalten](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-payment_behavior). Erweitern Sie `latest_invoice.confirmation_secret`, um das Zahlungselement einzufügen, das Sie zur Bestätigung der Zahlung benötigen. Erfahren Sie mehr über [Zahlungselemente](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md?payment-ui=elements&api-integration=paymentintents#add-the-payment-element-to-your-page). Ein umfassendes Beispiel für die Implementierung einer Abonnementanmeldung und eines Zahlungsablaufs in Ihrer Anwendung finden Sie im Leitfaden zur [Integration von Abonnements](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md). ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "customer={{CUSTOMER_ID}}" \ -d "items[0][price]={{PRICE_ID}}" \ -d "expand[0]=latest_invoice.confirmation_secret" ``` Optional können Sie [einen Prozentsatz des Rechnungsbetrags angeben, der als Plattformgebühr erhoben wird](https://docs.stripe.com/connect/subscriptions.md#collect-fees). ### Abonnements mit Destination Charges erstellen Um ein Abonnement mit der Plattform verknüpften [Charges](https://docs.stripe.com/api/charges/object.md) und automatische Überweisungen an ein verbundenes Konto zu erstellen, führen Sie einen Aufruf zum [Erstellen eines Abonnements](https://docs.stripe.com/api.md#create_subscription) durch und geben Sie dabei die verbundene Konto-ID als [Wert](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-transfer_data) von `transfer_data[destination]` an. Für ein verbundenes Konto unter Accounts v2 erfordern Destination Charges die `recipient`-Konfiguration mit einer aktiven `stripe_balance.stripe_transfers`-Funktion. Erweitern Sie `latest_invoice.confirmation_secret`, um das Zahlungselement einzufügen, das Sie zur Bestätigung der Zahlung benötigen. Erfahren Sie mehr über [Zahlungselemente](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md?payment-ui=elements&api-integration=paymentintents#add-the-payment-element-to-your-page). Optional können Sie [einen Prozentsatz des Rechnungsbetrags angeben, der als Plattformgebühr erhoben wird](https://docs.stripe.com/connect/subscriptions.md#collect-fees). ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "items[0][price]={{PRICE_ID}}" \ -d "expand[0]=latest_invoice.confirmation_secret" \ -d "transfer_data[destination]={{CONNECTEDACCOUNT_ID}}" ``` ### Machen Sie das verbundene Konto mit on_behalf_of zum *Merchant of Record* (The legal entity responsible for facilitating the sale of products to a customer that handles any applicable regulations and liabilities, including sales taxes. In a Connect integration, it can be the platform or a connected account) Setzen Sie `on_behalf_of` bei der Erstellung oder Aktualisierung eines Abonnements auf die ID des verbundenen Kontos, um dieses Konto zum *Merchant of Record* (The legal entity responsible for facilitating the sale of products to a customer that handles any applicable regulations and liabilities, including sales taxes. In a Connect integration, it can be the platform or a connected account), also zum eingetragenen Händler, zu machen. Bei Destination Charges wird Ihre Plattform durch das Weglassen von `on_behalf_of` zum *Merchant of Record* (The legal entity responsible for facilitating the sale of products to a customer that handles any applicable regulations and liabilities, including sales taxes. In a Connect integration, it can be the platform or a connected account). Wenn Sie `on_behalf_of` festlegen: - Zahlungen werden im Land und in der Abrechnungswährung des verbundenen Kontos unter Anwendung der Gebührenstruktur für dieses Land abgewickelt. - Die Zahlungsbeschreibung in der Abrechnung des verbundenen Kontos erscheint auf der Kreditkartenabrechnung der Kundinnen und Kunden. Wenn sich das verbundene Konto in einem anderen Land als Ihre Plattform befindet, werden auch dessen Adresse und Telefonnummer angezeigt. - Die Einstellungen zur Auszahlungsverzögerung des verbundenen Kontos bestimmen, wie lange es dauert, bis die Gelder der Zahlung für eine Auszahlung verfügbar sind. - Gehostete Ressourcen, einschließlich E-Mail-Belege, Rechnungen und das Kundenportal, können das Branding des verbundenen Kontos verwenden. Das verbundene Konto muss über eine [Zahlungsfunktion](https://docs.stripe.com/connect/account-capabilities.md#payment-methods) wie `card_payments` verfügen. Wenn das verbundene Konto Accounts v2 verwendet, muss es außerdem die `merchant`-Konfiguration aufweisen; andernfalls schlagen die Zahlungen fehl. Für Destination Charges oder separate Zahlungen und Überweisungen benötigt das verbundene Konto unter Accounts v2 zudem die `recipient`-Konfiguration mit einer aktiven `stripe_balance.stripe_transfers`-Funktion. Konten unter dem [Rahmenvertrag für Empfänger/innen](https://docs.stripe.com/connect/service-agreement-types.md#recipient) können keine Zahlungsfunktionen anfordern und `on_behalf_of` nicht verwenden. Weitere Details finden Sie unter [Zahlung im Namen eines verbundenen Kontos abwickeln](https://docs.stripe.com/connect/charges.md#on_behalf_of), [separate Zahlungen und Überweisungen](https://docs.stripe.com/connect/separate-charges-and-transfers.md#settlement-merchant) sowie in den [Branding-Einstellungen](https://docs.stripe.com/api/accounts/object.md#account_object-settings-branding) des verbundenen Kontos. Konfigurieren Sie die Stripe Tax-Steuerpflicht und den Rechnungsaussteller separat mit `automatic_tax[liability]` und `invoice_settings[issuer]`. Unter [Stripe Tax mit Connect](https://docs.stripe.com/tax/connect.md) erfahren Sie, wie Sie die Steuerpflicht ermitteln und [Billing für die Steuerpflicht des verbundenen Kontos konfigurieren](https://docs.stripe.com/tax/tax-for-platforms.md#billing). #### Erstellen Sie eine Destination Charge mit on_behalf_of Erstellen Sie das Abonnement auf der Plattform und setzen Sie sowohl `on_behalf_of` als auch `transfer_data[destination]` auf die ID des verbundenen Kontos. Dieses Beispiel enthält zudem einen optionalen `application_fee_percent`: ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "on_behalf_of={{CONNECTEDACCOUNT_ID}}" \ -d application_fee_percent=10 \ -d "transfer_data[destination]={{CONNECTEDACCOUNT_ID}}" \ -d "items[0][price]={{PRICE_ID}}" ``` #### Erstellen Sie separate Zahlungen und Überweisungen mit on_behalf_of Erstellen Sie für [separate Zahlungen und Überweisungen](https://docs.stripe.com/connect/separate-charges-and-transfers.md) das Abonnement auf der Plattform mit `on_behalf_of` und ohne einen `Stripe-Account`-Header. In diesem Beispiel werden Gelder nicht automatisch übertragen. Erstellen Sie Überweisungen separat, um Gelder an das verbundene Konto zu senden. ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "on_behalf_of={{CONNECTEDACCOUNT_ID}}" \ -d "items[0][price]={{PRICE_ID}}" ``` ### Weitere Schritte vor dem Erstellen eines Abonnements Um eine Destination Charge zu erstellen, definieren Sie sowohl die Kundin/den Kunden als auch den Preis auf dem Plattformkonto. Sie müssen ein verbundenes Konto auf der Plattform erstellt haben. Die Kundin/der Kunde muss im Plattformkonto vorhanden sein. Ihre Plattform ist der *Merchant of Record* (The legal entity responsible for facilitating the sale of products to a customer that handles any applicable regulations and liabilities, including sales taxes. In a Connect integration, it can be the platform or a connected account), es sei denn, Sie setzen `on_behalf_of` auf die ID des verbundenen Kontos. ## Abonnements erstellen, um Plattformendkunden in Rechnung zu stellen Sie können Stripe Billing verwenden, um Abonnements für Ihre Endkund/innen zu erstellen, um Transaktionen direkt mit Ihrer Plattform durchzuführen, ohne Ihre verbundenen Konten einzubeziehen. (See full diagram at https://docs.stripe.com/connect/subscriptions) ```text [customer] --> [platform] [account] ``` In diesem Beispiel wird ein Marktplatz erstellt, über den Kund/innen On-Demand-Lieferungen bei Restaurants bestellen können. Dieser Marktplatz bietet Kund/innen ein monatliches Premium-Abonnement, bei dem die Liefergebühren erlassen werden. Kund/innen, die das Premium-Angebot abonnieren, zahlen direkt an den Marktplatz und abonnieren keinen bestimmten Lieferdienst oder Restaurant. ## Before you begin Bevor Sie Abonnements für Ihre Kund/innen erstellen, müssen Sie: 1. Erstellen Sie ein Preismodell. Für dieses Beispiel erstellen wir ein [Pauschalpreismodell](https://docs.stripe.com/products-prices/pricing-models.md#flat-rate), um Kundinnen/Kunden eine wiederkehrende Gebühr zu berechnen. Preise pro Nutzer/in und nutzungsbasierter Preis auch unterstützt. 2. Erstellen Sie einen/eine [Kunden/Kundin](https://docs.stripe.com/billing/customer.md#manage-customers)-Datensatz für alle Kundinnen/Kunden, die Sie belasten möchten. Sie können auch ein [verbundenes Konto](https://docs.stripe.com/connect/marketplace/tasks/create.md) für jede Nutzerin und jeden Nutzer erstellen, die oder der Geld von Ihrem Marketplace erhält. In unserem Beispiel für On-Demand-Restaurantlieferungen ist ein verbundenes Konto ein Restaurant oder ein Lieferdienst. Dieser Schritt ist jedoch nicht erforderlich, damit Kundinnen und Kunden Ihren Marketplace direkt abonnieren können. ### Abonnement erstellen Um ein Abonnement zu erstellen, bei dem Ihre Plattform die Gelder erhält, ohne dass Geld auf verbundene Konten geht, folgen Sie dem [Leitfaden für Abonnements](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md), um ein Abonnement mit Stripe Billing zu erstellen. ### Separate Zahlungen und Überweisungen erstellen Wenn Sie einen Teil der Gelder, die Ihre Plattform erhält, später manuell auf Ihre verbundenen Konten überweisen möchten, verwenden Sie [separate Zahlungen und Überweisungen](https://docs.stripe.com/connect/separate-charges-and-transfers.md), um Gelder an ein oder mehrere verbundene Konten auszuzahlen. In unserem Beispiel für die On-Demand-Lieferung in Restaurants können Sie separate Zahlungen und Überweisungen verwenden, um eine Partnergebühr an einen Fahrer oder ein Restaurant zu zahlen, das eine Kundin/einen Kunden an einen Premium-Lieferservice weiterleitet. ## Erstellen Sie Abonnements, um verbundene Konten abzurechnen Sie können Stripe Billing verwenden, um Abonnements zu erstellen, mit denen Sie Ihren verbundenen Konten eine Gebühr für die Nutzung Ihrer Plattform berechnen können. (See full diagram at https://docs.stripe.com/connect/subscriptions) ```text [account] --> [platform] [customer] ``` In diesem Beispiel wird eine Plattform für die Verwaltung von Fitnessstudios erstellt, mit der Fitnessstudios eine monatliche Gebühr für die Verwaltung von Stundenplänen und Terminen zahlen können. Die Fitnessstudio-Unternehmen zahlen die Abo-Gebühr, nicht die Fitnessstudio-Besucher/innen. Die Fitnessstudio-Management-Software ermöglicht auch einmalige Zahlungen zwischen dem Fitnessstudio-Besucher und dem Fitnessstudio-Unternehmen für jeden Kurs, für den er/sie teilnimmt. Das monatliche Abonnement wird zwischen dem verbundenen Konto und der Plattform abgeschlossen, wobei der/die Fitnessstudio-Besucher/in an der Transaktion nicht beteiligt ist . Im obigen Diagramm ist das Fitnessstudio das verbundene Konto und der/die Fitnessstudio-Kund/in ist der Endkunde. ## Before you begin Bevor Sie Abonnements für Ihre verbundenen Konten erstellen, müssen Sie folgende Schritte ausführen: 1. Erstellen Sie ein Preismodell. Für dieses Beispiel erstellen wir ein [Pauschalpreismodell](https://docs.stripe.com/products-prices/pricing-models.md#flat-rate), um Kundinnen/Kunden eine wiederkehrende Gebühr zu berechnen. Preise pro Nutzer/in und nutzungsbasierter Preis auch unterstützt. 2. Erstellen Sie auf der Plattform eine Kundin oder einen Kunden mit der gewünschten Zahlungsmethode für jedes verbundene Konto, das Sie belasten möchten. Im Beispiel einer Fitnessstudio-Management-Software erstellen Sie eine Kundin oder einen Kunden für jedes Fitnessstudio: ### Erstellen Sie ein Customer-Objekt, um das verbundene Konto darzustellen Um ein Abonnement für das verbundene Konto zu erstellen, mit dem eine wiederkehrende Gebühr an die Plattform gezahlt wird, müssen Sie ein [Kundenobjekt](https://docs.stripe.com/api/customers/create.md) erstellen, das das verbundene Konto repräsentiert. Das Kontoobjekt ermöglicht es dem verbundenen Konto, Zahlungen von seinen Kundinnen und Kunden einzuziehen, jedoch kann die Plattform es nicht verwenden, um wiederkehrende Zahlungen vom verbundenen Konto einzuziehen. Erstellen Sie nur eine Kundin oder einen Kunden, die bzw. der jede Geschäftseinheit repräsentiert, anstatt eine Kundin oder einen Kunden für jede/n Inhaber/in, Manager/in oder Betreiber/in des Unternehmens zu erstellen. ### Erstellen Sie ein Abonnement für das verbundene Konto Um ein Abonnement zu erstellen, bei dem Ihre Plattform die Gelder von Ihren verbundenen Konten erhält, befolgen Sie bitte die [Anleitung zu Abonnements](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md), um ein Abonnement mit Stripe Billing zu erstellen. Übergeben Sie das Kundenobjekt, das das verbundene Konto repräsentiert, im Parameter `customer`. ## Ermöglichen Sie Ihrer Integration, Ereignisbenachrichtigungen zu erhalten Stripe erstellt Ereignisbenachrichtigungen, wenn Änderungen in Ihrem Konto vorgenommen werden, z. B. wenn eine wiederkehrende Zahlung erfolgreich ist oder wenn eine Auszahlung fehlschlägt. Richten Sie einen *Webhook-Endpoint* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) ein, um diese Benachrichtigungen zu erhalten und sie zur Automatisierung Ihrer Integration zu verwenden. Sie könnten beispielsweise den Zugriff auf Ihren Dienst gewähren, wenn Sie das `invoice.paid`-Ereignis erhalten. ### Ereignisbenachrichtigungen für Connect und Abonnementintegrationen Hier sind die Ereignisbenachrichtigungen, die in der Regel von Connect-Integrationen verwendet werden. | Ereignis | data.object type | Beschreibung | | --- | --- | --- | | `account.application.deauthorized` | `application` | Tritt auf, wenn ein verbundenes Konto die Verbindung zu Ihrer Plattform trennt. Sie können damit eine Bereinigung Ihres Servers auslösen. Verfügbar für verbundene Konten mit Zugriff auf das Stripe-Dashboard. Dazu zählen [Standard-Konten](https://docs.stripe.com/connect/standard-accounts.md). | | `account.external_account.updated` | Ein externes Konto, zum Beispiel `card` oder `bank_account` | Tritt auf, wenn [ein Bankkonto oder eine Debitkarte, das/die mit einem verbundenen Konto verknüpft ist, aktualisiert wird](https://docs.stripe.com/connect/payouts-bank-accounts.md). Dies kann sich auf Auszahlungen auswirken. Verfügbar für verbundene Konten, die von Ihrer Plattform gesteuert werden, einschließlich Custom- und Express- sowie Standard-Konten mit aktivierten [Plattformkontrollen](https://docs.stripe.com/connect/platform-controls-for-stripe-dashboard-accounts.md). | | `account.updated` | `account` | Ermöglicht Ihnen die Überwachung von Veränderungen bei den Anforderungen verbundener Konten sowie von Statusänderungen. Verfügbar für alle verbundenen Konten. | | `balance.available` | `balance` | Tritt auf, wenn Ihr Stripe-Guthaben aktualisiert wurde (zum Beispiel, wenn [von Ihrem Bankkonto eingezahlte Geldmittel](https://docs.stripe.com/connect/top-ups.md) zur Übertragung auf Ihr verbundenes Konto verfügbar sind). | | `payment_intent.succeeded` | `payment_intent` | Tritt auf, wenn ein Payment Intent eine erfolgreiche Zahlungsabwicklung zur Folge hat. Verfügbar für alle Zahlungen, einschließlich [Destination](https://docs.stripe.com/connect/destination-charges.md) und [Direct Charges](https://docs.stripe.com/connect/direct-charges.md)-Zahlungen. | | `payout.failed` | `payout` | Tritt auf, wenn [eine Auszahlung fehlschlägt](https://docs.stripe.com/connect/manage-connected-account-payouts.md#webhooks). Wenn eine Auszahlung fehlschlägt, wird das betroffene externe Konto deaktiviert, und es können keine automatischen oder manuellen Auszahlungen verarbeitet werden, bis das externe Konto aktualisiert wurde. | | `person.updated` | `person` | Tritt auf, wenn eine dem `Account` zugeordnete `Person` aktualisiert wird. Wenn Sie [die Persons API zur Verarbeitung von Anforderungen verwenden](https://docs.stripe.com/connect/handling-api-verification.md#verification-process), überwachen Sie dieses Ereignis, um Änderungen an den Anforderungen und Statusänderungen für Einzelpersonen zu überwachen. Verfügbar für verbundene Konten, die von Ihrer Plattform gesteuert werden, einschließlich Custom- und Express- sowie Standard-Konten mit aktivierten [Plattformkontrollen](https://docs.stripe.com/connect/platform-controls-for-stripe-dashboard-accounts.md). | Hier sind die Ereignisbenachrichtigungen, die in der Regel von Abonnementintegrationen verwendet werden. > Die Accounts v2 API ist in GA für Connect-Nutzer/innen (also für diese allgemein verfügbar) und in der öffentlichen Vorschau für andere Stripe-Nutzer/innen. > > Unabhängig davon, ob Sie [Accounts v2](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md)-Objekte oder [Customer](https://docs.stripe.com/api/customers.md)-Objekte verwenden, um Ihre Kundinnen und Kunden darzustellen, verwenden Sie die `customer.subscription`-Ereignisse zum Verfolgen von Abonnement-Ereignissen. | Ereignis | Beschreibung | | --- | --- | | `v2.core.account.created` | Wird gesendet, wenn ein [v2 Account](https://docs.stripe.com/api/v2/core/accounts/object.md) erfolgreich erstellt wird. | | `customer.created` | Wird gesendet, wenn [eine Kundin/ein Kunde](https://docs.stripe.com/api/customers/object.md) erfolgreich erstellt wird. | | `customer.subscription.created` | Dieser Status wird vergeben, wenn das Abonnement erstellt wurde. Der kann `status` eines Abonnements kann `incomplete` sein, wenn eine Authentifizierung der Kundin oder des Kunden zum Abschluss der Zahlung erforderlich ist oder wenn Sie `payment_behavior` auf [default_incomplete](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-payment_behavior) gesetzt haben. | | `customer.subscription.deleted` | Wird gesendet, wenn das Abonnement eines/einer Kund/in endet. | | `customer.subscription.paused` | Wird gesendet, wenn sich der `status` eines Abonnements in `paused` ändert. Das geschieht beispielsweise, wenn Sie ein Abonnement so [konfigurieren](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-trial_settings-end_behavior-missing_payment_method), dass es [am Ende eines kostenlosen Testzeitraums ohne Zahlungsmethode](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md#create-free-trials-without-payment) pausiert wird. Die Rechnungsstellung erfolgt erst, wenn das Abonnement [fortgesetzt wird](https://docs.stripe.com/api/subscriptions/resume.md). Wir senden dieses Ereignis nicht, wenn Sie den [Zahlungseinzug unterbrechen](https://docs.stripe.com/billing/subscriptions/pause-payment.md), da während dieses Zeitraums weiterhin Rechnungen erstellt werden. | | `customer.subscription.resumed` | Wird gesendet, wenn Sie ein Abonnement wiederaufnehmen, das sich zuvor im Status `paused` befand. Dies gilt nicht, wenn Sie [die Unterbrechung des Zahlungseinzugs aufheben](https://docs.stripe.com/billing/subscriptions/pause-payment.md#unpausing). | | `customer.subscription.trial_will_end` | Wird 3 Tage vor [Ende des Testzeitraums](https://docs.stripe.com/billing/subscriptions/trials.md) gesendet. Wenn der Testzeitraum weniger als 3 Tage beträgt, wird dieses Ereignis unmittelbar ausgelöst. | | `customer.subscription.updated` | Wird gesendet, wenn ein Abonnement gestartet oder [geändert wird](https://docs.stripe.com/billing/subscriptions/change.md). So lösen beispielsweise das Erneuern des Abonnements, das Hinzufügen eines Gutscheins, das Anwenden eines Rabatts, das Hinzufügen eines Rechnungspostens und das Ändern von Abonnementplänen alle dieses Ereignis aus. | | `entitlements.active_entitlement_summary.updated` | Wird gesendet, wenn die aktiven Berechtigungen einer Kundin/eines Kunden aktualisiert werden. Wenn Sie dieses Ereignis erhalten, können Sie den Zugriff auf die Funktionen Ihres Produkts gewähren oder deaktivieren. Mehr erfahren über [die Integration mit Berechtigungen](https://docs.stripe.com/billing/entitlements.md). | | `invoice.created` | Wird gesendet, wenn eine Rechnung für ein neues oder verlängertes Abonnement erstellt wird. Wenn Stripe keine erfolgreiche Antwort auf `invoice.created` erhält, verzögert sich die Finalisierung aller Rechnungen mit dem [automatischen Einzug](https://docs.stripe.com/invoicing/integration/automatic-advancement-collection.md) um bis zu 72 Stunden. Erfahren Sie mehr über das [Finalisieren von Rechnungen](https://docs.stripe.com/invoicing/integration/workflow-transitions.md#finalized). - Antworten Sie auf die Benachrichtigung, indem Sie eine Anfrage an die API zur [Finalisierung einer Rechnung](https://docs.stripe.com/api/invoices/finalize.md) senden. | | `invoice.finalized` | Wird gesendet, wenn eine Rechnung erfolgreich finalisiert wurde und bereit für die Bezahlung ist. - Sie können die Rechnung an den Kunden/die Kundin senden. Sehen Sie sich die [Finalisierung der Rechnung](https://docs.stripe.com/invoicing/integration/workflow-transitions.md#finalized) an, um mehr zu erfahren. - Je nach Ihren Einstellungen belasten wir automatisch die Standard-Zahlungsmethode oder versuchen den Einzug. Zeigen Sie [E-Mails nach der Finalisierung](https://docs.stripe.com/invoicing/integration/workflow-transitions.md#emails) an, um mehr zu erfahren. | | `invoice.finalization_failed` | Die Rechnung konnte nicht abgeschlossen werden. Erfahren Sie mehr über [den Umgang mit fehlgeschlagenen Rechnungsabschlüssen](https://docs.stripe.com/tax/customer-locations.md#finalizing-invoices-with-finalization-failures) und [Rechnungsabschlüsse](https://docs.stripe.com/invoicing/integration/workflow-transitions.md#finalized). - Prüfen Sie die Angabe [last_finalization_error](https://docs.stripe.com/api/invoices/object.md#invoice_object-last_finalization_error) der Rechnung, um die Fehlerursache zu ermitteln. - Wenn Sie Stripe Tax verwenden, prüfen Sie das Feld [automatic_tax](https://docs.stripe.com/api/invoices/object.md#invoice_object-last_finalization_error) des Objekts `Invoice`. - Bei `automatic_tax[status]=requires_location_inputs` schlägt der Rechnungsabschluss fehl und Zahlungen können nicht eingezogen werden. Benachrichtigen Sie Ihren Kunden/Ihre Kundin und erfassen Sie den erforderlichen [Kundenstandort](https://docs.stripe.com/tax/customer-locations.md). - Wenn `automatic_tax[status]=failed` wiederholen Sie die Anfrage später noch einmal. | | `invoice.paid` | Wird gesendet, wenn die Rechnung erfolgreich bezahlt wird. Sie können den Zugriff auf Ihr Produkt gewähren, wenn Sie dieses Ereignis erhalten und der `status` des Abonnements `active` ist. | | `invoice.payment_action_required` | Wird gesendet, wenn die Rechnung eine Kundenauthentifizierung erfordert. Erfahren Sie, wie Sie mit dem Abonnement umgehen, wenn die Rechnung [Maßnahmen erfordert](https://docs.stripe.com/billing/subscriptions/overview.md#requires-action). | | `invoice.payment_failed` | Eine Zahlung für eine Rechnung ist fehlgeschlagen. Der PaymentIntent-Status ändert sich in `requires_action`. Der Status des Abonnements ist weiterhin *nur* für die erste Rechnung des Abonnements `incomplete`. Wenn eine Zahlung fehlschlägt, gibt es zahlreiche Aktionen, die Sie durchführen können: - Benachrichtigen Sie die Kundin/den Kunden. - Konfigurieren Sie Ihre [Abonnementeinstellungen](https://dashboard.stripe.com/settings/billing/automatic) im Dashboard, um [Smart Retries](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md) und andere Funktionen zur Umsatzsicherung zu aktivieren. - Wenn Sie PaymentIntents verwenden, erfassen Sie neue Zahlungsinformationen und [bestätigen Sie den PaymentIntent](https://docs.stripe.com/api/payment_intents/confirm.md). - Aktualisieren Sie die [Standard-Zahlungsmethode](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-default_payment_method) für das Abonnement. | | `invoice.upcoming` | Wird ein paar Tage vor der Verlängerung des Abonnements gesendet. Die Anzahl der Tage basiert auf der im [Dashboard](https://dashboard.stripe.com/settings/billing/automatic) festgelegten Anzahl für **Bevorstehende Verlängerungsereignisse**. Bei bestehenden Abonnements wird die Änderung der Anzahl der Tage im nächsten Abrechnungszeitraum wirksam. Sie können bei Bedarf noch [zusätzliche Rechnungsposten hinzufügen](https://docs.stripe.com/billing/invoices/subscription.md#adding-upcoming-invoice-items). | | `invoice.updated` | Wird gesendet, wenn eine Zahlung erfolgreich ist oder fehlschlägt. Wenn die Zahlung erfolgreich ist, wird das Attribut `paid` auf `true` gesetzt und der `status` ist `paid`. Wenn die Zahlung fehlschlägt, wird das Attribut `paid` auf `false` gesetzt und der `status` bleibt `open`. Fehlgeschlagene Zahlungen lösen außerdem das Ereignis `invoice.payment_failed` aus. | | `payment_intent.created` | Wird gesendet, wenn ein [PaymentIntent](https://docs.stripe.com/api/payment_intents.md) erstellt wird. | | `payment_intent.succeeded` | Wird gesendet, wenn die Zahlung für einen PaymentIntent erfolgreich abgeschlossen wurde. | | `subscription_schedule.aborted` | Wird gesendet, wenn ein Abonnementplan storniert wurde, weil das zugehörige Abonnement aufgrund von Zahlungsverzug gekündigt wurde. | | `subscription_schedule.canceled` | Wird gesendet, wenn ein Abonnementplan gekündigt wird, wodurch auch alle aktiven zugehörigen Abonnements gekündigt werden. | | `subscription_schedule.completed` | Wird gesendet, wenn alle [Phasen](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md#subscription-schedule-phases) eines Abonnementplans abgeschlossen sind. | | `subscription_schedule.created` | Wird gesendet, wenn ein neuer Abonnementplan erstellt wird. | | `subscription_schedule.expiring` | Wird 7 Tage vor Ablauf eines Abonnementplans gesendet. | | `subscription_schedule.released` | Wird gesendet, wenn ein Abonnementplan [freigegeben](https://docs.stripe.com/api/subscription_schedules/release.md) wird oder beendet und von dem verbleibenden Abonnement getrennt wird. | | `subscription_schedule.updated` | Wird gesendet, wenn ein Abonnementplan aktualisiert wird. | - [Erstellen Sie einen Webhook-Endpoint](https://docs.stripe.com/webhooks.md#webhook-endpoint-def) - [Ereignisse mit der Stripe-CLI überwachen](https://docs.stripe.com/webhooks.md#local-listener) - [Connect-Webhooks](https://docs.stripe.com/connect/webhooks.md) - [Abonnement-Webhooks](https://docs.stripe.com/billing/subscriptions/webhooks.md) ## Ihre Integration testen Nachdem Sie Ihr Abonnement erstellt haben, testen Sie Ihre Integration gründlich, bevor Sie sie Kundinnen/Kunden vorlegen oder für Live-Aktivitäten verwenden. Erfahren Sie mehr über das [Testen von Stripe Billing](https://docs.stripe.com/billing/testing.md). ## Zusätzliche Optionen Nachdem Sie Ihr Abonnement erstellt haben, können Sie neben anderen Optionen einen [application_fee_percent](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-application_fee_percent) angeben, das *Kundenportal* (The customer portal is a secure, Stripe-hosted page that lets your customers manage their subscriptions and billing details) einrichten und Abonnements mit Webhooks überwachen. ### Gebühren für Abonnements einziehen Einmal pro Abrechnungszeitraum erhebt Stripe diesen Prozentsatz des endgültigen Rechnungsbetrags, einschließlich aller gebündelten Rechnungsposten, Rabatte oder Kontoguthabenanpassungen, als Gebühr für die Plattform. Wir nehmen diesen Abzug vor, bevor wir Stripe Gebühren berechnen. Beim Erstellen oder Aktualisieren eines Abonnements können Sie optional eine [application_fee_percent](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-application_fee_percent) angeben. Dies muss eine nicht negative Dezimalstelle zwischen 0 und 100 mit höchstens zwei Dezimalstellen sein. Dieses Beispiel zeigt `application_fee_percent` für Abonnements, die Direct Charges für verbundene Konten verwenden: ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "customer={{CUSTOMER_ID}}" \ -d "items[0][price]={{PRICE_ID}}" \ -d "expand[0]=latest_invoice.confirmation_secret" \ -d application_fee_percent=10 ``` Dieses Beispiel zeigt `application_fee_percent` für Abonnements, die Destination Charges verwenden: ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "items[0][price]={{PRICE_ID}}" \ -d "expand[0]=latest_invoice.confirmation_secret" \ -d application_fee_percent=10 \ -d "transfer_data[destination]={{CONNECTEDACCOUNT_ID}}" ``` ### Berechnung der Anmeldegebühr in Prozent Betrachten Sie dieses Szenario, um zu sehen, wie wir `application_fee_percent` berechnen: - Ein Abonnement kostet 30 USD pro Abrechnungszyklus - Die nächste Rechnung enthält eine Rechnung über 10 USD - Es gilt ein 50 %-Gutschein - Die `application_fee_percent` beträgt 10 In diesem Fall beträgt die Antragsgebühr insgesamt 2 USD: (30 USD + 10 USD) * 50 % * 10 %. ### Prozentuale Gebühren und Pauschalgebühren Anmeldegebühren für Abonnements müssen normalerweise ein Prozentsatz sein, da der mit Abonnements in Rechnung gestellte Betrag häufig variiert. Sie können die wiederkehrende Anmeldegebühr eines Abonnements nicht als Pauschalbetrag festlegen. Sie können jedoch einen pauschalen `application_fee_amount` für eine Rechnung berechnen, wie im [nächsten Abschnitt](https://docs.stripe.com/connect/subscriptions.md#subscription-invoices) erläutert. Der Parameter `application_fee_percent` gilt nicht für Rechnungen, die Sie außerhalb eines Abonnementabrechnungszeitraums erstellen. Sie gilt beispielsweise nicht für anteilsmäßige Rechnungsposten, die sofort in Rechnung gestellt werden. Legen Sie in diesen Fällen auf der Rechnung direkt eine `application_fee_amount` für den Betrag fest, den Sie abbuchen möchten. ### Mit Rechnungen arbeiten, die durch Abonnements erstellt wurden In jedem Zyklus werden aus Abonnements Rechnungen und aus Rechnungen Zahlungen erstellt. Weitere Informationen zu Abonnementzyklen finden Sie im [Abonnement-Lebenszyklus](https://docs.stripe.com/billing/subscriptions/overview.md#subscription-lifecycle). Um eine Pauschalgebühr oder dynamische Gebühr zu berechnen, die nicht automatisch mit `application_fee_percent` berechnet werden kann, fügen Sie eine `application_fee_amount` direkt zu jeder durch das Abonnement erstellten Rechnung hinzu. Dieses Beispiel zeigt einen `application_fee_amount` für eine Rechnung mit einer direkten Zahlung für das verbundene Konto: ```curl curl https://api.stripe.com/v1/invoices/{{INVOICE_ID}} \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d application_fee_amount=100 ``` Dieses Beispiel zeigt einen `application_fee_amount` für eine Rechnung mit einer Destination Charge: ```curl curl https://api.stripe.com/v1/invoices/{{INVOICE_ID}} \ -u "<>:" \ -d application_fee_amount=100 \ -d "transfer_data[destination]={{CONNECTEDACCOUNT_ID}}" ``` Um automatisch einen `application_fee_amount` zu belasten, erstellen Sie einen *Webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests), der das Ereignis `invoice.created` überwacht. Sie können dies auch manuell tun, indem Sie eine Rechnung für ausstehende Rechnungsposten erstellen und dafür eine Anmeldegebühr festlegen. Der direkt auf einer Rechnung festgelegte Wert `application_fee_amount` berechneten `application_fee_percent` und ist auf den endgültigen Zahlungsbetrag der Rechnung begrenzt. ### Gutscheine verwenden Nachdem Sie Abonnements erstellt haben, können Sie Ihren Abonnements Gutscheine hinzufügen. [Gutscheine](https://docs.stripe.com/api/coupons.md) sind für Händler zugängliche Objekte, mit denen Sie Rabatte auf [Abonnements](https://docs.stripe.com/billing/subscriptions/overview.md) oder [Rechnungen](https://docs.stripe.com/api/invoices.md) steuern können. [Promo-Codes](https://docs.stripe.com/api/promotion_codes.md) sind Codes für Kundinnen/Kunden, die zusätzlich zu Gutscheinen erstellt werden und direkt an Ihre Kundinnen/Kunden weitergegeben werden können. Erfahren Sie, wie Sie [Codes für Kundinnen/Kunden erstellen](https://docs.stripe.com/billing/subscriptions/coupons.md#promotion-codes). ### Testphasen nutzen Sie können das [Abonnement](https://docs.stripe.com/billing/subscriptions/overview.md) eines Kunden/einer Kundin mit einem kostenlosen Testzeitraum starten, indem Sie beim [Erstellen des Abonnements](https://docs.stripe.com/api.md#create_subscription) das Argument `trial_end` angeben: ```curl curl https://api.stripe.com/v1/subscriptions \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "customer={{CUSTOMER_ID}}" \ -d "items[0][price]={{PRICE_ID}}" \ -d trial_end=1610403705 ``` Der Parameter `trial_end` verwendet einen Zeitstempel, der das genaue Ende der Testphase angibt. Beim Erstellen eines Abonnements können Sie alternativ das Argument [trial_period_days](https://docs.stripe.com/api.md#create_subscription-trial_period_days) verwenden: eine Ganzzahl, die die Anzahl der Tage angibt, die die Testversion ab dem aktuellen Zeitpunkt dauert. Wenn Sie ein Abonnement mit Testzeitraum erstellen, benötigen wir keine Zahlungsmethode für den Kunden/die Kundin. Wir erstellen immer noch eine sofortige [Rechnung](https://docs.stripe.com/api/invoices.md), jedoch für 0 USD. Drei Tage vor Ablauf des Testzeitraums wird das Ereignis `customer.subscription.trial_will_end` an Ihren [Webhook-Endpoint](https://docs.stripe.com/billing/subscriptions/webhooks.md) gesendet. Sobald diese Benachrichtigung angezeigt wird, können Sie alle erforderlichen Maßnahmen ergreifen, z. B. indem Sie den Kunden/die Kundin über den Beginn der Abrechnung informieren. Nach Ablauf der Testphase beginnt für den Kunden/die Kundin ein neuer Abrechnungszyklus. Nach Ablauf des Testzeitraums generiert Stripe eine Rechnung und sendet eine Benachrichtigung über das Ereignis `invoice.created`. Ungefähr eine Stunde später versucht Stripe , diese Rechnung zu belasten. Um eine Testversion vorzeitig zu beenden, führen Sie einen API-Aufruf zum [Aktualisieren des Abos](https://docs.stripe.com/api.md#update_subscription) durch und legen Sie den Wert `trial_end` auf einen neuen Zeitstempel fest, oder auf **now**, um sofort zu enden: ```curl curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -d trial_end=now ``` Erfahren Sie mehr darüber, wie Sie [Zahlungen für aktive Abonnements mithilfe von Testphasen verzögern](https://docs.stripe.com/billing/subscriptions/trials/free-trials.md). ### Richten Sie das Kundenportal ein Über das Kundenportal können Ihre Kundinnen/Kunden [Abonnements](https://docs.stripe.com/billing/subscriptions/overview.md) und [Rechnungen](https://docs.stripe.com/api/invoices.md) verwalten. Wenn Sie Abrechnung nutzen, können Ihre Kundinnen/Kunden über das Portal ihre Abonnements verwalten (aktualisieren, kündigen, unterbrechen usw.). Nur-Rechnungs-Nutzer/innen können das Portal verwenden, um eine Rechnung zu bezahlen, eine Zahlungsmethode hinzuzufügen und vieles mehr. Erfahren Sie mehr über die [Integration des Kundenportals](https://docs.stripe.com/customer-management.md). ### Abonnements mit Webhooks überwachen Wir senden Benachrichtigungen über [Webhooks](https://docs.stripe.com/webhooks.md) an Ihre App. Webhooks sind besonders wichtig für [Abonnements](https://docs.stripe.com/billing/subscriptions/overview.md), bei denen die meisten Aktivitäten asynchron erfolgen. So verwenden Sie Webhooks mit Ihren Abonnements: 1. Erstellen Sie einen Webhook-Endpoint in Ihrer App. 2. Fügen Sie Logik zur Verarbeitung von Stripe Ereignissen hinzu. Bei Abonnements umfassen dies fehlgeschlagene Zahlungen und Änderungen des Abonnementstatus (z. B. das Wechseln von einer Testversion in einen aktiven Status). 3. Testen Sie Ihren Webhook-Endpoint, um zu bestätigen, dass er wie erwartet funktioniert. Erfahren Sie, wie Sie Webhooks verwenden, um [Benachrichtigungen über Abonnementaktivitäten zu erhalten](https://docs.stripe.com/billing/subscriptions/webhooks.md). ### Informationen zum Verhalten beim Trennen von Verbindungen Wenn ein verbundenes Konto von einer Plattform getrennt wird, werden Abonnements nicht automatisch gekündigt. Einige Aspekte des Zahlungseinzugs können jedoch basierend auf dem verwendeten Zahlungstyp fortgesetzt werden oder nicht mehr fortgesetzt werden. ### Direct Charges Nach der Trennung der Verbindung werden Abonnements für das verbundene Konto weiter ausgeführt. Wenn das Abonnement mit einer `application_fee_percent` erstellt wurde, wird die Plattformgebühr nach der Trennung weiterhin von der Plattform eingezogen. Entfernen Sie die `application_fee_percent` aus dem Abonnement, bevor ein verbundenes Konto die Verbindung zu Ihrer Plattform trennt. Nach der Trennung kann ein verbundenes Konto den Parameter `application_fee_percent` aus bestehenden Abonnements über die API löschen. ### Destination Charges Nach dem Trennen der Verbindung generieren bestehende Abonnements, die als Destination-Charges erstellt wurden, weiterhin Rechnungen, aber die Rechnungen können nicht abgeschlossen werden, solange die Verbindung zum Zielkonto getrennt ist. Helfen Sie verbundenen Konten vor dem Trennen der Verbindung dabei, zugehörige Abonnements zu migrieren oder zu kündigen. ### Separate Zahlungen und Überweisungen Nach dem Trennen der Verbindung generieren bestehende Abonnements, die mit separaten Zahlungen und Überweisungen erstellt wurden, weiterhin Rechnungen, aber sie können kein Guthaben auf ein verbundenes Konto übertragen. Helfen Sie verbundenen Konten vor dem Trennen der Verbindung dabei, zugehörige Abonnements zu migrieren oder zu kündigen. ### Destination charges mit on_behalf_of Wenn ein verbundenes Konto von einer Plattform getrennt wird, werden dem/der Kund/in keine Abonnements vom Typ `on_behalf_of` für Abonnementrechnungen belastet, die auf `charge_automatically` sind. Wir erstellen weiterhin Abonnementrechnungen für jeden Zyklus, aber es bleiben Entwürfe, wobei `auto_advance` auf `false` festgelegt ist. Um mit dem Einzug von Zahlungen fortzufahren, müssen Sie die Verbindung zu dem getrennten Konto wiederherstellen oder diese Felder explizit aus der Abonnementrechnung entfernen und die Zahlung für diese Rechnungen erneut versuchen. ### Steuerberechnung und -erhebung integrieren Sie müssen zunächst feststellen, welches Unternehmen steuerpflichtig ist. Das steuerpflichtige Unternehmen kann je nach Geschäftsmodell Ihr verbundenes Konto oder die Plattform sein. Weitere Informationen finden Sie unter [Stripe Tax Connect](https://docs.stripe.com/tax/connect.md). ## See also - [Rechnungen erstellen](https://docs.stripe.com/connect/invoices.md) - [Zahlungen erstellen](https://docs.stripe.com/connect/charges.md) - [Kund/innen kontenübergreifend teilen](https://docs.stripe.com/connect/cloning-customers-across-accounts.md) - [Mehrere Währungen](https://docs.stripe.com/connect/currencies.md)