Destination Charges erstellen

Erstellen Sie Zahlungen auf Ihrem Plattformkonto, ziehen Sie Gebühren ein und übertragen Sie die verbleibenden Gelder sofort auf Ihre verbundenen Konten.

Erstellen Sie Destination Charges, wenn Kundinnen/Kunden mit Ihrer Plattform im Zusammenhang mit Produkten oder Dienstleistungen interagieren, die von Ihren verbundenen Konten zur Verfügung gestellt werden, und Sie sofort Gelder an Ihre verbundenen Konten überweisen. Mit diesem Zahlungstyp:

Sie erstellen eine Abbuchung auf dem Konto Ihrer Plattform.
Sie bestimmen, ob diese Gelder teilweise oder vollständig auf das verbundene Konto übertragen werden sollen.
Ihr Kontoguthaben wird mit Stripe-Gebühren, Rückerstattungen und Rückbuchungen belastet.

Diese Art der Zahlung eignet sich optimal für Marktplätze wie Airbnb, einen Marktplatz für Unterkünfte, oder Lyft, eine Mitfahr-App.

Wenn sich Ihre Plattform und ein verbundenes Konto nicht in derselben Region befinden, müssen Sie, abgesehen von bestimmten Ausnahmen, das verbundene Konto als Abwicklungshändler mit dem Parameter on_behalf_of für den Payment Intent angeben.

Wir empfehlen, Destination Charges für verbundene Konten zu verwenden, die keinen Zugriff auf das vollständige Stripe-Dashboard haben.

Web

iOS

Android

React Native

Betten Sie mit Stripe Checkout ein vorgefertigtes Zahlungsformular auf Ihrer Website ein. Sehen Sie sich diese Integration im Vergleich zu anderen Integrationstypen von Stripe an.

powdur.me

Integrationsaufwand

Kaum Code

Integrationstyp

Vorgefertigtes Zahlungsformular auf Ihrer Website einbetten

Anpassung der Nutzeroberfläche

Eingeschränkte Anpassung

Registrieren Sie sich zunächst für ein Stripe-Konto.

Verwenden Sie unsere offiziellen Bibliotheken, um von Ihrer Anwendung aus auf die Stripe API zuzugreifen:

Checkout-Sitzung erstellen
Serverseitig

Über eine Checkout-Sitzung wird gesteuert, was die Kundinnen/Kunden auf dem integrierbaren Zahlungsformular sehen, z. B. Posten, den Bestellbetrag und die Bestellwährung. Erstellen Sie eine Checkout-Sitzung in einem serverseitigen Endpoint (zum Beispiel /create-checkout-session). Die Antwort enthält ein client_secret, das Sie im nächsten Schritt zur Bereitstellung von Checkout verwenden.

Parameter	Description
payment_intent_data[transfer_data][destination]	Indicates that this is a destination charge. A destination charge means the charge is processed on the platform and then the funds are immediately and automatically transferred to the connected account’s pending balance.
line_items	The items the customer is purchasing. The items are displayed in the Stripe-hosted checkout page.
return_url	The URL where the customer is redirected after they complete a payment. Use the value of `{CHECKOUT_SESSION_ID}` to retrieve the Checkout Session and inspect its status to decide what to show your customer. Make sure the return URL corresponds to a page on your website that provides the status of the payment. You can also append custom query parameters, which persist through the redirect process.
payment_intent_data[application_fee_amount]	The amount your platform plans to take from the transaction. The full charge amount is immediately transferred from the platform to the connected account that’s specified by `transfer_data[destination]` after the charge is captured. The `application_fee_amount` is then transferred back to the platform, and the Stripe fee is deducted from the platform’s amount.

Bei der Durchführung von Destination Charges verwendet Checkout die Markeneinstellungen Ihres Plattformkontos. Weitere Informationen finden Sie unter Branding anpassen.

Checkout verbinden
Clientseitig

Checkout ist als Teil von Stripe.js verfügbar. Nehmen Sie das Stripe.js-Skript in Ihre Seite auf, indem Sie es zum Header Ihrer HTML-Datei hinzufügen. Als Nächstes erstellen Sie einen leeren DOM-Knoten (Container), der zum Verbinden verwendet wird.

index.html
<head>
  <script src="https://js.stripe.com/basil/stripe.js"></script>
</head>
<body>
  <div id="checkout">
    <!-- Checkout will insert the payment form here -->
  </div>
</body>

Initialisieren Sie Stripe.js mit Ihrem veröffentlichbaren API-Schlüssel. Übergeben Sie das client_secret aus dem vorherigen Schritt an options, wenn Sie die Checkout-Instanz erstellen:

index.js
// Initialize Stripe.js
const stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx'
);

initialize();

// Fetch Checkout Session and retrieve the client secret
async function initialize() {
  const fetchClientSecret = async () => {
    const response = await fetch("/create-checkout-session", {
      method: "POST",
    });
    const { clientSecret } = await response.json();
    return clientSecret;
  };

  // Initialize Checkout
  const checkout = await stripe.initEmbeddedCheckout({
    fetchClientSecret,
  });

  // Mount Checkout
  checkout.mount('#checkout');
}

Checkout wird in einem iFrame gerendert, der Zahlungsinformationen über eine sichere HTTPS-Verbindung an Stripe sendet. Vermeiden Sie es, Checkout in einem anderen iFrame zu platzieren, da einige Zahlungsmethoden die Weiterleitung an eine gesonderte Seite zur Zahlungsbestätigung voraussetzen.

Ereignisse nach Zahlung verarbeiten
Serverseitig

Stripe übermittelt ein checkout.session.completed-Ereignis, wenn die Zahlung abgeschlossen ist. Verwenden Sie einen Webhook, um diese Ereignisse zu empfangen und Aktionen auszuführen (Versenden einer Bestellbestätigung per E-Mail an die Kundinnen/Kunden, Erfassen des Verkaufs in einer Datenbank oder Einleiten des Versandablaufs).

Überwachen Sie diese Ereignisse, anstatt auf einen Callback vom Client zu warten. Auf dem Client könnten die Kundinnen und Kunden 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.

Stripe empfiehlt, alle folgenden Ereignisse zu verarbeiten, wenn Zahlungen mit Checkout eingezogen werden:

Ereignis	Beschreibung	Nächste Schritte
checkout.session.completed	Der Kunde/die Kundin 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_succeeded	Die Kundenzahlung war erfolgreich.	Führen Sie die Bestellung der gekauften Waren oder Dienstleistungen aus.
checkout.session.async_payment_failed	Die Zahlung wurde abgelehnt oder ist aus einem anderen Grund fehlgeschlagen.	Kontaktieren Sie den Kunden/die Kundin per E-Mail und fordern Sie eine neue Bestellung von ihm/ihr an.

Diese Ereignisse beinhalten alle das Checkout-Sitzungsobjekt. Nach erfolgreicher Zahlung ändert sich der Status des zugrunde liegenden PaymentIntent von processing in succeeded oder in einen Fehlerstatus.

Integration testen

Kartennummer	Szenario	So führen Sie den Test durch
	Die Kartenzahlung ist erfolgreich und es ist keine Authentifizierung erforderlich.	Füllen Sie das Kreditkartenformular aus und geben Sie die Kreditkartennummer mit beliebiger Gültigkeitsdauer, CVC und Postleitzahl an.
	Für die Kartenzahlung ist eine Authentifizierung erforderlich.	Füllen Sie das Kreditkartenformular aus und geben Sie die Kreditkartennummer mit beliebiger Gültigkeitsdauer, CVC und Postleitzahl an.
	Die Karte wird mit einem Ablehnungscode wie `insufficient_funds` abgelehnt.	Füllen Sie das Kreditkartenformular aus und geben Sie die Kreditkartennummer mit beliebiger Gültigkeitsdauer, CVC und Postleitzahl an.
	Die UnionPay-Karte hat eine variable Länge von 13 bis 19 Ziffern.	Füllen Sie das Kreditkartenformular aus und geben Sie die Kreditkartennummer mit beliebiger Gültigkeitsdauer, CVC und Postleitzahl an.

Hier finden Sie weitere Informationen zum Testen Ihrer Integration.

OptionalWeitere Zahlungsmethoden aktivieren

Gebühren erheben

Anstatt den vollen Transaktionsbetrag auf ein verbundenes Konto zu überweisen, kann Ihre Plattform bei der Verarbeitung einer Zahlung beschließen, einen Teil des Transaktionsbetrags in Form von Gebühren zu erheben. Sie können die Preise für Gebühren auf zwei verschiedene Arten festlegen:

Mit dem Plattform-Preistool können Sie Preisregeln für Plattformgebühren festlegen und testen. Diese No-Code-Funktion im Stripe-Dashboard ist derzeit nur für Plattformen verfügbar, die für die Zahlung von Stripe-Gebühren verantwortlich sind.
Legen Sie intern Ihre Preisregeln fest und legen Sie Gebühren direkt in einem PaymentIntent fest, entweder mit dem Parameter application_fee_amount oder transfer_data[amount]. Die mit dieser Methode festgelegten Gebühren überschreiben die im Plattform-Preistool angegebene Preislogik.

Wenn Zahlungen mit einem application_fee_amount erstellt werden, wird der vollständige Zahlungsbetrag sofort nach Erfassung der Zahlung von der Plattform auf das transfer_data[destination]-Konto übertragen. Der application_fee_amount (bis zum vollen Zahlungsbetrag) wird wieder an die Plattform zurück übertragen.

Nachdem die Plattformgebühr eingezogen wurde, wird ein Plattformgebühr-Objekt erstellt. Sie können eine Liste der Plattformgebühren im Dashboard über die Plattformgebühren oder in Sigma einsehen. Sie können auch die Eigenschaft amount des Plattformgebühr-Objekts verwenden, um die Gebühren nach Posten aufgeschlüsselt auszuweisen.

Wenn Sie einen application_fee_amount verwenden, muss Ihnen Folgendes bekannt sein:

Der application_fee_amount ist auf den Gesamtbetrag der Transaktion begrenzt.
Der application_fee_amount wird immer in der gleichen Währung wie die Transaktion berechnet.
Die Plattformgebühr wird in der gleichen Währung wie die Auszahlungswährung des verbundenen Kontos abgerechnet. Bei Gebühren für grenzüberschreitende Zahlungen kann dies von der Abrechnungswährung Ihrer Plattform abweichen.
Ihre Plattform zahlt die Stripe-Gebühr, nachdem der application_fee_amount auf Ihr Konto überwiesen wurde.
Es fallen keine zusätzlichen Stripe-Gebühren auf den Betrag an.
Ihre Plattform kann die integrierte Berichterstattung zur Plattformgebühr verwenden, um die erhobenen Gebühren abzugleichen.
In von Stripe gehosteten Dashboards oder Komponenten wie der Zahlungsdetails-Komponente kann Ihr verbundenes Konto sowohl den Gesamtbetrag als auch den Betrag der Plattformgebühr einsehen.

Geldbewegungen

Mit dem obigen Code wird der vollständige Zahlungsbetrag (10,00 USD) dem ausstehenden Guthaben des verbundenen Kontos hinzugefügt. Der application_fee_amount(1,23 USD) wird vom Zahlungsbetrag abgezogen und an Ihre Plattform überwiesen. Die Stripe-Gebühren (0,59 USD) vom Guthaben Ihres Plattformkontos abgezogen. Der Betrag der Plattformgebühr abzüglich der Stripe-Gebühren (1,23 USD – 0,59 USD = 0,64 USD) verbleibt auf dem Guthaben Ihres Plattformkontos.

Der application_fee_amount wird gemäß dem normalen Überweisungsplan des Plattformkontos verfügbar, genau wie Gelder aus regulären Stripe-Zahlungen.

Branding anpassen

Ihre Plattform nutzt die Branding-Einstellungen im Dashboard, um das Branding auf der Zahlungsseite anzupassen. Bei Destination Charges verwendet Checkout die Branding-Einstellungen des Plattformkontos. Bei Destination Charges mit on_behalf_of verwendet Checkout die Branding-Einstellungen des verbundenen Kontos.

Plattformen können die Branding-Einstellungen verbundener Konten mithilfe der Update Account API konfigurieren:

icon – Wird neben dem Unternehmensnamen in der Kopfzeile der Checkout-Seite angezeigt.
logo – Wird anstelle des Symbols und des Unternehmensnamens in der Kopfzeile der Checkout-Seite verwendet.
primary_color – Wird als Hintergrundfarbe auf der Checkout-Seite verwendet.
secondary_color – Wird als Farbe für Schaltflächen auf der Checkout-Seite verwendet.

Abwicklungshändler angeben

Der Abwicklungshändler ist abhängig von den Funktionen, die für ein Konto eingerichtet sind, und davon, wie eine Zahlung erstellt wird. Der Abwicklungshändler bestimmt, wessen Informationen für die Durchführung der Zahlung verwendet werden. Dazu gehört die Zahlungsbeschreibung in der Abrechnung (entweder die der Plattform oder die des verbundenen Kontos), die auf dem Kreditkarten- oder Kontoauszug des Kunden/der Kundin für diese Zahlung angezeigt wird.

Durch die Angabe des Abwicklungshändlers können Sie genauer festlegen, für wen Zahlungen erstellt werden sollen. Einige Plattformen sind beispielsweise vorzugsweise der Abwicklungshändler, da Kundinnen/Kunden direkt mit ihrer Plattform interagieren (zum Beispiel On-Demand-Plattformen). Manche Plattformen verfügen jedoch über verbundene Konten, die stattdessen direkt mit Kundinnen/Kunden interagieren (zum Beispiel ein Ladengeschäft auf einer E-Commerce-Plattform). Bei diesen Szenarien ist es möglicherweise sinnvoller, wenn das verbundene Konto der Abwicklungshändler ist.

Sie können den Parameter on_behalf_of auf die ID eines verbundenen Kontos setzen, um dieses Konto zum Abwicklungshändler für die Zahlung zu machen. Bei Verwendung von on_behalf_of:

Zahlungen werden im Land und in der Abwicklungswährung des verbundenen Kontos abgewickelt.
Es wird die Gebührenstruktur für das Land des verbundenen Kontos verwendet.
Die Zahlungsbeschreibung des verbundenen Kontos wird auf der Kreditkartenabrechnung des Kunden/der Kundin angezeigt.
Wenn sich das verbundene Konto in einem anderen Land als die Plattform befindet, werden die Adresse und die Telefonnummer des verbundenen Kontos auf der Kreditkartenabrechnung des Kunden/der Kundin angezeigt.
Wie viele Tage ein ausstehendes Guthaben vor der Auszahlung zurückgehalten wird, hängt von der Einstellung delay_days auf dem verbundenen Konto ab.

Wenn on_behalf_of weggelassen wird, ist die Plattform das für die Zahlung verantwortliche Unternehmen.

Vorsicht

Der Parameter on_behalf_of wird nur für verbundene Konten mit Zahlungsfunktionen wie card_payments unterstützt. Konten, denen der Empfänger-Rahmenvertrag zugrunde liegt, können keine card_payments oder andere Zahlungsfunktionen anfordern.

Rückerstattungen ausstellen

Wenn Sie die Payment Intents API verwenden, sollten Rückerstattungen für die zuletzt erstellte Zahlung ausgestellt werden.

Im Plattformkonto erstellte Zahlungen können mit dem geheimen Schlüssel des Plattformkontos rückerstattet werden. Bei Rückerstattung einer Zahlung mit einem transfer_data[destination] bleiben die Gelder standardmäßig auf dem Zielkonto, auf das sie überwiesen wurden, sodass das Plattformkonto den negativen Saldo aus der Rückerstattung abdecken muss. Um die Gelder zur Abdeckung der Rückerstattung von dem verbundenen Konto zurückzuziehen, setzen Sie den Parameter reverse_transfer beim Erstellen der Rückerstattung auf true:

Standardmäßig wird die gesamte Zahlung rückerstattet. Sie können jedoch auch eine Teilrückerstattung erstellen, indem Sie einen amount-Wert als positive Ganzzahl festlegen.

Wenn die Rückerstattung zur Folge hat, dass die gesamte Zahlung zurückerstattet wird, wird die gesamte Übertragung rückgängig gemacht. Andernfalls wird nur ein proportionaler Betrag der Übertragung rückgängig gemacht.

Plattformgebühren zurückerstatten

Wenn eine Zahlung mit einer Plattformgebühr zurückerstattet wird, behält das Plattformkonto standardmäßig die Gelder aus der Plattformgebühr ein. Um die Plattformgebühr auf das verbundene Konto zurück zu übertragen, legen Sie den Parameter refund_application_fee auf true fest, wenn Sie die Rückerstattung erstellen:

Beachten Sie Folgendes: Wenn Sie die Plattformgebühr für eine Destination Charge erstatten, müssen Sie auch die Übertragung rückgängig machen. Wenn die Rückerstattung zur Folge hat, dass die gesamte Zahlung zurückerstattet wird, wie die gesamte Plattformgebühr ebenfalls zurückerstattet. Andernfalls wird nur ein proportionaler Betrag der Plattformgebühr rückerstattet.

Alternativ können Sie den refund_application_fee-Wert false angeben und die Plattformgebühr separat über die API zurückerstatten.

Fehlgeschlagene Rückerstattungen

Wenn eine Rückerstattung fehlschlägt oder von Ihnen storniert wird, wird der Betrag der fehlgeschlagenen Rückerstattung dem Stripe-Guthaben gutgeschrieben. Erstellen Sie eine Übertragung, um das Geld nach Bedarf auf das verbundene Konto zu überweisen.

Umgang mit Zahlungsanfechtungen

Für Destination Charges, mit oder ohne on_behalf_of, belastet Stripe angefochtene Beträge und Gebühren von Ihrem Plattformkonto.

Wir empfehlen, einen Webhook einzurichten, um durch Zahlungsanfechtungen erstellte Ereignisse zu überwachen. In diesem Fall können Sie versuchen, Gelder von dem verbundenen Konto zurückzuerhalten, indem Sie die Überweisung über das Dashboard oder durch Erstellen einer Rückbuchung rückgängig machen.

Wenn das verbundene Konto einen negativen Saldo aufweist, versucht Stripe, das externe Konto zu belasten, wenn debit_negative_balances auf true festgelegt ist.

Wenn Sie der Zahlungsanfechtung widersprechen und gewinnen, können Sie die Gelder, die Sie zuvor zurückgebucht haben, auf das verbundene Konto zurücküberweisen. Wenn Ihre Plattform nicht über ausreichendes Guthaben verfügt, schlägt die Übertragung fehl. Verhindern Sie Fehler aufgrund unzureichendem Guthaben, indem Sie Gelder auf Ihr Stripe-Guthaben einzahlen.

Häufiger Fehler

Die erneute Überweisung einer früheren Rückbuchung unterliegt Beschränkungen für grenzüberschreitende Überweisungen. Das bedeutet, Sie haben möglicherweise keine Möglichkeit, eine Rückzahlung auf Ihr verbundenes Konto durchzuführen. Warten Sie stattdessen damit, angefochtene grenzüberschreitender Zahlungstransfers für Destination Charges mit on_behalf_of doch noch als Einnahmen zu buchen, bis eine Zahlungsanfechtung zu Ihren Ungunsten entschieden wurde.

In Connect eingebettete Komponenten

Destination charges are supported by Connect embedded components. By using the payments embedded component, you can enable your connected accounts to view payment information from within your site. For destination charges with on_behalf_of, you can use the destination_on_behalf_of_charge_management feature to allow your connected accounts to view additional details, manage refunds, disputes, and allow capturing payments.

Die folgenden Komponenten zeigen Informationen zu den Destination Charges an:

Payments-Komponente: Zeigt alle Zahlungen und Zahlungsanfechtungen eines Kontos an.
Zahlungsdetails: Zeigt alle Zahlungen und Zahlungsanfechtungen eines Kontos an.
Komponente „Zahlungsanfechtungen“: Zeigt alle Zahlungsanfechtungen eines Kontos an.
Komponente „Zahlungsanfechtungen für eine Zahlung“: Zeigt die Zahlungsanfechtungen für eine einzelne angegebene Zahlung an. Sie können damit Funktionen zum Management von Zahlungsanfechtungen in eine Seite Ihrer Zahlungs-Nutzeroberfläche integrieren.