Geld auszahlen

Installieren Sie die offiziellen Bibliotheken von Stripe für den Zugriff auf die Stripe-API über Ihre Anwendung:

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Wenn sich ein/e Nutzer/in (Verkäufer/in oder Dienstleister/in) auf Ihrer Plattform anmeldet, erstellen Sie ein Nutzerkonto (auch verbundenes Konto genannt), damit Sie Zahlungen einziehen und anschließend an die Nutzer/innen auszahlen können. Verbundene Konten entsprechen in der Stripe-API Ihren Nutzer/innen und helfen, die für die Identitätsprüfung der Nutzer/innen erforderlichen Informationen zu erfassen. In unserem Beispiel mit dem Frage-Antwort-Portal ist das verbundene Konto der/die Autor/in.

Registrierformular anpassen

Ihr Express-Registrierformular passen Sie in Ihren Plattform-Einstellungen an. Sie können zum Beispiel die Farben und Logos ändern, die Nutzer/innen sehen, wenn sie auf Ihren Connect-Link klicken.

Standard-Registrierformular für Express

Branding-Einstellungen

Verbundenes Konto erstellen und Informationen vorab ausfüllen

Verwenden Sie die /v1/accounts API, um ein verbundenes Konto zu erstellen. Sie können das verbundene Konto erstellen, indem Sie die Eigenschaften des verbundenen Kontos oder den Kontotyp angeben.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "controller[losses][payments]"=application \
  -d "controller[fees][payer]"=application \
  -d "controller[stripe_dashboard][type]"=express

Falls Sie bereits Informationen für Ihre verbundenen Konten erfasst haben, können Sie diese im Account-Objekt vorab angeben. Sie können beliebige Kontoinformationen vorab ausfüllen, einschließlich der Unternehmens- oder Personendaten, externer Kontodaten usw.

Connect Onboarding fragt keine vorab ausgefüllten Informationen ab. Kontoinhaber/innen müssen vorausgefüllte Informationen jedoch bestätigen, bevor sie den Connect-Rahmenvertrag akzeptieren können.

Füllen Sie beim Testen Ihrer Integration die Kontoinformationen vorab mit Testdaten aus.

Konto-Link erstellen

Erstellen Sie einen Konto-Link mit den folgenden Parametern:

• account
• refresh_url
• return_url
• type = account_onboarding

curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  --data-urlencode refresh_url="https://example.com/reauth" \
  --data-urlencode return_url="https://example.com/return" \
  -d type=account_onboarding

Nutzer/innen an den Konto-Link weiterleiten

Die Antwort auf Ihre Account Links-Anfrage enthält einen Wert für den Schlüssel url. Leiten Sie Ihre Nutzer/innen an diesen Link weiter. URLs von der Account Links API sind temporär und können nur einmal verwendet werden, da sie Zugang zu den persönlichen Daten der Kontoinhaber/innen gewähren. Führen Sie die Authentifizierung der Nutzer/innen in Ihrer Anwendung durch, bevor Sie sie an diese URL weiterleiten. Wenn Sie Informationen vorab angeben möchten, müssen Sie dies vor der Erstellung des Konto-Links tun. Nach der Erstellung des Konto-Links können Informationen für das verbundene Konto weder angezeigt noch geändert werden.

Umgang mit Nutzerinnen/Nutzern, die zu Ihrer Plattform zurückkehren

Connect Onboarding verlangt, dass Sie sowohl eine return_url als auch eine refresh_url übergeben, um alle Fälle steuern zu können, in denen die Nutzer/innen an Ihre Plattform weitergeleitet werden. Es ist wichtig, dass Sie diese URLs korrekt implementieren, um Ihren Nutzerinnen/Nutzern die bestmögliche Erfahrung zu bieten.

return_url

Stripe löst eine Weiterleitung zu dieser URL aus, wenn die Nutzer/innen das Connect Onboarding abschließen. Das heißt nicht, dass alle Informationen erfasst wurden oder keine offenen Anforderungen für das Konto bestehen. Es bedeutet lediglich, dass die Nutzer/innen das Verfahren ordnungsgemäß durchlaufen und beendet haben.

Über diese URL wird kein Status übergeben. Nachdem Nutzer/innen zu Ihrer return_url weitergeleitet wurden, überprüfen Sie den Status des Parameters details_submitted für das jeweilige Konto, indem Sie eine der folgenden Aktionen ausführen:

• account.updated-Ereignisse überwachen.
• Rufen Sie die Accounts-API auf und prüfen Sie das zurückgegebene Objekt.

refresh_url

Ihre Nutzer/innen werden in den folgenden Fällen an die refresh_url weitergeleitet:

• Der Link ist abgelaufen (seit Erstellung des Links sind ein paar Minuten vergangen).
• Der Link wurde bereits aufgerufen (die Nutzer/innen haben die Seite aktualisiert oder auf die Zurück/Vorwärts-Schaltfläche geklickt).
• Der Link wurde in einer Drittanbieteranwendung (z. B. einem Messaging-Client) geteilt, die versucht hat, auf die URL zuzugreifen und sie in der Vorschau anzuzeigen. Viele Clients besuchen Links automatisch. Dies kann jedoch dazu führen, dass die Links ablaufen.
• Ihre Plattform hat keinen Zugang mehr zu diesem Konto.
• Das Konto wurde abgelehnt.

Für ein nahtloses Erlebnis sollte die refresh_url Account Links mit denselben Parametern auf Ihrem Server erneut aufrufen und Nutzer/innen an das Connect Onboarding weiterleiten.

Umgang mit Nutzerinnen/Nutzern, die das Onboarding nicht abgeschlossen haben

Wenn Nutzer/innen an Ihre return_url weitergeleitet werden, haben sie das Onboarding möglicherweise nicht abgeschlossen. Rufen Sie mithilfe des Endpoints /v1/accounts das Nutzerkonto auf und prüfen Sie den Wert für charges_enabled. Wenn das Onboarding für das Konto nicht komplett abgeschlossen wurde, geben Sie den Nutzerinnen/Nutzern mithilfe entsprechender Eingabeaufforderungen der Nutzeroberfläche die Möglichkeit, das Onboarding zu einem späteren Zeitpunkt fortzusetzen. Diese können ihre Konto-Aktivierung über einen neuen (von Ihrer Integration generierten) Link abschließen. Anhand des Status des Parameters details_submitted im Nutzerkonto können Sie überprüfen, ob das Onboarding abgeschlossen wurde.

Rufen Sie in Ihrem Dashboard den Abschnitt Salden auf, um Gelder einzuzahlen. Klicken Sie auf Zum Guthaben hinzufügen und wählen Sie einen Grund für das Hinzufügen der Gelder aus.

Klicken Sie auf Verbundene Konten auszahlen, um Gelder einzuzahlen, die an Ihre verbundenen Konten ausgezahlt werden sollen. Wenn Sie Gelder in Ihr Guthaben einzahlen, um damit zukünftige Rückerstattungen und Zahlungsanfechtungen zu finanzieren oder einen negativen Kontostand Ihrer Plattform auszugleichen, klicken Sie auf Negative Salden decken. Weitere Informationen finden Sie unter Einzahlen von Geldern in Ihr Stripe-Guthaben.

Bankkonto verifizieren

Wenn Sie versuchen, Gelder von einem nicht verifizierten Bankkonto hinzuzufügen, durchlaufen Sie beim ersten Mal den Verifizierungsvorgang im Dashboard. Wenn Ihr Bankkonto nicht verifiziert ist, müssen Sie zwei Testeinzahlungen von Stripe bestätigen. Diese Einzahlungen erscheinen innerhalb von 1 bis 2 Werktagen auf Ihrem Online-Kontoauszug. Auf dem Auszug sehen Sie ACCTVERIFY als Zahlungsbeschreibung.

Stripe benachrichtigt Sie im Dashboard und per E-Mail über den Eingang der Testeinzahlungen auf Ihrem Konto. Um den Verifizierungsvorgang abzuschließen, klicken Sie auf die Dashboard-Benachrichtigung im Abschnitt Salden. Geben Sie dort die Beträge der beiden Testeinzahlungen ein und klicken Sie auf Konto verifizieren.

Aufladung erstellen

Sobald die Verifizierung erfolgt ist, können Sie eine Aufladung erstellen, um Gelder in Ihr Kontoguthaben einzuzahlen.

curl https://api.stripe.com/v1/topups \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=2000 \
  -d currency=usd \
  -d description="Top-up for week of May 31" \
  -d statement_descriptor="Weekly top-up"

Wenn Sie Geld überweisen, erscheint auf Ihrem Kontoauszug eine Zahlungsbeschreibung für die Transaktion. Die Standard-Zahlungsbeschreibung lautet Aufladung. Sie können die Zahlungsbeschreibung in der Abrechnung und die interne Beschreibung für die Aufladung anpassen.

Gelder anzeigen

Sie können Ihre eingezahlten Gelder im Dashboard auf der Seite Salden auf der Registerkarte Aufladungen anzeigen. Immer wenn Sie Gelder hinzufügen, wird ein Aufladungsobjekt mit einer einzigartigen ID im Format tu_XXXXXX erstellt. Dieses können Sie in der detaillierten Ansicht für die Aufladung einsehen.

Dauer der Abwicklung

In den USA können Plattformen Einzahlungen per ACH-Lastschrift vornehmen. Es kann 5 bis 6 Werktage dauern, bis die Gelder in Ihrem Stripe-Guthaben verfügbar sind. Über den Stripe-Support können Sie eine Prüfung Ihres Kontos zur Beschleunigung der Abwicklungsdauer anfordern.

Sobald wir mehr über Ihr Konto wissen, kann Stripe Ihre Abwicklungsdauer ggf. automatisch verkürzen.

Für künftige Rückerstattungen und Zahlungsanfechtungen oder zum Ausgleichen negativer Kontostände können Gelder per Banküberweisung eingezahlt werden. Sie sind dann innerhalb von 1 bis 2 Werktagen verfügbar.

Sie können verfügbare Gelder über die API an ein verbundenes Konto überweisen. Mit dem folgenden Aufruf überweisen Sie zum Beispiel 10 USD an ein Konto:

curl https://api.stripe.com/v1/transfers \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d amount=1000 \
  -d currency="usd" \
  -d destination="{{CONNECTED_STRIPE_ACCOUNT_ID}}"

Jede Zahlung, die Sie an ein verbundenes Konto übertragen, fließt standardmäßig in das Stripe-Guthaben des verbundenen Kontos und wird täglich fortlaufend ausgezahlt. Bei Bedarf können Sie den Auszahlungsplan jedoch anpassen.

In Ihrem Konto-Dashboard können Sie ein Konto und dessen Guthaben anzeigen.

Mit den Test-Banktoken können Sie Abläufe für Konten sowie das Onboarding, Auszahlungen und das Einzahlen von Geldern simulieren.