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.
Ü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.
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. Siehe
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.
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.
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).
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.
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_feetrue 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.
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.