Erstellen Sie Zahlungen auf Ihrem Plattformkonto und übertragen Sie die Gelder auf mehrere verbundene Konten.
Erstellen Sie separate Zahlungen und Überweisungen, um Beträge aus einer Zahlung auf mehrere verbundene Konten aufzuteilen, oder wenn bestimmte Nutzer/innen zum Zeitpunkt der Zahlung nicht bekannt sind. Die Zahlung in Ihrem Plattformkonto ist von der/den Überweisung(en) auf Ihre verbundenen Konten separat. Mit diesem Zahlungstyp gilt:
Sie erstellen eine Zahlung auf dem Konto Ihrer Plattform und übertragen außerdem Gelder auf Ihre verbundenen Konten. Die Zahlung wird auf Ihrem Konto als Abbuchung ausgewiesen und es gibt auch Übertragungen auf verbundene Konten (Betrag wird von Ihnen bestimmt), die von Ihrem Kontoguthaben eingezogen werden.
Sie können Gelder auf mehrere verbundene Konten übertragen.
Ihr Kontoguthaben wird mit Stripe-Gebühren, Rückerstattungen und Rückbuchungen belastet.
Diese Art der Zahlung eignet sich optimal für Marktplätze, die Zahlungen zwischen mehreren Parteien aufteilen müssen, wie beispielsweise bei DoorDash, einer Lieferplattform für Restaurants.
Stripe unterstützt separate Zahlungen und Überweisungen in den folgenden Regionen:
Australien
Belgien
Brasilien
Bulgarien
Dänemark
Deutschland
Estland
Finnland
Frankreich
Griechenland
Irland
Italien
Japan
Kanada
Kroatien
Lettland
Liechtenstein
Litauen
Luxemburg
Malaysia
Malta
Mexiko
Neuseeland
Niederlande
Norwegen
Österreich
Polen
Portugal
Rumänien
Schweden
Schweiz
Singapur
Slowakei
Slowenien
Spanien
Tschechische Republik
Ungarn
Vereinigte Staaten
Vereinigtes Königreich
Zypern
Bei den meisten Szenarien müssen sich Ihre Plattform und alle verbundenen Konten in derselben Region befinden. Beim Versuch, Gelder über eine unzulässige Grenze zu überweisen, wird ein Fehler zurückgegeben. Informationen zur regionsübergreifenden Unterstützung finden Sie unter grenzüberschreitende Überweisungen. Verwenden Sie Übertragungen nur in Kombination mit zulässigen Anwendungsszenarien für Zahlungen, Aufstockungen und Gebühren.
Über eine Checkout-Sitzung wird gesteuert, was die Kundinnen/Kunden auf dem Zahlungsformular sehen, z. B. Positionen, Bestellbetrag und Währung sowie die akzeptierten Zahlungsmethoden. Fügen Sie auf Ihrer Website eine Schaltfläche zum Bezahlen hinzu, die einen serverseitigen Endpoint aufruft, um eine Checkout-Sitzung zu erstellen.
line_items – Dieses Attribut stellt die Artikel dar, die der Kunde/die Kundin kauft. Die Artikel werden auf der von Stripe gehosteten Checkout-Seite angezeigt.
payment_intent_data[transfer_group] – Verwenden Sie eine eindeutige Zeichenfolge wie transfer_group, um Objekte zu identifizieren, die miteinander verknüpft sind. Wenn Stripe automatisch eine Zahlung für einen PaymentIntent mit dem Wert transfer_group erstellt, wird derselbe Wert der transfer_group der Zahlung zugewiesen.
success_url – Stripe leitet den Kunden/die Kundin nach Durchführung einer Zahlung an die Bestätigungs-URL weiter und ersetzt die Zeichenfolge {CHECKOUT_SESSION_ID} durch die ID der Checkout-Sitzung. Rufen Sie damit die Checkout-Sitzung ab und prüfen Sie den Status, um zu entscheiden, was Ihrem Kunden/Ihrer Kundin angezeigt werden soll. Sie können auch Ihre eigenen Abfrageparameter anhängen, die während des Weiterleitungsprozesses bestehen bleiben. Weitere Informationen finden Sie unter Passen Sie das Weiterleitungsverhalten mit einer von Stripe gehosteten Seite an.
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 beispielsweise das Senden einer Bestellbestätigung an Ihre Kundinnen und Kunden per E-Mail, das Protokollieren des Verkaufs in der 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 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:
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.
Senden Sie auf Ihrem Server Gelder von Ihrem Konto zu einem verbundenen Konto, indem Sie eine Übertragung erstellen und die verwendete transfer_group angeben.
Transfer und Zahlungsbeträge müssen nicht übereinstimmen. Sie können eine einzelne Zahlung auf mehrere Übertragungen aufteilen oder mehrere Zahlungen in eine einzelne Übertragung einbeziehen. Im folgenden Beispiel wird eine zusätzliche Übertragung erstellt, die der gleichen transfer_group zugeordnet ist.
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 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 der Funktion card_payments unterstützt. Konten, denen der Empfänger-Rahmenvertrag zugrunde liegt, können keine card_payments anfordern.
Bei der Verwendung separater Zahlungen und Überweisungen kann die Plattform Gebühren für eine Zahlung einziehen, indem sie den Betrag reduziert, den sie auf die Zielkonten überweist. Nehmen Sie zum Beispiel eine Transaktion mit einem Lieferservice in einem Restaurant, bei der das Restaurant und der/die Fahrer/in bezahlt werden:
Der Kunde/die Kundin zahlt 100 USD.
Stripe erhebt eine Gebühr von 3,20 USD und fügt die verbleibenden 96,80 USD dem ausstehenden Guthaben des Plattformkontos hinzu.
Die Plattform überweist 70 USD auf das verbundene Konto des Restaurants und 20 USD auf das verbundene Konto des Fahrers/der Fahrerin.
Eine Plattformgebühr von 6,80 USD verbleibt auf dem Plattformkonto.
Informationen zur Verarbeitung von Zahlungen in mehreren Währungen mit Connect finden Sie unter Mit mehreren Währungen arbeiten.
Verfügbarkeit von Überweisungen
Standardmäßig werden Gelder aus dem verfügbaren Guthaben des Plattformkontos überwiesen. Der Versuch einer Überweisung, die das verfügbare Guthaben übersteigt, schlägt mit einem Fehler fehl. Um dieses Problem zu vermeiden, verknüpfen Sie eine Überweisung beim Erstellen mit einer bestehenden Zahlung, indem Sie die Zahlungs-ID als source_transaction-Parameter angeben. Mit einer source_transaction meldet die Übertragungsanfrage erfolgreich zurück, unabhängig von Ihrem verfügbaren Guthaben. Die Gelder werden auf dem Zielkonto jedoch erst verfügbar, wenn die Gelder aus der zugehörigen Zahlung vom Plattformkonto überwiesen werden können.
Wenn die Quellenzahlung den Wert transfer_group hat, weist Stripe denselben Wert der transfer_group der Übertragung zu. Ist dies nicht der Fall, generiert Stripe eine Zeichenfolge im Format group_ plus der zugehörigen PaymentIntent-ID, zum Beispiel: group_pi_2NHDDD589O8KAxCG0179Du2s. Diese Zeichenfolge wird sowohl für die Zahlung als auch für die Überweisung als transfer_group zugewiesen.
Notiz
Sie müssen die source_transaction angeben, wenn Sie eine Übertragung erstellen. Sie können dieses Attribut später nicht aktualisieren.
Sie können die Zahlungs-ID dem PaymentIntent entnehmen:
Rufen Sie das Attribut neueste_Zahlung des PaymentIntent ab. Bei diesem Attribut handelt es sich um die ID der neuesten Abbuchung, die mit PaymentIntent verknüpft ist.
Fordern Sie eine Liste von Zahlungen an, wobei Sie den payment_intent in der Anfrage angeben. Diese Methode gibt vollständige Daten für alle Zahlungen zurück, die mit dem PaymentIntent verknüpft sind.
Folgendes gilt bei Verwendung dieses Parameters:
Der Überweisungsbetrag darf nicht den Betrag der zugrundeliegenden Zahlung übersteigen.
Sie können mehrere Überweisungen mit dem gleichen Parameter source_transaction erstellen, solange die Summe der Überweisungen die zugrunde liegende Zahlung nicht übersteigt.
Die Überweisung übernimmt von der zugehörigen Zahlung den Status „Ausstehend“: Wenn die Gelder von der Zahlung in N Tagen verfügbar werden, wird auch die Zahlung, die das Stripe-Zielkonto durch die Überweisung empfängt, in N Tagen verfügbar.
Stripe erstellt automatisch eine transfer_group für Sie.
Die Währung der Saldotransaktion, die mit der Abbuchung verknüpft ist, muss mit der Währung der Überweisung übereinstimmen
Asychrone Zahlungsmethoden wie ACHkönnen nach einer nachfolgenden Überweisungsanfrage fehlschlagen. Vermeiden Sie für diese Zahlungen die Verwendung von source_transaction. Warten Sie stattdessen, bis ein charge.succeeded-Ereignis ausgelöst wird, bevor Sie die Gelder überweisen. Wenn Sie bei diesen Zahlungen source_transaction verwenden, müssen Sie Funktionen zum Umgang mit Zahlungsfehlern implementieren.
Wenn eine als source_transaction verwendete Zahlung fehlschlägt, werden Gelder aus dem Guthaben Ihres Plattformkontos auf das verbundene Konto überwiesen, um die Zahlung zu decken. Um diese Gelder zurückzuerhalten, können Sie die Überweisung im Zusammenhang mit der fehlgeschlagenen source_transactionzurückbuchen.
Überweisungsoptionen
Sie können der Zeichenfolge transfer_group einen beliebigen Wert zuweisen, solange dieser für einen einzelnen Geschäftsvorgang steht. Zudem können Sie Überweisungen ohne zugehörige Zahlung oder Angabe einer transfer_group durchführen, zum Beispiel wenn Sie einen Dienstleister bezahlen müssen und diesem Vorgang keine Kundenzahlung zugrunde liegt.
Notiz
Die transfer_group identifiziert nur zugehörige Objekte. Sie hat keine Auswirkungen auf die Standardfunktionalität. Um zu verhindern, dass eine Übertragung ausgeführt wird, bevor die Gelder aus der zugehörigen Zahlung verfügbar sind, verwenden Sie das Attribut source_transaction der Überweisung.
Transfer und Zahlungsbeträge müssen nicht übereinstimmen. Sie können eine einzelne Zahlung auf mehrere Überweisungen aufteilen oder mehrere Zahlungen in eine Überweisung einbeziehen. Sie können Überweisungen und Zahlungen in beliebiger Reihenfolge durchführen.
Standardmäßig schlägt eine Überweisungsanfrage fehl, wenn der Betrag das verfügbare Kontoguthaben der Plattform übersteigt. Sie können stattdessen den Überweisungsbetrag mit der zugehörigen Zahlung vergleichen, indem Sie diese Zahlung als source_transaction der Überweisung angeben. In diesem Fall ist die Überweisungsanfrage automatisch erfolgreich, wird aber erst ausgeführt, wenn die Gelder aus dieser Zahlung auf dem Plattformkonto verfügbar sind.
Notiz
Wenn Sie separate Zahlungen und Überweisungen verwenden, berücksichtigen Sie dies bei der Planung Ihres Auszahlungs-Plans. Automatische Auszahlungen können Transfers stören, für die keine source_transaction definiert ist.
Rückerstattungen ausstellen
Zahlungen, die auf Ihrer Plattform erstellt wurden, können Sie mithilfe des Geheimschlüssels Ihrer Plattform zurückerstatten. Die Rückerstattung einer Zahlung hat allerdings keine Auswirkungen auf damit verbundene Übertragungen. Es obliegt Ihrer Plattform, geschuldete Beträge einzutreiben, indem Sie die Höhe künftiger Übertragungen reduzieren oder Transfers zurückbuchen.
Connect unterstützt die Rückbuchung von Überweisungen, die an verbundene Konten erfolgt sind, entweder in voller Höhe oder in Teilen (durch Festlegen eines Werts für amount):
Durch eine Rückbuchung wird der angegebene Teilbetrag (oder der Gesamtbetrag) einer Überweisung wieder dem verfügbaren Guthaben der Plattform gutgeschrieben, wodurch sich das verfügbare Guthaben des verbundenen Kontos entsprechend verringert. Eine Überweisung kann nur zurückgebucht werden, wenn das verfügbare Guthaben des verbundenen Kontos höher als der Rückbuchungsbetrag ist oder wenn verbundene Rückstellungen aktiviert sind.
Wenn für die Rückbuchung die Währung umgerechnet werden muss, wird ein Fehler zurückgegeben, falls der Rückbuchungsbetrag nach der Währungsumrechnung zu einem Kontostand von null führt.
Welcome to the Stripe Shell!
Stripe Shell is a browser-based shell with the Stripe CLI pre-installed. Log in to your
Stripe account and press Control + Backtick (`) on your keyboard to start managing your Stripe
resources in test mode.
- View supported Stripe commands:
- Find webhook events:
- Listen for webhook events:
- Call Stripe APIs: stripe [api resource] [operation] (e.g., )
Stripe Shell wurde für die Verwendung am Desktop konzipiert.