Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden

Vollständig eingebettete Connect-Plattform-Integration

Stellen Sie Connect-Funktionen für Ihre verbundenen Konten über Ihre eigene Website bereit.

Mit den eingebetteten Connect-Komponenten können Sie eine von Stripe verwaltete Funktionalität einer benutzerdefinierten Schnittstelle hinzufügen, die Sie Ihren verbundenen Konten, z. B. auf SaaS-Plattformen und Marktplätzen, zur Verfügung stellen. Sie können dort zahlungsbezogene Aktivitäten durchführen, anstatt über das Stripe Dashboard. In einer vollständig eingebetteten Integration trifft Folgendes zu:

  • Verbundene Konten greifen auf Stripe-bezogene Daten, Formulare und Benachrichtigungen über integrierte Komponenten in Ihrer Plattformanwendung zu. Sie haben keinen Zugriff auf ein Stripe-Dashboard.
  • Kümmert sich Stripe um das Kredit- und Betrugsrisiko Ihrer verbundenen Konten. Für alle Risiko- oder Compliance-Aktionen kommunizieren wir direkt mit verbundenen Konten und sie reagieren, indem sie mit eingebetteten Komponenten interagieren.
  • Durch die E-Mail-Benachrichtigungen von Stripe werden Ihre verbundenen Konten an eingebettete Komponenten weitergeleitet, wenn Informationen überprüft werden müssen oder Maßnahmen erforderlich sind. Sie müssen Stripe also die URLs für diese Komponenten mitteilen.

Demo-Website anzeigen

Wir haben eine vollständige Demo-Website für unser fiktives Unternehmen Furever erstellt. Furever ist eine Plattform, die Betreuerinnen und Betreuern von Tieren eine Software zur Verfügung stellt, mit der Nutzer/innen Zahlungen einziehen können. In dieser Demo können Sie mit vielen eingebetteten Komponenten interagieren, einschließlich Konto-Onboarding und Kontoverwaltung.

Bevor Sie beginnen

Bevor Sie eine eingebettete Integration erstellen können, müssen Sie die folgenden Voraussetzungen erfüllen:

  1. Registrieren Sie Ihre Plattform.
  2. Fügen Sie Unternehmensdetails hinzu, um Ihr Konto zu aktivieren.
  3. Vervollständigen Sie Ihr Plattform-Profil.
  4. Passen Sie Ihre Markeneinstellungen an. Fügen Sie einen Firmennamen, ein Symbol und eine Markenfarbe hinzu.

Sie müssen auch entscheiden, ob Ihre Plattform für die Preisgestaltung verantwortlich sein soll. In diesem Fall erhebt Stripe Zahlungsgebühren von Ihrer Plattform und Sie stellen Ihre verbundenen Konten in Rechnung. Andernfalls ist Stripe für die Preisgestaltung verantwortlich und erhebt die Zahlungsgebühren direkt von Ihren verbundenen Konten.

Verbundenes Konto erstellen

Im folgenden Beispiel wird ein verbundenes Konto erstellt, für das Stripe die Risiken verwaltet, die Preisgestaltung sowie die Verantwortung für die Onboarding-Anforderungen des Kontos übernimmt. Ihre Plattform verwendet eingebettete Komponenten und haftet nicht für negative Guthaben des verbundenen Kontos. Ihre verbundenen Konten haben keinen Zugriff auf von Stripe gehostete Dashboards.

Hinweis

Da Stripe in diesem Beispiel die Preisgestaltung steuert, müssen Sie die eingebettete Komponente „Dokumente“ integrieren. Darüber hinaus benachrichtigt Stripe verbundene Konten per E-Mail, wenn ihre Steuerrechnungen oder 1099-Formulare zum Download bereit sind. Wenn Sie Konten erstellen, bei denen Ihre Plattform die Preisgestaltung steuert, ist die Komponente „Dokumente“ nicht erforderlich und Stripe sendet keine Benachrichtigungen über Steuerrechnungen oder 1099-Formulare an verbundene Konten.

Sie können nach dem Onboarding des Kontos zusätzliche Funktionen anfordern, zum Beispiel bestimmte Zahlungsmethoden.

Rufen Sie /v1/accounts mit den folgenden Parametern auf:

  • country des Kontos
  • controller.stripe_dashboard.type = none
  • Fordern Sie die Funktionen card_payments und transfers an
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d country=US \
  -d "controller[stripe_dashboard][type]"=none \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true
Example response
{
  "id": 
"{{CONNECTED_ACCOUNT_ID}}"
,
  "object": "account",
  "controller": {
    "type": "application",
    "is_controller": true,
    "losses": {"payments": "stripe"},
    "fees": {"payer": "account"},
    "requirement_collection": "stripe",
    "stripe_dashboard": {
      "type": "none",
    },
  },
  "type": "none",
  ...
}

Eingebettete Komponenten einrichten

Verbundene Konten können direkt über Ihre Plattform auf ihre Konten sowie auf die wichtigsten Zahlungsfunktionen zugreifen und haben keinen Zugriff auf ein von Stripe gehostetes Dashboard. Sie müssen den Zugriff auf bestimmte Funktionen über Ihre Website bereitstellen.

Ihre Integration muss die folgenden eingebetteten Komponenten enthalten:

Ihre Integration muss auch eine Möglichkeit bieten, auf Zahlungsanfechtungen mit Beweisen zu einzelnen Zahlungen zu reagieren. Sie können dies über unsere API oder eine eingebettete Komponente (Payments, Zahlungsdetails oder Zahlungsanfechtungen) implementieren.

Wir empfehlen Ihnen, eine Möglichkeit bereitzustellen, mit der verbundene Konten bei Bedarf Geld hinzufügen können, um ein negatives Guthaben zu vermeiden und Geschäftsunterbrechungen zu verhindern. Sie können dies mithilfe einer eingebetteten Komponente (Guthaben oder Auszahlungen) implementieren.

Sie können auch zusätzliche eingebettete Komponenten hinzufügen oder Ihre eigenen Nutzeroberflächen mit unseren APIs erstellen.

Stellen Sie sicher, dass Sie vor dem Onboarding verbundener Konten eingebettete Komponenten einrichten.

Best Practices

Um die Effektivität Ihrer Integration zu maximieren, sollten Sie die folgenden Strategien berücksichtigen:

  1. Nutzer/innen im Mittelpunkt: Stellen Sie sicher, dass der Onboarding-Prozess intuitiv ist, indem Sie die Komponente zum Onboarding von Konten verwenden, um Nutzer/innen durch die Erstellung und Verwaltung von Konten zu führen. Unterteilen Sie zu diesem Zweck den Prozess in einfache Schritte und geben Sie leicht verständliche Anweisungen.
  2. Aufforderung zur Compliance: Verwenden Sie die Komponente Benachrichtigungsbanner, um Nutzer/innen über ihren Compliance-Status und jegliche ausstehende Anforderungen auf dem Laufenden zu halten. Platzieren Sie das Banner an gut sichtbarer Stelle in Ihrer Anwendung, z. B. auf der Startseite Ihres Dashboards. So stellen Sie sicher, dass gut zu sehen ist und rechtzeitig zu notwendigen Dokumentationen oder Aktualisierungen auffordert.
  3. Reaktionsfähiges Design: Stellen Sie sicher, dass die Komponenten, die Sie integrieren, auf allen Geräten funktionieren. Da verbundene Konten von verschiedenen Geräten, einschließlich Mobiltelefonen, auf Ihre Plattform zugreifen können, müssen Sie darauf achten, dass die Benutzeroberflächen zum Onboarding und zur Verwaltung auf verschiedenen Bildschirmgrößen gut funktionieren.
  4. Authentifizierung von Nutzer/innen und Sicherheit: Implementieren Sie starke Authentifizierungsmaßnahmen während der Onboarding- und Kontoverwaltungs-Prozesse. Obwohl die Stripe-Authentifizierung sensible Kontodaten schützt und die Möglichkeit bietet, Angaben zu den Auszahlungen zu ändern, hängen andere sensible Daten allein von der Authentifizierung und Sicherheit Ihres Produkts ab. Sie können die Sicherheit insgesamt erhöhen, indem Sie Methoden wie einmalige SMS-Codes oder die Zwei-Faktor-Authentifizierung verwenden.
  5. Feedback-Mechanismen: Integrieren Sie Feedback-Optionen in Ihren Onboarding-Ablauf und Ihre Management-Komponenten. Ermöglichen Sie es Nutzern/innen, Probleme zu melden oder Verbesserungen vorzuschlagen, so dass Sie die Plattform auf der Grundlage ihrer Anregungen kontinuierlich verbessern können.
  6. Proaktive Einbindung: Ermutigen Sie Nutzer/innen dazu, ihre Konten aktiv zu halten, indem Sie sie per E-Mail oder über die Plattform an Compliance-Verpflichtungen erinnern oder darauf hinweisen. Dieser proaktive Ansatz kann helfen, Kontosperrungen zu verhindern und die Frustration der Nutzer/innen zu verringern.

Verbundene Konten zum Onboarding einladen

Stripe verwendet eine AccountSession, um Ihre Absicht zum Ausdruck zu bringen, dem verbundenen Konto Zugriff auf eine eingebettete Komponente zu gewähren. Mithilfe einer AccountSession erfasst die eingebettete Konto-Onboarding-Komponente alle erforderlichen Informationen basierend auf Ihren angeforderten Funktionen.

Konto vorab ausfüllen

Sie können den Onboarding-Prozess für Ihre verbundenen Konten optimieren, indem Sie die Account-Eigenschaften mit bekannten Informationen vorab ausfüllen, bevor Sie eine AccountSession erstellen. Die Onboarding-Komponente fordert keine Informationen an, die bereits im Account vorhanden sind. Füllen Sie so viele Informationen wie möglich vorab aus, einschließlich Unternehmens-, Personen- und externen Kontoinformationen, indem Sie die folgenden Schritte befolgen:

  1. Bitte nutzen Sie das Tool zur Überprüfung der erforderlichen Informationen, um sich über die Anforderungen für Ihre verbundenen Konten zu informieren, basierend auf deren Standort, Geschäftsart und angeforderten Funktionen.
  2. Erfassen Sie vorab ausfüllbare Informationen, die den Anforderungen entsprechen.
  3. Bitte geben Sie die erfassten Informationen bei der Erstellung des Account an oder fügen Sie sie vor der Registrierung hinzu, indem Sie das Account aktualisieren.

Nachdem Sie ein Account erstellt und dessen Funktionen angefordert haben, können Sie die spezifischen Anforderungen überprüfen, indem Sie die Eigenschaft Anforderungen einsehen.

Da Ihre Plattform nicht für negative Guthaben verantwortlich ist, ist Ihr Zugriff auf bestimmte Informationen verbundener Konten, wie Auszahlungs­konten und Informationen zur juristischen Person, eingeschränkt. Nachdem ein verbundenes Konto das Onboarding über die eingebettete Konto-Onboarding-Komponente abgeschlossen hat, kann Ihre Plattform diese Eigenschaften nicht mehr aktualisieren. Das verbundene Konto muss alle Änderungen selbst vornehmen.

Nutzer/innen über die eingebettete Onboarding-Komponente zum Onboarding einladen

Verbundene Konten müssen das Onboarding durchlaufen und die erforderlichen Informationen angeben, um Zahlungen und Auszahlungen zu aktivieren. Um ein verbundenes Konto einzurichten, integrieren Sie bitte die eingebettete Onboarding-Komponente in Ihre Website und leiten Sie neue Konten dorthin weiter.

Kontositzung erstellen

Aktivieren Sie beim Erstellen einer Kontositzung das Konto-Onboarding, indem Sie account_onboarding im Parameter components angeben.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}"
 \
  -d "components[account_onboarding][enabled]"=true

Komponente für das Konto-Onboarding rendern

Nachdem die Kontositzung erstellt und ConnectJS initialisiert wurde, können Sie die Komponente für Konto-Onboarding im Frontend darstellen:

account-onboarding.js
JavaScript
React
No results
// Include this element in your HTML
const accountOnboarding = stripeConnectInstance.create('account-onboarding');
accountOnboarding.setOnExit(() => {
  console.log('User exited the onboarding flow');
});
container.appendChild(accountOnboarding);

// Optional: make sure to follow our policy instructions above
// accountOnboarding.setFullTermsOfServiceUrl('{{URL}}')
// accountOnboarding.setRecipientTermsOfServiceUrl('{{URL}}')
// accountOnboarding.setPrivacyPolicyUrl('{{URL}}')
// accountOnboarding.setCollectionOptions({
//   fields: 'eventually_due',
//   futureRequirements: 'include',
//   requirements: {
//     exclude: ['business_profile.product_description']
//   }
// })
// accountOnboarding.setOnStepChange((stepChange) => {
//   console.log(`User entered: ${stepChange.step}`);
// });

Zeigen Sie der Hauptinhaberin/dem Hauptinhaber den Onboarding-Ablauf an. Diese Nutzerin/dieser Nutzer richtet die Authentifizierung mit Stripe ein und kann die Kontodetails bearbeiten und auf Risikointerventionen reagieren. Das verbundene Konto verfügt nur über einen einzigen Satz von Authentifizierungsdaten bei Stripe. Die Nutzerin/der Nutzer, mit den Authentifizierungsdaten kann sich mittels einmaliger SMS-Codes authentifizieren, um sensiblere Aktionen wie die Aktualisierung von Bankkonten für Auszahlungsziele oder die Angabe aktualisierter Informationen zur juristischen Person durchzuführen.

Onboarding-Events überwachen

Während das verbundene Konto den Onboarding-Prozess durchläuft, werden auch account.updated-Ereignisse an Ihre konfigurierten Connect-Webhooks gesendet. Sobald das Konto die Übermittlung seiner Daten abgeschlossen hat, ändert sich die Eigenschaft details_submitted des Account zu „true“. Überprüfen Sie den Status, indem Sie in Ihrem Webhook-Handler im Event-Ttext account.updated nach details_submitted: true suchen oder das Konto abrufen. Wenn details_submitted „false“ ist, zeigen Sie die eingebettete Onboarding-Komponente erneut an. Die Komponente überspringt alle bereits übermittelten Informationen und erfasst nur die noch nicht übermittelten Anforderungen.

Wenn ein verbundenes Konto seine Daten übermittelt und den Onboarding-Prozess abgeschlossen hat, ruft die eingebettete Onboarding-Komponente den onExit-Handler auf, den Sie beim Rendern der Komponente festgelegt haben. Verwenden Sie den Callback, um das Konto zur nächsten Aktion weiterzuleiten. Wenn Sie keinen Exit-Handler festlegen oder keine Aktion innerhalb des Handlers ausführen, wird dem Konto eine Abschlussmeldung ohne klare Angabe des nächsten Schritts angezeigt.

Zusätzliche Funktionen anfordern (optional)

Ihre Plattform kann nach dem Onboarding eines verbundenen Kontos weiterhin zusätzliche Funktionen anfordern. Zum Beispiel müssen Sie die Funktionen für alle Zahlungsmethoden anfordern, die Sie für ein Konto aktivieren möchten.

Wenn für angeforderte Funktionen zusätzliche Informationen erforderlich sind, erhält das verbundene Konto über das eingebettete Benachrichtigungsbanner eine Benachrichtigung.

Laufender Compliance- und Risikoaktualisierungen

Da Stripe das Kredit- und Betrugsrisiko für Ihre verbundenen Konten verwaltet, müssen Ihre Konten in der Lage sein, Warnungen von Stripe zu sehen und darauf zu reagieren. Um dies zu erleichtern, muss Ihre Plattform die eingebetteten Komponenten „Benachrichtigungsbanner“ und „Kontoverwaltung“ integrieren. Weitere Informationen darüber, wie Stripe Ihre verbundenen Konten über diese Komponenten unterstützt, finden Sie unter Embedded Connect-Support.

Benachrichtigungsbanner einbetten

Stripe verwendet die eingebettete Benachrichtigungsbanner-Komponente, um verbundene Konten über ausstehende Compliance-Anforderungen oder andere risikobezogene Anfragen zu informieren. Die Antwort auf diese Benachrichtigungen ermöglicht es einem Konto, die Compliance bei der Verarbeitung von Zahlungen und dem Empfang von Auszahlungen zu gewährleisten. Wenn keine Benachrichtigungen ausstehen, wird das eingebettete Benachrichtigungsbanner nicht angezeigt.

Integrieren Sie das Benachrichtigungsbanner gut sichtbar und leicht zugänglich auf Ihrer Website. Sie können es beispielsweise oben auf Ihrer Zahlungsseite integrieren.

Kontositzung erstellen

Beim Erstellen einer Kontositzung aktivieren Sie das Benachrichtigungsbanner, indem Sie notification_banner im Parameter components angeben.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}"
 \
  -d "components[notification_banner][enabled]"=true \
  -d "components[notification_banner][features][external_account_collection]"=true

Benachrichtigungsbanner-Komponente rendern

notification-banner.js
JavaScript
React
No results
// Include this element in your HTML
const notificationBanner = stripeConnectInstance.create('notification-banner');
container.appendChild(notificationBanner);

// Optional:
// notificationBanner.setCollectionOptions({
//   fields: 'eventually_due',
//   futureRequirements: 'include',
// })

Um auf eine Bannerbenachrichtigung zu reagieren, kann das Konto auf eine Schaltfläche in der Benachrichtigung klicken. Sie müssen sie nicht an die eingebettete Kontoverwaltungskomponente weiterleiten.

Kontoverwaltung einbetten

Stripe benötigt die eingebettete Kontoverwaltungskomponente für das Risikomanagement. Integrieren Sie die Komponente in den Bereich Ihrer Website, in dem Konten ihre Einstellungen oder ihr Profil aktualisieren können.

Kontositzung erstellen

Aktivieren Sie beim Erstellen einer Kontositzung die Kontoverwaltung, indem Sie account_management im Parameter components angeben.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}"
 \
  -d "components[account_management][enabled]"=true \
  -d "components[account_management][features][external_account_collection]"=true

Kontoverwaltungskomponente rendern

account-management.js
JavaScript
React
No results
// Include this element in your HTML
const accountManagement = stripeConnectInstance.create('account-management');
container.appendChild(accountManagement);

// Optional:
// accountManagement.setCollectionOptions({
//   fields: 'eventually_due',
//   futureRequirements: 'include',
// })

Mit dieser Komponente kann ein Konto seine Kontodetails aktualisieren, auf neue Konformitätsanforderungen reagieren und ihre Authentifizierungsdaten aktualisieren.

Zahlungen integrieren

Richten Sie die Zahlungsintegration ein, nachdem Sie die erforderlichen eingebetteten Komponenten integriert haben. Sie können Ihrer Plattform integrierte Zahlungs- und Auszahlungskomponenten hinzufügen oder Ihre eigenen Arbeitsabläufe erstellen.

Konfigurieren Sie Connect-Webhooks und überwachen Sie das Event account.updated. Ein verbundenes Konto ist zum Empfang von Zahlungen bereit, wenn die Eigenschaft charges_enabled auf „true“ festgelegt ist.

Integration eingebetteter Zahlungen und Auszahlungen

Fügen Sie die eingebetteten Komponenten für Zahlungen und Auszahlungen zu Ihrer Plattform hinzu, bevor Sie Ihre Payments-Integration erstellen. Auf diese Weise kann ein verbundenes Konto problemlos auf seine wichtigsten Workflows für Zahlungen zugreifen und diese verwalten.

Die Zahlungskomponente zeigt eine Liste der Zahlungen des verbundenen Kontos an und umfasst Filterfunktionen sowie Ansichten mit individuellen Zahlungsdetails. Über diese Komponente kann ein Konto Rückerstattungen vornehmen und auf Zahlungsanfechtungen mit Belegen zu einzelnen Zahlungen reagieren. Wenn Sie sich dafür entscheiden, stattdessen eine vollständig API-gesteuerte benutzerdefinierte Zahlungsliste zu erstellen und zu pflegen, können Sie Rückerstattungen und Zahlungsanfechtungen weiterhin über die Komponente Zahlungsdetails, die Komponente Zahlungsanfechtungen oder unsere APIs aktivieren.

Kontositzung erstellen

Wenn Sie eine Kontositzung erstellen, aktivieren Sie die eingebettete Komponente Payments, indem Sie payments im Parameter components angeben. Sie können eine einzelne Funktion der Payments-Komponente ein- oder ausschalten, indem Sie den Parameter features unter payments angeben:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}"
 \
  -d "components[payments][enabled]"=true \
  -d "components[payments][features][refund_management]"=true \
  -d "components[payments][features][dispute_management]"=true \
  -d "components[payments][features][capture_payments]"=true \
  -d "components[payments][features][destination_on_behalf_of_charge_management]"=false

Bei direkten Abbuchungen können Ihre verbundenen Konten die vollständigen Informationen einsehen. Sie können auch Rückerstattungen und Zahlungsanfechtungen verwalten und Zahlungen erfassen, wenn Sie die entsprechenden Funktionen beim Erstellen einer Kontositzung aktivieren.

Die Zahlungskomponente rendern

Nachdem Sie die Kontositzung erstellt und ConnectJS initialisiert haben, können Sie die Zahlungskomponente im Frontend darstellen:

payments.js
JavaScript
React
No results
// Include this element in your HTML
const payments = stripeConnectInstance.create('payments');
container.appendChild(payments);

// Optional: specify filters to apply on load
// payments.setDefaultFilters({
//   amount: {greaterThan: 100},
//   date: {before: new Date(2024, 0, 1)},
//   status: ['partially_refunded', 'refund_pending', 'refunded'],
//   paymentMethod: 'card',});

Die Auszahlungskomponente zeigt die letzten Auszahlungen des verbundenen Kontos, das aktuelle Guthaben und den Zeitpunkt der Verfügbarkeit von Geldern an.

Aktivieren Sie beim Erstellen einer Kontositzung die eingebettete Auszahlungskomponente, indem Sie payouts im Parameter components angeben. Sie können einzelne Funktionen der Auszahlungskomponente aktivieren oder deaktivieren, indem Sie den Parameter features unter payouts angeben:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
"{{CONNECTED_ACCOUNT_ID}}"
 \
  -d "components[payouts][enabled]"=true \
  -d "components[payouts][features][instant_payouts]"=true \
  -d "components[payouts][features][standard_payouts]"=true \
  -d "components[payouts][features][edit_payout_schedule]"=true \
  -d "components[payouts][features][external_account_collection]"=true

Nachdem die Kontositzung erstellt und ConnectJS initialisiert wurde, können Sie die Auszahlungskomponente im Frontend anzeigen:

payouts.js
JavaScript
React
No results
// Include this element in your HTML
const payouts = stripeConnectInstance.create('payouts');
container.appendChild(payouts);

Eine ausführliche Anleitung zur Implementierung eingebetteter Komponenten finden Sie im [Schnellstart für die Integration eingebetteter Connect-Komponenten]](/connect/connect-embedded-components/quickstart).

Zahlung akzeptieren

Wenn Ihre verbundenen Konten Transaktionen direkt mit Kundinnen/Kunden durchführen, verwenden Sie Direct Charges.

Stripe berechnet Ihrer Plattform Transaktionsgebühren für Zahlungen, wenn controller.fees.payer für das Konto nicht auf account gesetzt sind. Sie sind dafür verantwortlich, Ihren verbundenen Konten Gebühren für die Zahlungsabwicklung in Rechnung zu stellen. Sie können bei jeder Zahlung verwenden, um automatisch Gebühren von verbundenen Konten zu erheben, ohne dies in Ihre Integration aufnehmen zu müssen.

Wir empfehlen Ihnen, Stripe Checkout zu verwenden, eine vorkonfigurierte von Stripe gehostete Seite zum Empfang von Zahlungen. Checkout unterstützt mehrere Zahlungsmethoden und zeigt Ihrem/Ihrer Kund/in automatisch die für ihn/sie relevantesten an.

Sie können auch das Payment Element verwenden, eine vorgefertigte Nutzeroberfläche, die Sie einbetten können, um mit einer einzigen Integration zusätzliche Zahlungsmethoden zu akzeptieren.

Checkout-Sitzung erstellen Client-side Server-side

Über eine Checkout-Sitzung wird gesteuert, was die Kundinnen und Kunden auf der von Stripe gehosteten Zahlungsseite sehen, z. B. Posten, den Bestellbetrag und die Währung sowie die akzeptierten Zahlungsmethoden. Bei der Durchführung von separaten Zahlungen und Überweisungen verwendet Checkout die Branding-Einstellungen des verbundenen Kontos. Weitere Informationen finden Sie unter Branding anpassen.

Anders als bei Destination Charges oder separaten Zahlungen und Überweisungen sind die verbundenen Konten für den Umgang mit Zahlungsanfechtungen bei Direct Charges verantwortlich – die Verantwortung liegt nicht bei der Plattform.

Wenn Sie eine Checkout-Sitzung erstellen möchten, fügen Sie Ihrer Website eine Zahlungsschaltfläche hinzu, über die ein serverseitiger Endpoint aufgerufen wird.

checkout.html
<html>
  <head>
    <title>Checkout</title>
  </head>
  <body>
    <form action="/create-checkout-session" method="POST">
      <button type="submit">Pay</button>
    </form>
  </body>
</html>

Führen Sie auf Ihrem Server den folgenden Aufruf der Stripe API durch. Leiten Sie Ihre Kundinnen/Kunden nach dem Erstellen einer Checkout-Sitzung zu der in der Antwort zurückgegebenen URL weiter.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d mode=payment \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "payment_intent_data[application_fee_amount]"=123 \
  --data-urlencode success_url="https://example.com/success"
  • line_items: Dieser Parameter stellt Artikel dar, die Ihre Kundinnen/Kunden kaufen und die auf der gehosteten Nutzeroberfläche angezeigt werden.
  • success_url: Dieses Argument leitet Kundinnen/Kunden weiter, nachdem sie eine Zahlung abgeschlossen haben.
  • Stripe-Account: Dieser Header gibt eine Direct Charge für Ihr verbundenes Konto an. Bei Direct Charges ist das verbundene Konto für Stripe-Gebühren, Rückerstattungen und Rückbuchungen verantwortlich. In Checkout wird das Branding des verbundenen Kontos verwendet, wodurch Kundinnen/Kunden den Eindruck haben, direkt mit dem verbundenen Konto und nicht mit Ihrer Plattform zu kommunizieren.
  • (Optional) payment_intent_data[application_fee_amount]: Dieses Argument legt den Betrag fest, den Ihre Plattform von der Transaktion abziehen will. Nachdem die Zahlung auf dem verbundenen Konto abgewickelt wurde, wird der application_fee_amount an die Plattform übertragen und die Stripe-Gebühr wird vom Guthaben des verbundenen Kontos abgezogen.

Mit Ereignissen nach der Zahlung umgehen Serverseitig

Stripe sendet das Ereignis checkout.session.completed, wenn die Zahlung abgeschlossen ist. Verwenden Sie einen Webhook, um diese Ereignisse zu empfangen und führen Sie Aktionen aus, wie z. B. das Senden einer Bestellbestätigung per E-Mail, das Protokollieren des Verkaufs in einer Datenbank oder das Starten eines Versand-Workflows.

Überwachen Sie diese Ereignisse, anstatt auf einen Callback vom Client zu warten. Auf dem Client könnten die Kund/innen das Browserfenster schließen oder die App beenden, bevor der Callback erfolgt ist. Einige Zahlungsmethoden benötigen auch 2 bis 14 Tage bis zur Zahlungsbestätigung. Wenn Sie Ihre Integration so einrichten, dass sie asynchrone Ereignisse überwacht, können Sie mehrere Zahlungsmethoden mit einer einzelnen Integration akzeptieren.

Neben der Abwicklung des Ereignisses checkout.session.completed empfehlen wir die Abwicklung von zwei weiteren Ereignissen, wenn Sie Zahlungen mit Checkout erfassen:

EreignisBeschreibungNächste Schritte
checkout.session.completedDer/die Kund/in hat die Zahlung nach der Übermittlung des Checkout-Formulars erfolgreich autorisiert.Warten Sie, bis die Zahlung erfolgt ist oder fehlschlägt.
checkout.session.async_payment_succeededDie Kundenzahlung war erfolgreich.Führen Sie die Bestellung der gekauften Waren oder Dienstleistungen aus.
checkout.session.async_payment_failedDie Zahlung wurde abgelehnt oder ist aus einem anderen Grund fehlgeschlagen.Kontaktieren Sie den/die Kund/in per E-Mail und fordern Sie eine neue Bestellung von ihm/ihr an.

Diese Ereignisse beinhalten das Checkout-Sitzungsobjekt. Nach erfolgreicher Zahlung ändert sich der Status des zugrunde liegenden PaymentIntent von processing zu succeeded.

E-Mail-Kommunikation mit verbundenen Konten einrichten

Stripe kommuniziert in Ihrem Auftrag mit Ihren verbundenen Konten, um Risiken zu verwalten und stets Compliance zu gewährleisten. Sie können diese E-Mail-Nachrichten anpassen und mit Ihrer eigenen E-Mail-Domain und Ihrem Plattform-Branding versehen.

Stripe sendet die folgenden E-Mails an Ihre verbundenen Konten:

  • Konto-E-Mails verifizieren Kontoinformationen, wie z. B. hinzugefügte oder geänderte E-Mail-Adressen, Telefonnummern oder Bankkonten.
  • ** Compliance-E-Mails** benachrichtigen Konten, damit sie die erforderlichen Informationen zur Verfügung stellen. Stripe muss häufig weitere Informationen erfassen, um die Compliance mit unseren Finanzpartnern aufrechtzuerhalten.
  • Mit Risiko-E-Mails werden Konten benachrichtigt, wenn sie einer Risikoprüfung unterzogen werden. Diese E-Mails enthalten häufig Anweisungen dazu, wie Informationen zur Behebung von Risikomaßnahmen eingereicht werden können, z. B. zur Aufhebung einer Auszahlungspause.
  • Steuer-E-Mails (nur, wenn Stripe die Gebühren direkt von verbundenen Konten einzieht) benachrichtigen Nutzer/innen, wenn ihre Steuerrechnungen oder 1099-Formulare zum Download bereit sind.

Wenn Sie weitere zahlungsbezogene E-Mails an Ihre verbundenen Konten senden möchten, müssen Sie dies selbst tun. Wenn Sie beispielsweise E-Mails bezüglich neuer Zahlungsanfechtungen senden möchten, beobachten Sie das Ereignis charge.dispute.created in einem verbundenen Konto. Wenn dieses Ereignis eintritt, verwenden Sie die Disputes API, um die Details abzurufen und per E-Mail an das Konto zu senden.

Sie müssen Ihre Connect-Einstellungen mit den URLs Ihrer Zahlungen und der Workflows Ihrer verbundenen Konten aktualisieren, damit die E-Mail-Kommunikation von Stripe Ihre verbundenen Konten dorthin weiterleiten kann. Diese Links müssen Sie vor dem Erstellen einer AccountSession oder eines AccountLink im Live-Modus einrichten.

Weiterleitungen über E-Mail-Links handhaben

Von Stripe gesendete E-Mails, die eine Handlungsaufforderung enthalten, müssen einen Link zu dieser Handlung enthalten. Wenn wir zum Beispiel eine E-Mail an ein verbundenes Konto senden, muss sie einen Link zu Ihrer Kontoverwaltungskomponente enthalten.

Bevor Sie eine Kontositzung im Live-Modus erstellen können, müssen Sie die URLs angeben, unter denen Sie die eingebetteten Komponenten in Ihre Website integriert haben. Konfigurieren Sie die Domain zum Versenden von E-Mails und die URLs der eingebetteten Komponenten im Abschnitt Website-Links in den Connect-Einstellungen Ihrer Plattform.

Hinweis

In Testumgebungen werden dieselben URLs verwendet wie im Live-Modus.

Wählen Sie für eingebettete Komponenten, die in Ihre Website integriert sind, Ja aus und geben Sie die URL der Seite ein, auf der die Komponente gehostet wird. Wählen Sie für alle Aktionen, die nicht von einer eingebetteten Komponente verarbeitet werden, Nein aus und geben Sie die URL der Seite auf Ihrer Website ein, auf der das Konto die Aktion ausführen kann. Nachdem Sie die URLs eingegeben haben, testen Sie sie, um sicherzustellen, dass sie die richtigen Seiten öffnen.

Sie müssen URLs für Folgendes festlegen:

  • Benachrichtigungsbanner
  • Kontoverwaltung
  • Zahlungen
  • Auszahlungen
  • Salden
  • Dokumente (wenn Stripe Gebühren direkt von verbundenen Konten erhebt)

Beim Senden einer E-Mail hängt Stripe die jeweilige ID des verbundenen Kontos als Parameter stripe_account_id an die Weiterleitungs-URL an. Mit diesem Parameter können Sie das Konto identifizieren und so die Authentifizierung gewährleisten. Richten Sie die Route auf Ihrem Server so ein, dass die Parameter gelesen und die korrekte eingebettete Komponente angezeigt wird.

Weitere Informationen zum Konfigurieren von Stripe-E-Mails für Ihre verbundenen Konten finden Sie unter E-Mail-Kommunikation in eingebetteten Connect-Integrationen.

E-Mail-Branding und Einstellungen konfigurieren

Stripe kann E-Mails mit den Markeneinstellungen Ihrer Plattform von Ihrer eigenen E-Mail-Domain an Ihre verbundenen Konten senden. Um Stripe-E-Mails für Ihre verbundenen Konten zu konfigurieren, rufen Sie E-Mails in Ihrem Plattform-Dashboard auf.

Live gehen

Zu diesem Zeitpunkt haben Sie Ihre Plattformintegration wie folgt konfiguriert:

  • Verbundene Konten in der richtigen Konfiguration erstellt
  • Eingebettete Komponenten integriert, damit verbundene Konten über Ihre Website zum Onboarding eingeladen werden können, ihre Konten verwalten können und auf Risikomaßnahmen reagieren können
  • Zahlungen per Direct Charges mit Plattformgebühr einrichten
  • Richten Sie eine markengeschützte E-Mail-Kommunikation ein, damit Stripe mit Ihren Nutzer/innen im Hinblick auf Compliance, Risikenmaßnahmen und erforderliche Dokumente kommunizieren kann

Integration testen

Testen Sie Ihren Kontoerstellungsablauf, indem Sie das in Ihre Plattform integrierte Konto-Onboarding verwenden. Testen Sie Ihre Zahlungsmethodeneinstellungen für Ihre verbundenen Konten, indem Sie sich bei einem Ihrer Testkonten anmelden und zu den Einstellungen für Zahlungsmethoden navigieren. Testen Sie Ihren Bezahlvorgang mit Ihren Testschlüsseln und einem Testkonto. Sie können unsere Testkarten verwenden, um Ihre Zahlungsabläufe zu testen und verschiedene Zahlungsergebnisse zu simulieren.