Migrieren von Konten zu Stripe

Mit Stripe können Sie Ihre bestehenden verbundenen Konten zusammen mit Ihren Zahlungs- und Kundendaten migrieren. Dann können Sie weiterhin Zahlungen einziehen und auszahlen oder anderen Unternehmen die direkte Annahme von Zahlungen ermöglichen. Anleitung). Um Ihr bestehendes Plattform-Geschäft erfolgreich zu Stripe zu bringen, müssen Sie:

1. Migrationsplan und Zeitplan erstellen
2. Integration für verbundene Konten aktualisieren
3. Erstellung und Onboarding von Konten
4. Umgang mit ausstehenden und laufenden Anforderungen
5. Zahlungs- und Kundendaten zu Stripe übertragen

Migrationsplan erstellen

Für eine erfolgreich Migration zu Stripe sind ein Migrationsplan, einen Zeitplan und KYC-Informationen für verbundene Konten sowie Zahlungs- und Kundendaten erforderlich.

Verbundene Konten müssen das Onboarding bei Stripe durchlaufen, was die Übermittlung von KYC-Daten (Know Your Customer) erfordert. Stripe benötigt deshalb manchmal zusätzliche Informationen von Ihren Konten. Führen Sie eine Analyse durch, um zu ermitteln, welche Daten Ihr bisheriger Anbieter erfasst hat und welche Daten Stripe benötigt. Stripe verifiziert die KYC-Daten, bevor verbundene Konten aktiviert werden. Den Verifizierungsstatus des Kontos können Sie über das account.updated-Ereignis oder die Retrieve Account API überwachen. Für Konten, die nicht verifiziert werden können, sind vor der Aktivierung weitere Maßnahmen erforderlich.

Fügen Sie ein festes Umstellungsdatum für die Zahlungsdaten ein, nachdem Sie die Konten zu Stripe übertragen haben. Für die Zahlungs- und Kundendaten ist im Rahmen der Umstellung ein PAN-Import erforderlich. Wir empfehlen, die Konten in Batches zu importieren.

Integration aktualisieren

An Ihrer Anwendung sind im Rahmen der Integrationsaktualisierungen möglicherweise Änderungen erforderlich für die Migration zu Stripe. Sie müssen dabei beispielsweise auch an Änderungen an der Nutzung Ihrer Plattform durch Ihre verbundenen Konten, wie z. B. Preisaktualisierungen denken. Stripe empfiehlt, Ihren Konten alle Änderungen im Voraus mitzuteilen.

Allgemeine Geschäftsbedingungen von Stripe

Ihre verbundenen Konten müssen den allgemeinen Geschäftsbedingungen von Stripe zustimmen, bevor sie aktiviert werden können.

Bei Konten, bei denen Stripe dafür verantwortlich ist, aktualisierte Informationen zu erfassen, wenn Anforderungen fällig sind oder sich ändern (einschließlich Standard- und Express-Konten), akzeptiert das Konto die allgemeinen Geschäftsbedingungen von Stripe als Teil des Onboarding-Ablaufs.

Wenn Ihre Plattform bei Änderungen der Anforderungen dafür verantwortlich ist, von einem verbundenen Konto (einschließlich Custom-Konten9 aktualisierte Informationen zu erfassen, können Sie die allgemeinen Geschäftsbedingungen von Stripe in Ihre eigenen Bedingungen integrieren. Wir empfehlen, die Zustimmung zu den Bedingungen am Ende Ihres Onboarding-Ablaufs zu platzieren. Wenn es für Ihr Unternehmen sinnvoller ist, können Sie diese jedoch auch an den Anfang stellen. Wenn Sie verbundene Konten erstellen oder aktualisieren, zeichnen Sie die Zustimmung zu den aktualisierten allgemeinen Geschäftsbedingungen auf und senden diese an Stripe. Teilen Sie dies den Konten unbedingt vorab mit.

Verbundene Konten zum Onboarding bei Stripe einladen

Stripe bietet Ihren verbundenen Konten Onboarding-Support auf unterschiedlichem Niveau. Erstellen Sie mit einer der folgenden Methoden einen Onboarding-Ablauf für Ihre verbundenen Konten:

Erstellung und Onboarding von Konten

Der Vorgang läuft so ab:

Kontoanforderungen festlegen

Die folgenden Faktoren wirken sich auf die Onboarding-Anforderungen für Ihre verbundenen Konten aus:

• Das Ursprungsland der verbundenen Konten
• Art des Rahmenvertrags, der für die verbundenen Konten gilt
• Für die verbundenen Konten angeforderte Funktionen
• Der business_type (zum Beispiel Einzelperson oder Unternehmen) und die company.structure (zum Beispiel public_corporation oder private_partnership)

Verwenden Sie das interaktive Formular, um festzustellen, wie sich das Ändern dieser Faktoren auf die Anforderungen auswirkt.

Verbundenes Konto erstellen

Erstellen Sie für jedes Konto, das zu Stripe übertragen werden soll, ein zugehöriges Konto.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "controller[fees][payer]"=account \
  -d "controller[losses][payments]"=stripe \
  -d "controller[stripe_dashboard][type]"=none \
  -d "controller[requirement_collection]"=stripe \
  -d country=US \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true

{
  ...
  "id": 
"{{CONNECTED_ACCOUNT_ID}}",
  ...
}

{
  ...
  "requirements": {
    "alternatives": [],
    "current_deadline": null,
    "currently_due": [
      "business_profile.url",
      "external_account",
      "individual.first_name",
      "individual.last_name",
      "tos_acceptance.date",
      "tos_acceptance.ip"
    ],
    "disabled_reason": "requirements.past_due",
    "errors": [],

Umgang mit ausstehenden und laufenden Anforderungen

Nachdem die Daten des verbundenen Kontos übermittelt wurden, verifiziert Stripe diese. Dieser Vorgang kann je nach Art der Verifizierung Minuten oder Stunden dauern. Während der Ausführung dieses Vorgangs befinden sich die angeforderten Funktionen im status pending.

Status prüfen

Sie können den Status der Funktionen Ihres verbundenen Kontos wie folgt abrufen:

• Der Funktions-Hash des Account-Objekts wird auf die relevante Funktion hin geprüft.
• Funktionen werden direkt von der Capabilities API angefordert und der Status der relevanten Funktion wird überprüft.
• Ereignisse des Typs account.updated werden in Ihrem Webhook-Endpoint überwacht und der Hash capabilities wird auf die entsprechende Funktion überprüft.

Nachdem die Verifizierungen abgeschlossen sind, wird eine Funktion active und steht dem verbundenen Konto zur Verfügung. Kontoverifizierungen werden kontinuierlich durchgeführt, und wenn eine zukünftige Verifizierung fehlschlägt, kann eine Funktion aus dem Status active heraus wechseln. Überwachen Sie account.updated-Ereignisse, um Änderungen am Funktionsstatus zu erkennen.

Bestätigen Sie, dass Ihre Connect-Integration konform und betriebsbereit ist, indem Sie überprüfen, ob charges_enabled und payouts_enabled für das Konto beide „true“ sind. Sie können die API verwenden oder Ereignisse des Typs account.updated überwachen. Details zu anderen relevanten Feldern finden Sie im Hash Anforderungen des Kontos. Sie können die Integration nicht anhand eines einzelnen Werts bestätigen, da die Status je nach Anwendung und verwandten Richtlinien variieren können.

• charges_enabled bestätigt, dass Ihr vollständiger Zahlungspfad, einschließlich Zahlung und Überweisung, korrekt funktioniert, und prüft, ob die Funktionen card_payments oder transfers aktiv sind.
• payouts_enabled gibt Auskunft darüber, ob Ihr verbundenes Konto Auszahlungen an ein externes Konto vornehmen kann. Je nach Ihren Risikorichtlinien können Sie zulassen, dass Ihr verbundenes Konto Transaktionen ausführt, auch wenn es noch keine Auszahlungen aktiviert hat. Sie müssen die Auszahlungen jedoch zu einem späteren Zeitpunkt aktivieren, um Gelder an Ihre verbundenen Konten auszahlen.

Sie können die folgende Logik als Ausgangspunkt für die Definition einer Statusübersicht verwenden, die Ihrem verbundenen Konto angezeigt wird.

# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'

def account_state(account)
  reqs = account.requirements

  if reqs.disabled_reason && reqs.disabled_reason.include?("rejected")
    "rejected"
  elsif account.payouts_enabled && account.charges_enabled
    if reqs.pending_verification
      "pending enablement"
    elsif !reqs.disabled_reason && !reqs.currently_due
      if !reqs.eventually_due
        "complete"
      else
        "enabled"
      end
    else
      "restricted"
    end
  elsif !account.payouts_enabled && account.charges_enabled
    "restricted (payouts disabled)"
  elsif !account.charges_enabled && account.payouts_enabled
    "restricted (charges disabled)"
  elsif reqs.past_due
    "restricted (past due)"
  elsif reqs.pending_verification
    "pending (disabled)"
  else
    "restricted"
  end
end

accounts = Stripe::Account.list(limit: 10)

accounts.each do |account|
    puts "#{account.id} has state: #{account_state(account)}"
end

Umgang mit Verifizierungsfehlern

Gehen Sie je nach Onboarding-Prozess unterschiedlich mit fehlgeschlagenen Verifizierungen um.

Zahlungs- und Kundendaten zu Stripe übertragen

Nachdem Sie Ihre verbundenen Konten bei Stripe erstellt haben, fordern Sie einen PAN-Datenimport an. Dadurch werden Ihre Zahlungs- und Kundendaten für die Verwendung bei Stripe übertragen.