Mit Connect Rechnungen erstellen

Sie können Rechnungen für verbundene Konten erstellen, die mehrere Verfahren zum Einzug von Zahlungen unterstützen. Sie können Direct Charges verwenden, um diese direkt für das verbundene Konto zu erstellen. Alternativ können Sie auf der Plattform Rechnungen mit Überweisungen auf das verbundene Konto über Destination Charges erstellen. Für diese Rechnungen können Sie auch eine Plattformgebühr einbehalten.

Erstellen einer Rechnung mit Direct Charges

Um eine Rechnung zu erstellen, die direkt über ein verbundenes Konto abgerechnet wird, authentifizieren Sie sich als das verbundene Konto. Damit das funktioniert, muss die Kundin/der Kunde für das verbundene Konto definiert sein.

curl https://api.stripe.com/v1/invoices \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d customer=
{{CUSTOMER_ID}}
 \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"

Wie beim Erstellen einer Direct Charge für ein verbundenes Konto können Sie Kundinnen/Kunden für ein verbundenes Konto entweder mit dem veröffentlichbaren Schlüssel der Plattform oder dem veröffentlichbaren Schlüssel des verbundenen Kontos erstellen. Sie können auch ein Token unter Verwendung von gemeinsamen Kundinnen/Kunden erstellen. Bei Verwendung von Direct Charges ist das verbundene Konto für die Kosten der Gebühren, Rückerstattungen und Rückbuchungen von Stripe verantwortlich.

Erstellen einer Rechnung mit Destination Charges

Um eine Rechnung zu erstellen, die auf der Plattform in Rechnung gestellt wird und für die automatische Überweisungen auf ein verbundenes Konto eingerichtet werden, geben Sie die ID des verbundenen Kontos als Wert für transfer_data[destination] an.

curl https://api.stripe.com/v1/invoices \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Damit dies funktioniert, muss die Kundin/der Kunde im Plattformkonto definiert sein und das Token des verbundenen Kontos muss mit dem veröffentlichbaren Schlüssel der Plattform erstellt werden. Wenn Sie Kund/innen belasten, müssen diese im Plattformkonto vorhanden sein. Bei Verwendung automatischer Überweisungen ist die Plattform das Unternehmen, das die Aufzeichnungen führt.

Zeigen Sie Steueridentifikationsnummern verbundener Konten und Unternehmensdetails auf Ihren Rechnungen an

In einigen Regionen ist es gesetzlich vorgeschrieben, dass Händler/innen ihre Steuer-IDs und andere Unternehmensdetails auf kundenorientierten Dokumenten angeben müssen.

In einigen Fällen können Sie diese Anforderungen erfüllen, indem Sie Informationen über ein verbundenes Konto anstelle von Informationen über Ihre Plattform anzeigen. In den folgenden Schritten wird gezeigt, wie die Steueridentifikationsnummern und die Geschäftsdetails eines verbundenen Kontos in Rechnungs-E-Mails, Rechnungs-PDFs, gehosteten Rechnungsseiten und Rechnungsbelegen dargestellt werden:

1. Erstellen Sie Steueridentifikationsnummern für Ihr verbundenes Konto.
2. Legen Sie Standard-Steueridentifikationsnummern für Ihr verbundenes Konto fest.
3. Geben Sie das verbundene Konto entweder mit dem Parameter on_behalf_of oder als issuer auf bestehenden oder neuen Rechnungen, Abonnements und Abonnementplänen an.

Steueridentifikationsnummern für Ihr verbundenes Konto erstellen

Im folgenden Beispiel wird eine einzelne Steueridentifikationsnummer für das verbundene Konto erstellt. Stripe speichert die Steueridentifikationsnummer auf dem verbundenen Konto. Um weitere Steueridentifikationsnummern zu erstellen, rufen Sie den Endpoint erneut auf.

curl https://api.stripe.com/v1/tax_ids \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d type=eu_vat \
  -d value=DE123456789

Die Standard-Steueridentifikationsnummern für Ihr verbundenes Konto festlegen

Stripe ruft bei der Finalisierung automatisch Standard-Steueridentifikationsnummern vom Konto des issuer der Rechnung ab, es sei denn, account_tax_ids ist bereits für die Rechnungen festgelegt.

Sie können die im verbundenen Konto gespeicherten Steueridentifikationsnummern als Standard-Steueridentifikationsnummern für dieses Konto festlegen. Im folgenden Beispiel werden vorhandene Steueridentifikationsnummern als Standard-Steueridentifikationsnummern festgelegt:

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "settings[invoices][default_account_tax_ids][0]"=atxi_123 \
  -d "settings[invoices][default_account_tax_ids][1]"=atxi_456

Den/die Aussteller/in auf bestehenden oder neuen Rechnungen, Abonnements oder Abonnementplänen als verbundenes Konto festlegen

Im folgenden Beispiel wird der issuer für ein bestehendes Abonnement festgelegt. Während der Rechnungsfinalisierung rufen Abonnementrechnungen die Standard-Steueridentifikationsnummern des Ausstellers/der Ausstellerin ab:

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "invoice_settings[issuer][type]"=account \
  -d "invoice_settings[issuer][account]"=
{{CONNECTED_ACCOUNT_ID}}

Im folgenden Beispiel wird issuer während der Rechnungserstellung festgelegt:

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "issuer[type]"=account \
  -d "issuer[account]"=
{{CONNECTED_ACCOUNT_ID}} \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Alternativ können mit dem Parameter on_behalf_of auch die Details eines verbundenen Kontos in der Rechnungs-E-Mail, auf der Rechnungs-PDF, der gehosteten Rechnungsseite und dem Rechnungsbeleg angezeigt werden.

Steueridentifikationsnummern für bestehende oder neue Rechnungen, Abonnements oder Abonnementpläne festlegen

Sie können account_tax_ids für Rechnungen, Abonnements und Abonnementpläne angeben, um die Standard-Steueridentifikationsnummern zu überschreiben. Im folgenden Beispiel wird account_tax_ids für ein bestehendes Abonnement festgelegt:

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "invoice_settings[issuer][type]"=account \
  -d "invoice_settings[issuer][account]"=
{{CONNECTED_ACCOUNT_ID}} \
  -d "invoice_settings[account_tax_ids][0]"=txi_123 \
  -d "invoice_settings[account_tax_ids][1]"=txi_456

Im folgenden Beispiel wird bei der Rechnungserstellung account_tax_ids festgelegt:

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "issuer[type]"=account \
  -d "issuer[account]"=
{{CONNECTED_ACCOUNT_ID}} \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}} \
  -d "account_tax_ids[0]"=txi_123 \
  -d "account_tax_ids[1]"=txi_456

Auf der Plattform gespeicherte Steuer-IDs für Ihr verbundenes Konto erstellen

Die von Ihnen erstellte Steueridentifikationsnummer wird im Plattformkonto statt im verbundenen Konto gespeichert. Im folgenden Beispiel wird eine einzelne Steueridentifikationsnummer für das verbundene Konto erstellt, ohne den Header Stripe-Account zu verwenden:

curl https://api.stripe.com/v1/tax_ids \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d type=eu_vat \
  -d value=DE123456789 \
  -d "owner[type]"=account \
  -d "owner[account]"=
{{CONNECTED_ACCOUNT_ID}}

Plattformgebühren erheben

Sie können für die Rechnung eine Plattformgebühr einbehalten (optional). Das folgende Beispiel zeigt eine application_fee_amount für eine Rechnung mit Direct Charge für das verbundene Konto:

curl https://api.stripe.com/v1/invoices \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d application_fee_amount="10" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"

Dieses Beispiel zeigt einen application_fee_amount für eine Rechnung mit Destination Charge:

curl https://api.stripe.com/v1/invoices \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d application_fee_amount="10" \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Das verbundene Konto als Abwicklungshändler einsetzen.

Um das verbundene Konto als Abwicklungshändler/in festzulegen, belasten Sie das Konto einer Kundin/eines Kunden mit dem Parameter on_behalf_of, wenn Sie die Rechnung erstellen oder aktualisieren. Sie müssen on_behalf_of in der API festlegen, bevor Sie eine Rechnung finalisieren. Das Dashboard verfügt über keine Oberfläche für Rechnungen, die Sie im Auftrag verbundener Konten senden.

Durch Festlegen des Parameters on_behalf_of werden das Branding, die Kontaktinformationen und die Steueridentifikationsnummer des verbundenen Kontos der Rechnungs-E-Mail, der Rechnungs-PDF, der gehosteten Rechnungsseite und dem Rechnungsbeleg zugewiesen. Wenn Sie jedoch on_behalf_of in einer Sandbox verwenden, werden keine E-Mails gesendet – ähnlich wie bei Standardrechnungen, die mit der API versendet werden. Beim Testen in einer Sandbox können Sie durch Überprüfen der Rechnungsseite des Dashboards verifizieren, ob Stripe eine Rechnung erstellt hat.

Damit Zahlungen im Auftrag des verbundenen Kontos eingezogen werden können, müssen auf dem verbundenen Konto auch die Kontofunktionen für die relevanten Zahlungsmethoden aktiviert sein. Sie können Zahlungen für Rechnungen, die im Namen des verbundenen Kontos erstellt wurden, automatisch überweisen, indem Sie Destination Charges verwenden. Weitere Informationen zum Parameter on_behalf_of​ finden Sie in der entsprechenden Connect-Dokumentation:

• Informationen zu automatischen Überweisungen an das verbundene Konto finden Sie in den Details zum Parameter on_behalf_of im Leitfaden Eine Abbuchung erstellen.
• Informationen zur manuellen Überweisung von Zahlungen finden Sie im Abschnitt Verfügbarkeit von Überweisungen.
• Eine Liste der Kontofunktionen, die für das Einziehen von Zahlungen für verbundene Konten erforderlich sind, finden Sie unter Funktionen für Zahlungsmethoden.

Das folgende Beispiel zeigt die Verwendung des Parameters on_behalf_of für eine neue Rechnung mit separaten Zahlungen und Überweisungen:

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d on_behalf_of=
{{CONNECTED_ACCOUNT_ID}} \
  -d customer=
{{CUSTOMER_ID}}

Wie bei gewöhnlichen Destination Charges kann eine application_fee_amount für Rechnungen festgelegt werden. Dieses Beispiel zeigt, wie on_behalf_of mit Destination Charge und Plattformgebühr verwendet wird.

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d on_behalf_of=
{{CONNECTED_ACCOUNT_ID}} \
  -d application_fee_amount=10 \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}} \
  -d customer=
{{CUSTOMER_ID}}

Rechnungen, die im Namen eines verbundenen Kontos erstellt wurden, unterstützen keine Zahlungsmethoden für Banküberweisungen, wie z. B. ACH-Überweisungen und Papierschecks.

Steuerberechnung und -erhebung integrieren

Sie müssen zunächst ermitteln, 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.