Direct Charges erstellen

Erstellen Sie Zahlungen direkt auf dem verbundenen Konto und erheben Sie Gebühren.

Erstellen Sie Direct Charges, wenn Kunden/Kundinnen direkt mit einem verbundenen Konto interagieren, während Ihre Plattform dabei im Hintergrund bleibt. Bei Direct Charges:

Die Zahlung wird auf dem verbundenen Konto als Abbuchung ausgewiesen, nicht auf dem Konto Ihrer Plattform.
Das Guthaben des verbundenen Kontos erhöht sich mit jeder Zahlung.
Ihr Kontoguthaben erhöht sich mit jeder Zahlung um die Plattformgebühren.

Dieser Zahlungstyp eignet sich am besten für Plattformen, die Software as a Service anbieten. Shopify bietet beispielsweise Tools zum Erstellen von Online-Shops und Thinkific ermöglicht es Lehrkräften, Online-Kurse zu geben.

Notiz

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

Web

iOS

Android

React Native

Führen Sie mithilfe von Stripe Checkout eine Weiterleitung an eine von Stripe gehostete Zahlungsseite durch. Sehen Sie sich diese Integration im Vergleich zu anderen Integrationstypen von Stripe an.

Integrationsaufwand

Kaum Code

Integrationstyp

An die von Stripe gehostete Zahlungsseite weiterleiten

Anpassung der Nutzeroberfläche

Eingeschränkte Anpassung

Jetzt testen

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
Clientseitig
Serverseitig

Über eine Checkout-Sitzung wird gesteuert, was die Kundinnen/Kunden auf dem Zahlungsformular sehen, z. B. Posten, Bestellbetrag und Währung. Fügen Sie auf Ihrer Website eine Schaltfläche zum Bezahlen hinzu, die einen serverseitigen Endpoint aufruft, um eine Checkout-Sitzung zu erstellen.

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

Erstellen Sie auf Ihrem Server eine Checkout-Sitzung und leiten Sie Ihre Kundinnen/Kunden an die in der Antwort zurückgegebene URL weiter.

line_items – Dieses Attribut stellt Artikel dar, die Ihr Kunde/Ihre Kundin kauft und wird auf der von Stripe gehosteten Checkout-Seite angezeigt.
payment_intent_data[application_fee_amount] – Dieses Attribut gibt den Betrag an, den Ihre Plattform als Plattformgebühr von der Transaktion abzieht. Nachdem die Zahlung für das verbundene Konto verarbeitet wurde, wird der application_fee_amount an die Plattform übertragen. Weitere Informationen finden Sie unter Gebühren erheben.
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-Account: Dieser Header gibt eine Direct Charge für Ihr verbundenes Konto an. 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.

Zahlungen, die Sie direkt über das verbundene Konto erstellen, werden nur für dieses Konto gemeldet. Diese Zahlungen werden im Dashboard Ihrer Plattform oder in den Exporten nicht angezeigt. Direct Charges sind in Berichten und Sigma für verbundene Konten enthalten, die Ihre Plattform steuert. Sie können diese Informationen jederzeit über die Stripe-API abrufen.

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 einziehen

Ihre Plattform kann eine Plattformgebühr unter Berücksichtigung der folgenden Einschränkungen erheben:

Der Wert von application_fee_amount muss positiv und kleiner als der Betrag der Zahlung sein. Die erhobene Plattformgebühr wird auf den Betrag der Zahlung begrenzt.
Es fallen keine zusätzlichen Stripe-Gebühren für die Plattformgebühr selbst an.
In Übereinstimmung mit gesetzlich vorgeschriebenen und Compliance-Anforderungen in Brasilien können Plattformen mit Sitz außerhalb Brasiliens und mit brasilianischen verbundenen Konten keine Plattformgebühren über Stripe einziehen.
Die Währung des application_fee_amount hängt von einigen Faktoren für mehrere Währungen ab.

Die Saldo-Transaktion der sich ergebenden Zahlung beinhaltet eine detaillierte Gebührenaufschlüsselung sowohl der Stripe-Gebühren als auch der Plattformgebühren. Um eine bessere Berichterstellung zu ermöglichen, wird ein Plattformgebühr-Objekt erstellt, sobald die Gebühr eingezogen wurde. Verwenden Sie die Eigenschaft amount des Plattformgebühren-Objekts für die Berichterstellung. Anschließend können Sie mit dem Endpoint für Plattformgebühren auf diese Objekte zugreifen.

Erhaltene Plattformgebühren werden Ihrem verfügbaren Kontosaldo nach demselben Zeitplan hinzugefügt wie Gelder aus regulären Stripe-Zahlungen. Plattformgebühren können im Abschnitt Erhobene Gebühren des Dashboards angezeigt werden.

Vorsicht

Die Anmeldegebühren für Direct Charges werden standardmäßig asynchron erstellt. Wenn Sie das application_fee-Objekt in einer Anfrage zur Erstellung von Zahlungen erweitern, wird die Plattformgebühr synchron als Teil dieser Anfrage erstellt. Erweitern Sie das application_fee-Objekt nur dann, wenn Sie es unbedingt müssen, da dies die Latenz der Anfrage erhöht.

Um auf die Plattformgebührenobjekte für Plattformgebühren, die asynchron erstellt werden, zuzugreifen, überwachen Sie das Webhook-Ereignis application_fee.created.

Geldbewegungen mit Gebühren

Wenn Sie eine Plattformgebühr für eine Zahlung angeben, wird der Gebührenbetrag auf das Stripe-Konto Ihrer Plattform übertragen. Wird eine Zahlung direkt über das verbundene Konto abgewickelt, wird der Zahlungsbetrag – abzüglich der Stripe-Gebühren und der Plattformgebühr – in das verbundene Konto eingezahlt.

Wenn Sie beispielsweise eine Zahlung in Höhe von 10 USD mit einer Plattformgebühr von 1,23 USD vornehmen (wie im vorherigen Beispiel), werden 1,23 USD auf Ihr Plattformkonto überwiesen. 8,18 USD (10 USD – 0,59 USD – 1,23 USD) werden im verbundenen Konto verrechnet (wobei standardmäßig US-Stripe-Gebühren angenommen werden).

Geldbewegungen bei einer Zahlung mit Plattformgebühr

Wenn Sie Zahlungen in mehreren Währungen abwickeln, lesen Sie die Informationen zur Handhabung von Währungen in Connect.

Branding anpassen

Ihre Plattform und verbundene Konten können die Branding-Einstellungen im Dashboard verwenden, um das Branding auf der Zahlungsseite anzupassen. Für Direct Charges verwendet Checkout die Markeneinstellungen des verbundenen Kontos.

Sie können auch die API verwenden, um die Branding-Einstellungen zu aktualisieren:

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.

Rückerstattungen ausstellen

Ebenso wie Plattformen Zahlungen für verbundene Konten erstellen können, können sie auch Rückerstattungen von Zahlungen für verbundene Konten erstellen. Erstellen Sie eine Rückerstattung mit dem Geheimschlüssel Ihrer Plattform, während Sie als das verbundene Konto authentifiziert sind.

Plattformgebühren werden bei Ausstellung einer Rückerstattung nicht automatisch zurückerstattet. Ihre Plattform muss die Plattformgebühr explizit zurückerstatten. Andernfalls büßt das verbundene Konto, d. h. das Konto, auf dem die Zahlung erstellt wurde, diesen Betrag ein. Sie können eine Plattformgebühr zurückerstatten, indem Sie in der Erstattungsanfrage für den Wert refund_application_fee true angeben:

Standardmäßig wird die gesamte Zahlung zurückerstattet. Sie können jedoch auch eine Teilerstattung erstellen, indem Sie den Wert amount als positive ganze Zahl festlegen. Wenn die Erstattung zu einer Rückerstattung der gesamten Zahlung führt, wird die gesamte Plattformgebühr zurückerstattet. Andernfalls wird ein anteiliger Betrag der Plattformgebühr zurückerstattet. Alternativ können Sie den Wert refund_application_fee als false angeben und die Plattformgebühr getrennt erstatten.