# 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)
If you’re interested in getting early access to consumer prepaid debit cards, [contact our sales team](https://stripe.com/contact/embedded-finance).

## Create and fund your v2 Financial Account

Use your v2 Financial Account to disburse funds to your consumer’s balance. A v2 Financial Account is separate from your payments balance. If you have access to consumer prepaid, we automatically create a v2 Financial Account for you.

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-Flow verwendet die Stripe Accounts v2 API. Verwenden Sie die korrekte API-Dokumentation, da einige Dokumente auf v1-Kontoobjekte für Abwärtskompatibilität verweisen.
> 
> Für bestehende V1-Konten stellen wir Prognosen zur Erstellung von Konfigurationen für Verbraucherkonten bereit.

### 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_last_4",
          "value": "1234"
        }
      ]
    },
 "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-Ausnahme 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.

### 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
```

## Finanzierung

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.
