# Prepaid-Debitkarten für Verbraucher/innen Lerne, wie man Prepaid-Debitkarten ausstellt. Geben Sie Prepaid-Debitkarten aus, damit Ihre Nutzer sofort Geld empfangen und ausgeben können. Bieten Sie Prämien an, zahlen Sie Einnahmen aus oder starten Sie ein Markenkartenprogramm. Mit Prepaid-Karten für Verbraucher können Sie Folgendes tun: - Erstellen Sie Verbraucherkonten und verknüpfen Sie Karten, während Sie KYC-Verpflichtungen und die Hauptbuchverwaltung an Stripe auslagern. - Bieten Sie virtuelle Karten mit Bereitstellung nach der Push-Methode für digitale Geldbörsen oder physische Karten an, deren Produktion und Versand von Stripe verwaltet werden. - Lagern Sie Streitigkeiten, Beschwerden und andere spezialisierte Kundensupport-Anfragen an Stripe aus. Für berechtigte Plattformen bietet Stripe eine Einnahmebeteiligung bei Prepaid-Debitkarten-Austausch an. ## Use Cases | Anwendungsszenario | Beschreibung | | ---------------------- | -------------------------------------------------------------------------------------------------------------- | | Prämienprogramm | Senden Sie Ihren Kunden Prepaid-Prämienkarten, die mit dem Logo Ihres Unternehmens individuell gestaltet sind. | | Auszahlungen | Senden Sie sofort Geld für Versicherungsansprüche, Rabatte oder Einnahmen. | | Karten mit Ihrer Marke | Führen Sie eine Wallet und Karte mit Ihrer Marke ein. | ## Jetzt starten Um Ihr Verbraucherausgabeprogramm aufzubauen, müssen Sie: - Erstellen und finanzieren Sie ein Finanzkonto für Ihre Plattform. - Erstellen Sie verbundene Konten und Karteninhaber, um Ihre Kunden zu vertreten. - Erstellen Sie Karten, die an das Finanzkonto der Karteninhaberin/des Karteninhabers gebunden sind. - Zahlen Sie auf das Finanzkonto der Karteninhaberin/des Karteninhabers vom Finanzkonto Ihrer Plattform ein. (See full diagram at https://docs.stripe.com/issuing/consumer-prepaid-debit-cards) Wenn Sie frühzeitigen Zugriff auf Prepaid-Debitkarten für Verbraucher/innen wünschen, [kontaktieren Sie unser Vertriebsteam](https://stripe.com/contact/embedded-finance). ## Erstellen und finanzieren Sie Ihr v2-Finanzkonto Nutzen Sie Ihr v2-Finanzkonto, um Gelder in den Saldo Ihres Verbrauchers auszuzahlen. Ein V2-Finanzkonto ist von Ihrem Zahlungssaldo getrennt. Wenn Sie Zugang zu Prepaid-Karten für Verbraucher/innen haben, erstellen wir automatisch ein V2-Finanzkonto für Sie. Um das v2-Finanzkonto zu finanzieren, folgen Sie den folgenden Schritten. ### Ihre Finanzkonto-ID abrufen Rufen Sie Ihr v2-Finanzkonto ab, um dessen ID für spätere API-Anfragen zu erhalten. ```curl curl https://api.stripe.com/v2/money_management/financial_accounts \ -H "Authorization: Bearer $STRIPE_SECRET_KEY" \ -H "Stripe-Version: 2026-02-25.preview" ``` ### Erstellen Sie eine v2-Finanzadresse Um Finanzierungsnachweise zu erstellen, erstellen Sie eine [v2-Finanzadresse](https://docs.stripe.com/api/v2/money-management/financial-addresses/create.md?api-version=2026-01-28.preview&lang=curl). ```curl curl -X POST https://api.stripe.com/v2/money_management/financial_addresses \ -H "Authorization: Bearer $STRIPE_SECRET_KEY" \ -H "Stripe-Version: 2026-01-28.preview" \ --json '{ "financial_account": "{{FINANCIAL_ACCOUNT_ID}}", "type": "us_bank_account" }' ``` ### Finanzierungsnachweise abrufen Diese Anfrage liefert eine Routing-Nummer und eine Kontonummer. Verwenden Sie die Routing- und Kontonummer, um die Finanzierung von Ihrem externen Bankkonto zu starten. ```curl curl -G https://api.stripe.com/v2/money_management/financial_addresses \ -H "Authorization: Bearer $STRIPE_SECRET_KEY" \ -H "Stripe-Version: 2026-01-28.preview" \ -d "include[0]"="credentials.us_bank_account.account_number" ``` ### Rufen Sie den Saldo Ihres Finanzkontos ab Je nachdem, mit welcher Quelle Sie Ihr Finanzkonto finanzieren, kann es einen Werktag dauern, bis das Geld verfügbar ist. Verwenden Sie die [API für Finanzkonten](https://docs.stripe.com/api/treasury/financial_accounts.md) um Ihren verfügbaren Saldo einzusehen. ```curl curl https://api.stripe.com/v2/money_management/financial_accounts/{{FINANCIAL_ACCOUNT_ID}} \ -H "Authorization: Bearer $STRIPE_SECRET_KEY" \ -H "Stripe-Version: 2026-01-28.preview" ``` Beispielantwort: ```json { "id": "fa_65NvTFNdpXXUx1kx1rB16NoTesLDSQ1IgNPigisRKq09iq", "object": "v2.money_management.financial_account", "balance": { "available": { "usd": { "value": 0, "currency": "usd" } }, "inbound_pending": { "usd": { "value": 0, "currency": "usd" } }, "outbound_pending": { "usd": { "value": 0, "currency": "usd" } } } } ``` ## Verbraucher-Onboarding Integrieren Sie die einzelnen Kundinnen und Kunden, indem Sie ein verbundenes Konto für sie/ihn erstellen. Erstellen Sie für jede Verbraucherin/jeden Verbraucher, die/der eine Prepaid-Debitkarte auf Ihrer Plattform möchte, ein Konto, das wir als verbundenes Konto bezeichnen. Die verbundenen Kontospeicher kennen Ihre Kundeninformationen (KYC) über den Verbraucher und aktivieren Funktionen im Konto. Fordern Sie die Funktionen `Lagerung`, `card_creator`, und `Empfänger/in` für ´die einzelnen Verbraucher/innen. > Der Onboarding-Ablauf verwendet die Stripe Accounts v2 API. Einige Dokumentationen verweisen auf v1-Objekte für die Abwärtskompatibilität, aber für bestehende v1-Konten stellt Stripe Projektionen bereit, um Konfigurationen für Verbraucherkonten zu erstellen. ### Erstellen Sie ein Konto Erstellen Sie ein `Konto`-Objekt für Ihre Verbraucherin/Ihren Verbraucher. Verwenden Sie die resultierende Konto-ID in zukünftigen API-Aufrufen. ```curl curl -X POST https://api.stripe.com/v2/core/accounts \ -H "Authorization: Bearer $STRIPE_SECRET_KEY" \ -H "Stripe-Version: 2026-03-25.preview" \ --json '{ "configuration": { "storer": { "capabilities": { "consumer": { "holds_currencies": { "usd": { "requested": true }, } }, "outbound_transfers": { "bank_accounts": { "requested": true } } }, }, "card_creator": { "capabilities": { "consumer": { "lead": { "prepaid_card": { "requested": true } } } } }, "recipient": { "capabilities": { "stripe_balance": { "stripe_transfers": { "requested": true } } } } }, "contact_email": "jenny.rosen@example.com", "dashboard": "none", "defaults": { "currency": "usd", "profile": { "business_url": "https://accessible.stripe.com" }, "responsibilities": { "fees_collector": "application", "losses_collector": "application" } }, "display_name": "Third J", "identity": { "country": "US", "entity_type": "individual", "individual": { "email": "jenny.rosen@example.com", "given_name": "Jenny", "surname": "Rosen", "date_of_birth": { "day": 1, "month": 1, "year": 1901 }, "phone": "+15555550100", "address": { "line1": "1234 Main Street", "city": "San Francisco", "state": "CA", "postal_code": "94111", "country": "US" }, "id_numbers": [ { "type": "us_ssn", "value": "000000000" } ] }, "include": [ "configuration.card_creator", "configuration.recipient" ] }' ``` ### Allgemeine Geschäftsbedingungen aufzeichnen Legen Sie der Verbraucherin/dem Verbraucher die Nutzungsbedingungen vor. Holen Sie ihre/seine Zustimmung ein und zeichnen Sie diese dann mit dem Parameter `Belege` in der v2 Accounts API auf. ```curl curl -X POST https://api.stripe.com/v2/core/accounts/{{CONNECTED_ACCOUNT_ID}} \ -H "Authorization: Bearer $STRIPE_SECRET_KEY" \ -H "Stripe-Version: 2026-03-25.preview" \ --json '{ "identity": { "country": "US", "entity_type": "individual", "individual": { "email": "jenny.rosen@example.com", "given_name": "Corgi", "surname": "Cannon", "date_of_birth": { "day": 1, "month": 1, "year": 1901 } }, "attestations": { "terms_of_service": { "account": { "date": "2026-02-20T00:00:00.000Z", "ip": "8.8.8.8", "user_agent": "Mozilla/5.0" }, "card_creator": { "consumer": { "account_holder": { "date": "2026-02-20T00:00:00.000Z", "ip": "8.8.8.8" }, "lead": { "prepaid_card": { "bank_terms": { "date": "2026-02-20T00:00:00.000Z", "ip": "8.8.8.8" }, "platform": { "date": "2026-02-20T00:00:00.000Z", "ip": "8.8.8.8" }, "financing_disclosures": { "date": "2026-02-20T00:00:00.000Z", "ip": "8.8.8.8" } } } } } } } } }' ``` ### Verknüpfen Sie das Konto mit der Issuing-Programm-ID Rufen Sie die Issuing Program ID ab, die das verbundene Konto verwendet. ```curl curl https://api.stripe.com/v1/issuing/programs \ -H "Authorization: Bearer $STRIPE_SECRET_KEY" \ -H "Stripe-Version: 2026-01-28.preview;issuing_program_beta=v2" ``` Verknüpfen Sie die Issuing-Programm-ID dem verbundenen Konto. ```curl curl https://api.stripe.com/v1/issuing/programs \ -H "Authorization: Bearer $STRIPE_SECRET_KEY" \ -H "Stripe-Version: 2026-01-28.preview; issuing_program_beta=v2" \ -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \ -d platform_program={{ISSUING_PROGRAM_ID}} \ -d is_default=true ``` ### Erstellen Sie ein v2-Finanzkonto für Verbraucher/innen Erstellen Sie ein v2-Finanzkonto für das verbundene Konto, um den Saldo für die Karte zu verwalten. Setzen Sie `funds_usage_type` auf `Verbraucher/in` und die verbundene Konto-ID in der Kopfzeile `Stripe-Context`. ```curl curl "$STRIPE_API_BASE/v2/money_management/financial_accounts" \ -u "$SK:" \ -H "Content-Type: application/json" \ -H "Stripe-Version: 2025-12-15.preview" \ -H "Stripe-Context: $CA_ID" \ --json '{ "type": "storage", "storage": { "holds_currencies": ["usd"], "funds_usage_type": "consumer" }, "display_name": "Consumer Wallet" }' ``` ### Konto schließen Schließen Sie das Konto, um den Zugriff auf das Konto und die zugehörigen Ressourcen zu entziehen. Übergeben Sie alle Konfigurationen für das Konto, damit diese Anfrage erfolgreich ist. ```curl curl -X POST https://api.stripe.com/v2/core/accounts/{{CONNECTED_ACCOUNT_ID}}/close \ -H "Authorization: Bearer $STRIPE_SECRET_KEY" \ -H "Stripe-Version: 2026-01-28.preview; issuing_program_beta=v2" \ --json '{ "applied_configurations": [ "card_creator", "recipient" ] }' ``` ### Onboarding-Ausnahmen verwalten Wenn eine Verbraucherin oder ein Verbraucher das Onboarding nicht abschließen kann, benachrichtigen wir Sie über Webhook-Events. Nutzen Sie diese Ereignisse, um Anforderungen zu klären und Ihr Kundensupport-Team zu informieren. - [Fehler-Enum](https://docs.stripe.com/connect/handling-api-verification.md?accounts-namespace=v2#requirement-errors) - [Probleme der Dokumentenverifizierung](https://docs.stripe.com/connect/handling-api-verification.md?accounts-namespace=v2#handle-document-verification-problems) - [Test-Ausnahmen](https://docs.stripe.com/connect/testing-verification.md?accounts-namespace=v2#initial-requirements) ## Kartenausstellung Nachdem Sie ein Konto erstellt und dem Kunden eine Prämie gewährt haben, stellen Sie eine Karte aus. Die KYC-Überprüfung erfolgt asynchron und kann einige Minuten dauern. Wenn Sie ein verbundenes Konto erstellen, führt Stripe im Hintergrund eine Know-Your-Customer-Prüfung (KYC) durch. Die erforderlichen Funktionen (z. B. `card_creator`) werden nicht sofort aktiviert. Der Aufruf der APIs zur Erstellung von Karteninhabern (`POST /v1/issuing/cardholders`) oder zur Kartenausstellung (`POST /v1/issuing/cards`), bevor die entsprechenden Funktionen für das verbundene Konto vollständig aktiviert sind, kann zu einem Fehler führen. Um festzustellen, ob eine Funktion aktiv ist, sollten Sie zunächst auf das Webhook-Ereignis `v2.core.account[configuration.card_creator].capability_status_updated` achten, bevor Sie fortfahren. > Wenn Sie den Vorgang wiederholen müssen, nachdem die Funktion aktiviert wurde, müssen Sie einen neuen Idempotenzschlüssel verwenden. Die Stripe v1-API speichert Fehlerantworten für den ursprünglichen Idempotenzschlüssel mindestens 24 Stunden lang im Cache. Ein erneuter Versuch mit demselben Schlüssel innerhalb dieses Zeitraums führt zur Rückgabe desselben zwischengespeicherten Fehlers, selbst wenn die Funktion inzwischen aktiviert wurde. Erfahren Sie mehr über die [erweiterte Fehlerbehandlung](https://docs.stripe.com/error-low-level.md#idempotency). ### Erstellen Sie eine Karteninhaberin/einen Karteninhaber Erstens: Erstellen Sie eine Karteninhaberin/einen Karteninhaber. Die Objekt `Karteninhaber` erlaubt es, mehrere Karteninhaber/innen einem einzigen Konto zuzuordnen (zum Beispiel primäre und sekundären Karteninhaber/innen). ```curl curl "https://api.stripe.com/v1/issuing/cardholders" \ -H "Authorization: Bearer $STRIPE_SECRET_KEY" \ -H "Stripe-Version: 2026-01-28.preview" \ -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \ -d "type=individual" \ -d "name=Jenny Rosen" \ --data-urlencode "email=jenny.rosen@example.com" \ -d "status=active" \ -d "billing[address][line1]=1234 Main Street" \ -d "billing[address][city]=San Francisco" \ -d "billing[address][state]=CA" \ -d "billing[address][country]=US" \ -d "billing[address][postal_code]=94111" \ -d "individual[first_name]=Jenny" \ -d "individual[last_name]=Rosen" \ -d "individual[dob][day]=1" \ -d "individual[dob][month]=1" \ -d "individual[dob][year]=2000" \ -d "spending_controls[spending_limits][0][amount]=100000" \ -d "spending_controls[spending_limits][0][interval]=daily" ``` ### Stellen Sie eine Karte aus Geben Sie die Karte aus und die Währung an. Hängen Sie das v2-Finanzkonto des Verbrauchers an die Karte an. ```curl curl "https://api.stripe.com/v1/issuing/cards" \ -H "Authorization: Bearer $STRIPE_SECRET_KEY" \ -H "Stripe-Version: 2026-01-28.preview" \ -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \ -d "cardholder={{CARDHOLDER_ID}}" \ -d "financial_account_v2={{CONSUMER_FINANCIAL_ACCOUNT_ID}}" \ -d "currency=usd" \ -d "type=virtual" ``` ### Karte aktivieren Karten sind standardmäßig inaktiv, wenn Stripe sie erstellt. Um die Karte zu aktivieren: ```curl curl "https://api.stripe.com/v1/issuing/cards/{{CARD_ID}}" \ -H "Authorization: Bearer $STRIPE_SECRET_KEY" \ -H "Stripe-Version: 2026-01-28.preview" \ -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \ -d status=active ``` ## Kartenfinanzierung Verwenden Sie [Ausgehende v2-Zahlungen](https://docs.stripe.com/api/v2/money-management/outbound-payments.md?api-version=2026-01-28.preview&lang=curl), um Gelder vom Finanzkonto der Plattform auf das verbundene Finanzkonto zu übertragen. Gelder auf dem verbundenen Finanzkonto stehen für Kartenaktivitäten zur Verfügung. Wenn das Bankkonto des verbundenen Kontos nicht genügend Mittel hat, werden die Genehmigungen abgelehnt. Sie können auf dieses Konto jederzeit einzahlen, auch bevor Sie die Karte erstellen. ```curl curl -X POST https://api.stripe.com/v2/money_management/outbound_payments \ -H "Authorization: Bearer $STRIPE_SECRET_KEY" \ -H "Stripe-Version: 2026-01-28.preview" \ --json '{ "amount": { "value": 100, "currency": "usd" }, "from": { "currency": "usd", "financial_account": "{{PLATFORM_FINANCIAL_ACCOUNT_ID}}" }, "to": { "currency": "usd", "payout_method": "{{CONSUMER_FINANCIAL_ACCOUNT_ID}}", "recipient": "{{CONNECTED_ACCOUNT_ID}}" } }' ``` ## Digital Wallets Stripe bietet Tokenisierungsdienste für große Wallet-Anbieter an und kann Ihnen helfen, manuelle Bereitstellung oder In-App-Bereitstellung nach der Push-Methode zu ermöglichen. Nutzen Sie die folgenden Anleitungen, um loszulegen: - [Manuelle Bereitstellung](https://docs.stripe.com/issuing/cards/digital-wallets.md?platform=react-native#manual-provisioning) - [In-App-Bereitstellung](https://docs.stripe.com/issuing/cards/digital-wallets.md?platform=react-native#push-provisioning) ## Stripe Elements Sie können mit [Streifen-Ausgabeelementen](https://docs.stripe.com/issuing/elements.md) Karteninformationen für eine virtuelle Karte anzeigen. Diese JavaScript- und iframe-basierte Implementierung ermöglicht es, sensible Karteninformationen in Ihrer bestehenden Benutzeroberfläche mit einem **Kopieren**-Button anzuzeigen. - Kartennummer, auch bekannt als PAN (nur [virtuelle Karten](https://docs.stripe.com/js/issuing_elements/create?type=issuingCardNumberDisplay) ) - CVC (nur virtuelle Karten) - Ablaufdatum - PIN ## Überprüfen Sie den Kontostand der Verbraucherin/des Verbrauchers Sie können den Kontostand der Verbraucherin/des Verbrauchers mit seiner Finanzkonto-ID überprüfen. ```curl curl $STRIPE_API_BASE/v2/money_management/financial_accounts/{{FINANCIAL_ACCOUNT_ID}} \ -u "$SK:" \ -H "Stripe-Context: $CA_ID" \ -H "Stripe-Version: 2025-12-15.preview" ``` Außerdem können Sie die Transaktionen des Verbrauchers auflisten: ```curl curl -G $STRIPE_API_BASE/v2/money_management/transactions \ -u "$SK:" \ -H "Stripe-Context: $CA_ID" \ -H "Stripe-Version: 2026-03-25.preview" \ -d "financial_account=$FA_ID" ``` ## Chargeback-Beweise einreichen Stripe bietet einen geführten Dashboard-Prozess und eine API, um Streitigkeiten einzureichen und bis zur Lösung zu überwachen. Lernen Sie, wie man [Verwenden Sie das Ausstellen, um Transaktionen anzufechten](https://docs.stripe.com/issuing/purchases/disputes.md). ## Erweiterte Händlerdaten Sie können die Transaktionshistorie Ihrer Nutzer verbessern, indem Sie [erweiterte Händlerdaten](https://docs.stripe.com/issuing/purchases/enriched-merchant-data.md) einbeziehen, wie menschlich lesbare Firmennamen und standardisierte Logos. Sie können auch erweiterte Händlerdaten nutzen, um Ausgabenkontrollen zu verbessern, indem Sie konsistente Gegenparteien-IDs über Kanäle und Filialen hinweg verwenden.