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

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 Wä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.

line_items: Dieses Attribut stellt Artikel dar, die Ihr Kunde/Ihre Kundin kauft und die im eingebetteten Zahlungsformular angezeigt werden.
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.
return_url – Stripe leitet den Kunden/die Kundin nach Durchführung eines Zahlungsversuchs an die Rückgabe-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. Vergewissern Sie sich, dass die Rückgabe-URL einer Seite auf Ihrer Website entspricht, die den Status der Zahlung zeigt. 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 einem integrierten Formular 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 nicht im Dashboard Ihrer Plattform, in den Exporten oder anderen Berichten angezeigt, obwohl Sie diese Informationen stets mit der Stripe-API abrufen können.

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/v3/"></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 und der verbundenen Konto-ID. Ü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'
, {
   stripeAccount: {{CONNECTED_ACCOUNT_ID}}
,
});

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 einziehen

Wenn eine Zahlung verarbeitet wird, kann Ihre Plattform einen Teil der Transaktion in Form von Plattformgebühren übernehmen. Sie können die Preise für die Plattformgebühr auf zwei Arten festlegen:

Mit dem Plattform-Preistool können Sie Preisregeln 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 Ihre Preisregeln intern fest und geben Sie die Plattformgebühren direkt in einem PaymentIntent an. Die mit dieser Methode festgelegten Gebühren überschreiben die im Plattform-Preistool angegebene Preislogik.

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 erfassten Zahlungsbetrag 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

Plattformgebühren für Direct Charges werden standardmäßig asynchron erstellt. Wenn Sie das application_fee-Objekt in einer Zahlungserstellungsanfrage erweitern, wird die Plattformgebühr synchron als Teil dieser Anfrage erstellt. Erweitern Sie das application_fee-Objekt nur bei Bedarf, 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 die API auch 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.