Weiter zum Inhalt
Konto erstellen oder anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellenAnmelden
Übersicht
Für Ihr Unternehmen nutzen
KartenSofortige Währungsumrechnung
In Ihre Plattform einbetten
Karten ausstellen

Integrationsleitfaden für Embedded Finance

Bauen Sie eine eingebettete Integration von Finanzdienstleistungen mit Issuing und Finanzkonten für Plattformen auf.

Bauen Sie ein eingebettetes Finanzdienstleistungsangebots in den USA auf – mit Stripe Issuing undFinanzkonten für Plattformen. Verwenden Sie Issuing, um Karten zu erstellen, und Finanzkonten für Plattformen, um Guthaben zu speichern und Kartenausgaben zu finanzieren.

In diesem Leitfaden lernen Sie:

  • Erstellen Sie verifizierte verbundene Konten, die Ihre Unternehmenskunden repräsentieren, mit relevanten Funktionen von Issuing und Finanzkonten für Plattformen.
  • 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 Finanzkonten für Plattformen in einer Sandbox-Umgebung aus dem Dashboard. Weitere Informationen finden Sie unterAPI Zugang zu Issuing und Finanzkonten für Plattformen.
  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

Ausstellen unterstützt nur verbundene Konten, die kein von Stripe gehostetes Dashboard verwenden und bei denen Ihre Plattform für die Erfassung der Anforderungen verantwortlich ist und die Verlusthaftung trägt. Diese Konten werden auch als verbundene Custom-Konten bezeichnet. Erfahren Sie, wie Sie verbundene Konten erstellen, die mit dieser Konfiguration funktionieren. Wenn Ihre bestehenden Konten nicht mit dieser ü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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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
No results
curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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/…"
}

Zu diesem Zeitpunkt hat Stripe das verbundene Konto erstellt und verifiziert, wobei die relevanten Funktionen zur Nutzung von Issuing und Finanzkonten für Plattformen auf active gesetzt sind.

Weitere Informationen finden Sie unter:

Finanzkonten erstellen und Gelder hinzufügen

Nachdem Sie Finanzkonten auf Ihrer Plattform aktiviert haben, fügen Sie Finanzkonto-Objekte Ihrer Plattformarchitektur hinzu, um das effiziente Speichern, Senden und Empfangen von Geldmitteln zu ermöglichen. Stripe fügt nach der Aktivierung Ihrer Plattform ein Finanzkonto hinzu und ermöglicht es Ihnen, ein individuelles Finanzkonto für jedes berechtigte verbundene Konto auf Ihrer Plattform bereitzustellen.

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 führt ein eigenständiges Guthabenkonto neben dem Saldo der Zahlungen des verbundenen Kontos, mit dem es verknüpft ist. Zum Beispiel könnte die/der Inhaber/in eines verbundenen Kontos auf Ihrer Plattform ein Guthaben von 100 USD auf einem verbundenen Konto und ein Guthaben von 200 USD auf einem Finanzkonto haben. In diesem Szenario besitzt die/der Inhaber/in des verbundenen Kontos eine Summe von 300 USD aus den Salden in ihrem/seinem Finanzkonto und verbundenen Konto. Diese beiden Salden bleiben getrennt, aber die API bietet die Möglichkeit, Geld vom Saldo des verbundenen Kontos auf den Saldo des Finanzkontos zu verschieben.

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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/treasury/financial_accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -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",
  ...
}

Die Aktivierung kann bei einigen Funktionen (z. B. card_issuing) sofort erfolgen. Andere Funktionen, wie z. B.financial_addresses.aba,asynchron aktivieren, könnten bis zu 30 Minuten lang ausstehend bleiben, während Stripe mit externen Systemen kommuniziert. Nachdem alle relevanten Funktionen aktiv sind, erhalten Sie eine Bestätigung auf dem Webhook-Listenertreasury.financial_account.features_status_updated. SieheVerfügbare Funktionen für weitere Informationen zu Finanzkonto-Funktionen.

Bankkonto verknüpfen

Damit Ihre Kundinnen/Kunden Geld von einem externen Konto und auf ein externes Konto übertragen können, erstellen Sie ein SetupIntent mit den erforderlichen Parametern und geben Sie an, dass Ihre Kundin/Ihre Kunde das externe Konto besitzt, indem Sie es an self anhängen:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -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" \
  --data-urlencode "mandate_data[customer_acceptance][online][user_agent]"="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.114 Safari/537.36"

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.

Kontositzung erstellen

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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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
JavaScript
React
No results
// 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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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
JavaScript
React
No results
// 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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/test_helpers/issuing/authorizations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/treasury/financial_accounts/
{{FINANCIAL_ACCOUNT_ID}}
 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -X POST https://api.stripe.com/v1/test_helpers/issuing/authorizations/
{{AUTHORIZATION_ID}}
/capture \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

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