Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden

Integrationsleitfaden für Embedded Finance

Erstellen Sie mit Issuing und Treasury eine eingebettete Integration für Finanzdienstleistungen.

Erstellen Sie mit Stripe Issuing und Stripe Treasury ein integriertes US-Finanzdienstleistungsangebot. Mit Issuing können Sie Karten erstellen und mit Treasury Guthaben speichern und Kartenausgaben finanzieren.

In diesem Leitfaden lernen Sie:

  • Verifizierte verbundene Konten erstellen, die Ihre Geschäftskundinnen und -kunden mit relevanten Issuing- und Treasury-Funktionen darstellen
  • Finanzkonten erstellen, die Sie als Wallet für Ihre Geschäftskundinnen- und Kunden verwenden können und Gelder über ein externes Bankkonto hinzufügen
  • Virtuelle Karten für Ihre Geschäftskundinnen und -kunden erstellen und diese verwenden, um Gelder mit einer Wallet auszugeben

Bevor Sie loslegen

  1. Registrieren Sie sich für ein Stripe-Konto.
  2. Aktivieren Sie Issuing und Treasury im Test-Modus über das Dashboard. Weitere Informationen finden Sie unter API-Zugriff auf Issuing und Treasury.
  3. Konfigurieren Sie Ihre Branding-Einstellungen der Connect-Plattform für Ihr Unternehmen und fügen Sie ein Symbol hinzu.

Verbundene Konten erstellen

Verbundenes Konto erstellen

Erstellen Sie ein verbundenes Konto, um eine Geschäftskundin/einen Geschäftskunden auf Ihrer Plattform darzustellen. Wenn es sich bei Ihrem Produkt beispielsweise um eine SaaS-Plattform für Restaurants handelt, wird jedes Restaurant als ein verbundenes Konto dargestellt.

Connect-Kontoarten

Issuing unterstützt nur verbundene Konten, die kein von Stripe gehostetes Dashboard verwenden und bei denen Ihre Plattform für die Erfassung von Anforderungen und die Verlusthaftung verantwortlich ist, auch als verbundenes Custom-Konto bezeichnet. Erfahren Sie, wie Sie verbundene Konten erstellen, die mit Issuing kompatibel sind. Wenn Ihre bestehenden Konten nicht mit dieser Konfiguration übereinstimmen, müssen Sie sie neu erstellen.

Über die folgende Anfrage wird ein verbundenes Konto mit der korrekten Konfiguration in den USA erstellt, und die erforderlichen Funktionen werden angefordert:

Command Line
curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d country=US \
  -d "controller[stripe_dashboard][type]"=none \
  -d "controller[fees][payer]"=application \
  -d "controller[losses][payments]"=application \
  -d "controller[requirement_collection]"=application \
  -d "capabilities[transfers][requested]"=true \
  -d "capabilities[card_issuing][requested]"=true \
  -d "capabilities[treasury][requested]"=true \
  -d "capabilities[us_bank_account_ach_payments][requested]"=true

Die Kontoinformationen der Nutzerin/des Nutzers werden in der Antwort angezeigt:

{
    ...
    "id":   "{{CONNECTED_ACCOUNT_ID}}",
    "controller": {
      "stripe_dashboard": {
        "type": "none"
      },
      "fees": {
        "payer": "application"
      },
      "losses": {
        "payments": "application"
      },
      "is_controller": true,
      "type": "application",
      "requirement_collection": "application"
    },
    ...
}

Notieren Sie sich die id des verbundenen Kontos. Sie geben diesen Wert an, um sich als das verbundene Konto zu authentifizieren, indem Sie ihn in Anfragen im Stripe-Account-Header übergeben.

Wenn bereits ein verbundenes Konto vorhanden ist, können Sie die erforderlichen Funktionen hinzufügen, indem Sie die id des verbundenen Kontos in der API-Anfrage angeben:

Command Line
curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
 \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "controller[stripe_dashboard][type]"=none \
  -d "controller[fees][payer]"=application \
  -d "controller[losses][payments]"=application \
  -d "controller[requirement_collection]"=application \
  -d country=US \
  --data-urlencode email="jenny.rosen@example.com" \
  -d "capabilities[transfers][requested]"=true \
  -d "capabilities[treasury][requested]"=true \
  -d "capabilities[card_issuing][requested]"=true

Verbundenes Konto verifizieren

Wählen Sie eine der folgenden Onboarding-Optionen:

Das von Stripe gehostete Onboarding ist ein von Stripe gehostetes Webformular mit dem Namen, der Farbe und dem Symbol Ihrer Marke. Das von Stripe gehostete Onboarding nutzt die Accounts API, um die Anforderungen zu lesen und ein Onboarding-Formular mit robuster Datenvalidierung zu generieren, das für alle von Stripe unterstützten Länder lokalisiert ist.

Bevor Sie Connect Onboarding verwenden, müssen Sie den Namen, die Farbe und das Symbol Ihrer Marke im Abschnitt „Branding“ in den Connect-Einstellungen angeben.

Sie können gehostetes Onboarding verwenden, um verbundenen Konten zu gestatten, ein external_account (das für Auszahlungen erforderlich ist) zu verknüpfen, indem es über Ihre Onboarding-Einstellungen für Connect verknüpft wird.

Verwenden Sie die Account Links API, um einen Onboarding-Link für das verbundene Konto zu erstellen.

Command Line
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

Vorsicht

Senden Sie aus Sicherheitsgründen keine Konto-Link-URLs per E-Mail, Textnachricht oder direkt an Ihr verbundenes Konto. Wir empfehlen, die Konto-Link-URL über Ihre Plattform zu versenden, wo alle Konten authentifiziert sind.

Die Antwort, die Sie erhalten, enthält den Parameter url mit dem Link für Ihr verbundenes Konto zum Onboarding auf Ihre Plattform.

{
  "object": "account_link",
  "created": 1612927106,
  "expires_at": 1612927406,
  "url": "https://connect.stripe.com/setup/s/…"
}

Stripe hat inzwischen das verbundene Konto erstellt und verifiziert. Die relevanten Funktionen sind active und das Konto kann nun mit Issuing und Treasury verwendet werden.

Weitere Informationen finden Sie unter:

Finanzkonten erstellen und Gelder hinzufügen

Nachdem Sie Treasury auf Ihrer Plattform aktiviert haben, fügen Sie FinancialAccount-Objekte zu Ihrer Plattformarchitektur hinzu, um Gelder effizient speichern, senden und empfangen zu können. Stripe fügt Ihrem Plattformkonto ein Finanzkonto hinzu und ermöglicht Ihnen die Bereitstellung eines individuellen Finanzkontos für jedes berechtigte verbundene Konto auf Ihrer Plattform.

In der Stripe API dienen FinancialAccount-Objekte als Quelle und Ziel von API-Anfragen zum Bewegen von Geldern. Sie fordern Features über die API an, die FinancialAccounts zugewiesen werden und zusätzliche Funktionen für die Finanzkonten auf Ihrer Plattform bereitstellen.

Ein Finanzkonto weist ein Guthaben auf, das vom Saldo des verbundenen Kontos, mit dem es verknüpft ist, getrennt ist. Die Inhaberin/der Inhaber eines verbundenen Kontos auf Ihrer Plattform könnte beispielsweise über ein Guthaben in Höhe von 100 USD auf dem verbundenen Konto und 200 USD Guthaben auf dem Finanzkonto verfügen. In diesem Szenario verfügt die Inhaberin/der Inhaber des verbundenen Kontos über eine Summe von 300 USD, die zwischen dem Finanzkonto und den Salden des verbundenen Kontos verteilt sind. Diese beiden Guthaben bleiben getrennt, mit der API ist jedoch die Geldbewegung vom Saldo des verbundenen Kontos zum Saldo des Finanzkontos möglich.

Mehrere Finanzkonten

Mit der Beta-Funktion für mehrere Finanzkonten können Sie mehrere Finanzkonten für ein einzelnes verbundenes Konto eröffnen. Kontaktieren Sie treasury-support@stripe.com, um auf den Test-Modus für diese Funktion zuzugreifen und sich auf die Warteliste setzen zu lassen.

Finanzkonto erstellen

Sobald Stripe einem Konto die Funktion treasury hinzufügt und sich dieses im Status active befindet, können Sie ein FinancialAccount-Objekt für das Konto erstellen. Hierfür rufen Sie FinancialAccounts auf und fordern die Features an, die Sie bereitstellen möchten:

Command Line
curl https://api.stripe.com/v1/treasury/financial_accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "supported_currencies[]"=usd \
  -d "features[card_issuing][requested]"=true \
  -d "features[deposit_insurance][requested]"=true \
  -d "features[financial_addresses][aba][requested]"=true \
  -d "features[inbound_transfers][ach][requested]"=true \
  -d "features[intra_stripe_flows][requested]"=true \
  -d "features[outbound_payments][ach][requested]"=true \
  -d "features[outbound_payments][us_domestic_wire][requested]"=true \
  -d "features[outbound_transfers][ach][requested]"=true \
  -d "features[outbound_transfers][us_domestic_wire][requested]"=true

In der Antwort auf das Anfordern von Funktionen zur Finanzkontoerstellung wird auf ihren Status in den Parametern active_features, pending_features und restricted_features hingewiesen.

{
  "object": "treasury.financial_account",
  "created": 1612927106,
  "id": "fa_123",
  "country": "US",
  "supported_currencies": ["usd"],
  "active_features": ["card_issuing"],
  "pending_features": ["financial_addresses.aba"],
  "restricted_features": [],
  // No FinancialAddress added as the financial_addresses.aba feature is not yet active
  "financial_addresses": [],
  "livemode": true,
  "status": "open",
  ...
}

Für einige Funktionen erfolgt die Aktivierung möglicherweise umgehend (z. B. bei card_issuing). Andere Funktionen, wie financial_addresses.aba, werden hingegen asynchron aktiviert oder verbleiben für bis zu 30 Minuten im Status pending, während Stripe mit externen Systemen kommuniziert. Wenn alle relevanten Funktionen aktiv sind, erhalten Sie eine Bestätigung für den Webhook-Listener treasury.financial_account.features_status_updated. Weitere Informationen zu den Funktionen von Finanzkonten finden Sie unter Verfügbare Funktionen.

Bankkonto verknüpfen

Damit Ihre Kundinnen und Kunden Geld von einem externen Konto und auf ein externes Konto übertragen können, erstellen Sie einen SetupIntent mit den erforderlichen Parametern und fügen ihn zu self hinzu, um anzugeben, dass das externe Konto Ihrer Kundin/Ihrem Kunden gehört:

Command Line
curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d attach_to_self=true \
  -d "flow_directions[]"=inbound \
  -d "flow_directions[]"=outbound \
  -d "payment_method_types[]"=us_bank_account \
  -d "payment_method_data[type]"=us_bank_account \
  -d "payment_method_data[us_bank_account][routing_number]"=110000000 \
  -d "payment_method_data[us_bank_account][account_number]"=000123456789 \
  -d "payment_method_data[us_bank_account][account_holder_type]"=company \
  -d "payment_method_data[billing_details][name]"="Company Corp" \
  -d confirm=true \
  -d "mandate_data[customer_acceptance][type]"=online \
  -d "mandate_data[customer_acceptance][online][ip_address]"="123.123.123.123"

Die API-Antwort enthält eine eindeutige Kennung für die payment_method, die verwendet wird, um bei ACH-Übertragungen auf dieses Bankkonto zu verweisen:

{
  "id": "{{SETUP_INTENT_ID}}",
  "object": "setup_intent",
  "next_action": {
    "type": "verify_with_microdeposits",
    "verify_with_microdeposits": {
      "arrival_date": 1642579200,
      "hosted_verification_url": "https://payments.stripe.com/microdeposit/sacs_test_xxx",
      "microdeposit_type": "amounts"
    }
  },
  ...
  "payment_method": "{{PAYMENT_METHOD_ID}}",
  "payment_method_types": [
    "us_bank_account"
  ]
}

Bevor Sie ein Bankkonto verwenden können, müssen Sie dieses mittels Testeinzahlungen (hierauf gehen wir genauer ein) oder der schnelleren Option Financial Connections verifizieren. Die SetupIntent-Antwort aus dem vorherigen Schritt enthält eine hosted_verification_url. Geben Sie diese URL für Ihre Kundinnen/Kunden an, damit sie den zur Testeinzahlung gehörenden Zahlungsbeschreibungscode eingeben können. Verwenden Sie den Wert SM11AA, um das Bankkonto zu verifizieren. Alternativ können Sie auch zahlreiche andere Fälle testen und hierfür die von Stripe bereitgestellten Testkontonummern nutzen.

Verifizierung einer Testeinzahlung

Verifizierung einer Testeinzahlung

Gelder auf das Finanzkonto einzahlen

Wenn Sie die eingebettete Finanzkonto-Komponente in Ihrer Anwendung nutzen, können Ihre verbundenen Konten Gelder an das Finanzkonto senden.

Create an Account Session

Aktivieren Sie beim Erstellen einer Kontositzung die Finanzkonto-Komponente, indem Sie financial_account im Parameter components angeben. Sie können einzelne Funktionen der Finanzkontokomponente aktivieren oder deaktivieren, indem Sie den Parameter features unter financial_account angeben.

Command Line
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Version: 2024-11-20.acacia; embedded_connect_beta=v2;" \
  -d account=
{{CONNECTED_ACCOUNT_ID}}
 \
  -d "components[financial_account][enabled]"=true \
  -d "components[financial_account][features][send_money]"=true \
  -d "components[financial_account][features][transfer_balance]"=true \
  -d "components[financial_account][features][external_account_collection]"=true

Nachdem die Kontositzung erstellt und ConnectJS initialisiert wurde, können Sie die Finanzkonto-Komponente im Frontend darstellen:

financial-account.js
// Include this element in your HTML
const financialAccount = stripeConnectInstance.create('financial-account');
financialAccount.setFinancialAccount('{{FINANCIAL_ACCOUNT_ID')
container.appendChild(financialAccount);

Hier können Nutzer/innen auf Geldübertragung klicken und eine Übertragung initiieren.

Zu diesem Zeitpunkt verfügt das verbundene Konto über ein FinancialAccount, das mit Geldern aus einem InboundTransfer aufgestockt wurde. Dieses Guthaben können Sie per Kartenzahlung oder auch OutboundPayments wie ACH-Zahlungen oder Überweisungen ausgeben.

Weitere Informationen finden Sie unter:

Karteninhaber/innen und Karten erstellen

Bei der Karteninhaberin/dem Karteninhaber handelt es sich um die Einzelperson (d. h. der/die Mitarbeiter/in oder der/die Auftragnehmer/in), die von Ihrer Geschäftskundin/Ihrem Geschäftskunden autorisiert wurde, Karteneinzahlungen über den zugehörigen Saldo abzuwickeln. Das Cardholder-Objekt enthält relevante Details, wie z. B. einen Namen, der auf den Karten angezeigt werden soll und eine Rechnungsadresse. Bei letzterer handelt es sich in der Regel um die Geschäftsadresse des verbundenen Kontos oder Ihrer Plattform.

Verwenden Sie die eingebettete Komponente der Liste der Issuing-Karten, um es Ihren verbundenen Konten zu ermöglichen, eine Karte für eine/n Karteninhaber/in zu erstellen und sie mit dem Finanzkonto zu verknüpfen.

Aktivieren Sie beim Erstellen einer Kontositzung die Komponente Kartenliste in Issuing, indem Sie issuing_cards_list im Parameter components angeben. Sie können einzelne Funktionen der Komponente Kartenliste in Issuing aktivieren oder deaktivieren, indem Sie den Parameter features unter issuing_cards_list angeben.

Command Line
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Version: 2024-11-20.acacia; embedded_connect_beta=v2;" \
  -d account=
{{CONNECTED_ACCOUNT_ID}}
 \
  -d "components[issuing_cards_list][enabled]"=true \
  -d "components[issuing_cards_list][features][card_management]"=true \
  -d "components[issuing_cards_list][features][cardholder_management]"=true \
  -d "components[issuing_cards_list][features][card_spend_dispute_management]"=true \
  -d "components[issuing_cards_list][features][spend_control_management]"=true

Nachdem die Kontositzung erstellt und ConnectJS initiiert wurde, können Sie die Komponente „Kartenliste in Issuing“ im Frontend anzeigen:

issuing-cards-list.js
// Include this element in your HTML
const issuingCardsList = stripeConnectInstance.create('issuing-cards-list');
issuingCardsList.setShowSpendControls(true);
container.appendChild(issuingCardsList);

Jetzt können Nutzer/innen auf Karte erstellen klicken, um mit der Erstellung einer neuen Karteninhaberin/eines neuen Karteninhabers und einer neuen Karte zu beginnen. Die Karte kann auf Nutzerseite während der Erstellung oder im Anschluss daran aktiviert werden.

Zu diesem Zeitpunkt ist der Karteninhaberin/dem Karteninhaber und dem Finanzkonto eine aktive Karte zugeordnet. Auf der Issuing-Seite des verbundenen Kontos können Sie Informationen zu der Karte und der Karteninhaberin/dem Karteninhaber einsehen.

Weitere Informationen finden Sie unter:

Karte verwenden

Autorisierung erstellen

Generieren Sie eine Testautorisierung, um zu erfahren, wie sich die Kartenaktivität auf den zugehörigen Saldo auswirkt. Diese können Sie für das verbundene Konto auf der Issuing-Seite im Dashboard generieren oder indem Sie den folgenden Aufruf der Authorization API durchführen:

Command Line
curl https://api.stripe.com/v1/test_helpers/issuing/authorizations \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d card=
{{CARD_ID}}
 \
  -d amount=1000 \
  -d authorization_method=chip \
  -d "merchant_data[category]"=taxicabs_limousines \
  -d "merchant_data[city]"="San Francisco" \
  -d "merchant_data[country]"=US \
  -d "merchant_data[name]"="Rocket Rides" \
  -d "merchant_data[network_id]"=1234567890 \
  -d "merchant_data[postal_code]"=94107 \
  -d "merchant_data[state]"=CA

Nach der Genehmigung erstellt Stripe eine Authorization im Status pending, während auf die Erfassung gewartet wird. Notieren Sie die Autorisierungs-id, die Sie zur Erfassung der Gelder verwenden:

{
  "id": "iauth_1NvPyY2SSJdH5vn2xZQE8C7k",
  "object": "issuing.authorization",
  "amount": 1000,
  ...
  "status": "pending",
  "transactions": [],
}

Sie können die Saldodetails des Finanzkontos abrufen und die Auswirkungen der Autorisierung anzeigen:

Command Line
curl https://api.stripe.com/v1/treasury/financial_accounts/
{{FINANCIAL_ACCOUNT_ID}}
 \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"

Die API-Antwort ist ein FinancialAccount-Objekt mit einem balance-Hash, der die Gelder und ihre Verfügbarkeit im Detail beschreibt:

{
  "object": "treasury.financial_account",
  "id": "{{FINANCIAL_ACCOUNT_ID}}",
  ...
  "balance": {
    "cash": {"usd": 19000},
    "inbound_pending": {"usd": 0},
    "outbound_pending": {"usd": 1000}
  }
}

Die Antwort weist darauf hin, dass aktuell 190 USD verfügbar sind und weitere 10 USD in outbound_pending im Rahmen der Autorisierung im Status pending zurückgehalten werden. Sie können die Erfassung der Autorisierung mit der API simulieren.

Gelder erfassen

Erfassen Sie die Gelder mit dem folgenden Code:

Command Line
curl -X POST https://api.stripe.com/v1/test_helpers/issuing/authorizations/
{{AUTHORIZATION_ID}}
/capture \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

Nachdem die Autorisierung erfasst wurde, erstellt Stripe eine Transaktion in Issuing, der status der Autorisierung wird auf closed festgelegt, und es wird ein ReceivedDebit-Webhook mit diesen Details erstellt. Wenn Sie die Saldodetails des Finanzkontos erneut abrufen, wird angezeigt, dass der Parameter outbound_pending jetzt 0 USD beträgt, während das verfügbare Bargeld weiterhin 190 USD beträgt:

{
  "object": "treasury.financial_account",
  "id": "{{FINANCIAL_ACCOUNT_ID}}",
  ...
  "balance": {
    "cash": {"usd": 19000},
    "inbound_pending": {"usd": 0},
    "outbound_pending": {"usd": 0}
  }
}

Siehe auch

War diese Seite hilfreich?
JaNein
Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unseren Produkt-Changelog an.
Fragen? Sales-Team kontaktieren.
Unterstützt von Markdoc
Auf dieser Seite
Bevor Sie loslegen
Verbundene Konten erstellen
Verbundenes Konto erstellen
Verbundenes Konto verifizieren
Finanzkonten erstellen und Gelder hinzufügen
Finanzkonto erstellen
Bankkonto verknüpfen
Gelder auf das Finanzkonto einzahlen
Karteninhaber/innen und Karten erstellen
Karte verwenden
Autorisierung erstellen
Gelder erfassen
Siehe auch
Verwendete Produkte
Issuing
Treasury
Connect