# Verbundene Konten, Karteninhaber/innen und Karten

Erfahren Sie, wie Sie Karteninhaber/innen und Karten mit Stripe Connect erstellen und verwalten.

Verbundene Konten repräsentieren Geschäftseinheiten. Karteninhaber/innen repräsentieren Einzelpersonen, die mit diesen Geschäftseinheiten verbunden sind. Ein verbundenes Konto kann mehrere Karteninhaber/innen haben. Beispielsweise kann ein verbundenes Konto für ein kleines Unternehmen mehrere Karteninhaber/innen für den/die Inhaber/in und seine/ihre Mitarbeiter/innen haben. Nachdem Sie eine/n Karteninhaber/in erstellt haben, stellen Sie ihm/ihr eine virtuelle oder physische Karte aus.
Karteninhaber/innen und Karten für verbundenes Konto (See full diagram at https://docs.stripe.com/issuing/connect/cardholders-and-cards)
## Karteninhaber/innen erstellen

Um einen [Cardholder](https://docs.stripe.com/api/issuing/cardholders/object.md) zu erstellen, verwenden Sie die [Cardholders API](https://docs.stripe.com/api/issuing/cardholders/create.md) und geben die erforderlichen Informationen an. Für die Nutzung von [digitalen Wallets](https://docs.stripe.com/issuing/cards/digital-wallets.md) sind eine gültige Telefonnummer und E-Mail-Adresse erforderlich, für physische Karten ist dies jedoch optional.

> Als Connect-Plattform führen Sie API-Aufrufe im Namen Ihrer verbundenen Konten durch, indem Sie einen `Stripe-Account`-Header und die Konto-ID des verbundenen Kontos einfügen.

| Feld                   | Parameter      | Beschreibung                                                                                                                                                                                                                                                                          |
| ---------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Rechnungsinformationen | `billing`      | Rechnungsadresse des Karteninhabers/der Karteninhaberin (in der Regel die primäre Geschäftsadresse). Sie können kein Postfach, keine Autobahn-Vertragsbox (Highway Contract Box) und keine private Postfachadresse verwenden, aber Sie können sie als Kartenversandadresse verwenden. |
| Typ                    | `type`         | Ob der/die Karteninhaber/in ein `company` oder eine `individual` ist. Eine Anleitung finden Sie unter [Karteninhabertyp auswählen](https://docs.stripe.com/issuing/other/choose-cardholder.md).                                                                                       |
| Telefonnummer          | `phone_number` | Erforderlich bei Verwendung von digitalen Geldbörsen                                                                                                                                                                                                                                  |
| E-Mail-Adresse         | `email`        | E-Mail-Adresse des/der Karteninhaber/in. Erforderlich bei Verwendung von digitalen Geldbörsen                                                                                                                                                                                         |

```curl
curl https://api.stripe.com/v1/issuing/cardholders \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "name=Jenny Rosen" \
  --data-urlencode "email=jenny.rosen@example.com" \
  --data-urlencode "phone_number=+18008675309" \
  -d status=active \
  -d type=individual \
  -d "individual[first_name]=Jenny" \
  -d "individual[last_name]=Rosen" \
  -d "individual[dob][day]=1" \
  -d "individual[dob][month]=11" \
  -d "individual[dob][year]=1981" \
  -d "billing[address][line1]=510 Townsend Street" \
  -d "billing[address][city]=San Francsico" \
  -d "billing[address][state]=CA" \
  -d "billing[address][postal_code]=94111" \
  -d "billing[address][country]=US"
```

Stripe gibt ein Karteninhaber-Objekt zurück, das die von Ihnen angegebenen Informationen enthält und das [Webhook](https://docs.stripe.com/webhooks.md)-Ereignis `issuing_cardholder.created` sendet.

Nachdem Sie einen `Cardholder` (Karteninhaber) erstellt haben, rufen Sie den Endpoint [Karteninhaber-Update](https://docs.stripe.com/api/issuing/cardholders/update.md) mit den zu ändernden Parametern auf. Ein erfolgreicher Aufruf gibt ein aktualisiertes `Cardholder`-Objekt zurück.

Karteninhaber/innen haben standardmäßig den [status](https://docs.stripe.com/api/issuing/cardholders/update.md#update_issuing_cardholder-status) `active`, was bedeutet, dass eine Plattform entschieden hat, die Karte freizuschalten, sodass alle an die Karteninhaberin/den Karteninhaber angehängten Karten Autorisierungen genehmigen können.

Stripe muss die Identitätsangaben von Karteninhaberinnen/Karteninhabern gemäß gesetzlichen und regulatorischen Vorgaben prüfen. Dies kann Autorisierungen basierend auf den Eigenschaften der Karteninhaberin/des Karteninhabers blockieren, selbst wenn der Status der Karteninhaberin/des Karteninhabers `active` ist. Erfahren Sie mehr über [Watchlist-Prüfungen](https://support.stripe.com/questions/issuing-watchlist-reviews).

Sie können den `status` in `inactive` ändern, indem Sie die Karteninhaberin/den Karteninhaber aktualisieren. Ein inaktiver Status bei einer Karteninhaberin/einem Karteninhaber bedeutet, dass alle Autorisierungen für alle angehängten Karten mit dem Grund `cardholder_inactive` abgelehnt werden.

## Karten erstellen

Nachdem Sie einen `Cardholder` erstellt haben, stellen Sie ihm/ihr mit der [Cards API](https://docs.stripe.com/api/issuing/cards/create.md) eine Karte aus.

Ein [Karten](https://docs.stripe.com/api/issuing/cards/object.md)-Objekt stellt eine [physische Karte](https://docs.stripe.com/issuing/cards/physical.md) oder [virtuelle Karte](https://docs.stripe.com/issuing/cards/virtual.md) dar. Zum Erstellen einer physischen Karte ist eine Versandadresse erforderlich. Sie können [zusätzliche Argumente](https://docs.stripe.com/issuing/cards/physical.md) angeben, um die Versandverpackung und den Zustelldienst anzugeben.

| Karteninhaber/in | `cardholder` | Ausweisdokument des Karteninhabers/der Karteninhaberin                                                                                                                        |
| ---------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Währung          | `currency`   | ISO-Währungscode aus drei Buchstaben in Kleinbuchstaben. Unterstützte Währungen sind `usd` in den USA, `gbp` im Vereinigten Königreich und `eur` in den Ländern der Eurozone. |
| Typ              | `type`       | Kann `physical` oder `virtual` sein                                                                                                                                           |

Der folgende Aufruf ist ein Beispiel für die Ausstellung einer virtuellen Karte, die mit dem/der angegebenen Karteninhaber/in verknüpft ist:

```curl
curl https://api.stripe.com/v1/issuing/cards \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "cardholder={{ISSUINGCARDHOLDER_ID}}" \
  -d currency=usd \
  -d type=virtual
```

Stripe gibt bei der Erstellung ein `Card`-Objekt zurück und übermittelt das [Webhook](https://docs.stripe.com/webhooks.md)-Ereignis `issuing_card.created`.

## Karten aktivieren

Karten müssen aktiviert werden, bevor [Autorisierungen](https://docs.stripe.com/issuing/purchases/authorizations.md) genehmigt werden können.

Wenn Sie beim Erstellen der Karte keinen Status angeben, hat die Karte standardmäßig den Status `inactive`. Eine Karte bleibt so lange `inactive`, bis der Status mit dem Endpoint des [Kartenupdates](https://docs.stripe.com/api/issuing/cards/update.md) geändert wird.

So aktivieren Sie eine Karte:

```curl
curl https://api.stripe.com/v1/issuing/cards/{{CARD_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d status=active
```

## Karten deaktivieren

Sie können Karten deaktivieren, indem Sie den `status` mit dem Endpoint [Karten-Update](https://docs.stripe.com/api/issuing/cards/update.md) auf `inactive` setzen. Dies bedeutet, dass Sie keine *neuen* Autorisierungen für die Karte genehmigen können. Sie können aber weiterhin Autorisierungen genehmigen, die auf der Karte geöffnet wurden, bevor der Status auf `inactive` gesetzt wurde. Um neue Autorisierungen zu genehmigen, müssen Sie den Status der Karte auf `active` abändern.

```curl
curl https://api.stripe.com/v1/issuing/cards/{{CARD_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d status=inactive
```

Weitere Informationen zum [Verwalten von Autorisierungen](https://docs.stripe.com/issuing/purchases/authorizations.md).

## Karten kündigen

Sie können eine Karte stornieren, indem Sie den Status mit dem Endpoint [Karten-Update](https://docs.stripe.com/api/issuing/cards/update.md) auf `canceled` abändern. Der Status „Storniert“ ist final und kann nicht rückgängig gemacht werden. Sie können für eine Karte mit dem Status `canceled` keine neuen Autorisierungen genehmigen. Sie können weiterhin Autorisierungen genehmigen, die auf der Karte geöffnet wurden, bevor der Status auf `canceled` gesetzt wurde.

```curl
curl https://api.stripe.com/v1/issuing/cards/{{CARD_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d status=canceled
```

### Karteninhaber auflisten

Karteninhaber/innen, die einem verbundenen Konto zugeordnet sind, finden Sie, indem Sie eine GET-Anfrage über die [Cardholders API](https://docs.stripe.com/api/issuing/cards/list.md) stellen und den spezifischen `Stripe-Account`-Parameter in den Header übergeben.

```curl
curl https://api.stripe.com/v1/issuing/cardholders \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}"
```

Bei erfolgreicher Prüfung enthält die Antwort eine Liste der Karteninhaber/innen:

```json
{
  "object": "list",
  "data": [
    {
      "id": "{{CARDHOLDER_ID}}",
      "object": "issuing.cardholder",
      "billing": {
        "address": {
          "city": "San Francisco",
          "country": "US",
          "line1": "510 Townsend Street",
          "line2": null,
          "postal_code": "94111",
          "state": "CA"
        }
      },
      "company": null,
      "created": 1657144326,
      "email": "jenny.rosen@example.com",
      "individual": null,
      "livemode": false,
      "metadata": {},
      "name": "Jenny Rosen",
      "phone_number": "+18008675309",
      "requirements": {
        "disabled_reason": null,
        "past_due": []
      },
      "spending_controls": {
        "allowed_categories": [],
        "blocked_categories": [],
        "spending_limits": [],
        "spending_limits_currency": null
      },
      "status": "active",
      "type": "individual"
    },
    {
      "id": "{{CARDHOLDER_ID}}",
      "object": "issuing.cardholder",
      "billing": {
        "address": {
          "city": "San Francisco",
          "country": "US",
          "line1": "510 Townsend Street",
          "line2": null,
          "postal_code": "94111",
          "state": "CA"
        }
      },
      "company": null,
      "created": 1656537695,
      "email": "jenny.rosen@example.com",
      "individual": null,
      "livemode": false,
      "metadata": {},
      "name": "Jenny Rosen",
      "phone_number": "+18008675309",
      "requirements": {
        "disabled_reason": null,
        "past_due": []
      },
      "spending_controls": {
        "allowed_categories": [],
        "blocked_categories": [],
        "spending_limits": [],
        "spending_limits_currency": null
      },
      "status": "active",
      "type": "individual"
    }
  ],
  "has_more": false,
  "url": "/v1/issuing/cardholders"
}
```

## Preislisten

Sie können auch eine Liste der für ein verbundenes Konto erstellten Karten anzeigen, indem Sie eine GET-Anfrage über die [Cards API](https://docs.stripe.com/api/issuing/cards/list.md) durchführen und das spezifische `Stripe-Account` in den Header übergeben.

```curl
curl https://api.stripe.com/v1/issuing/cards \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}"
```

Bei erfolgreicher Durchführung erhalten Sie eine Liste der Karten:

```json
{
  "object": "list",
  "data": [
    {
      "id": "{{CARD_ID}}",
      "object": "issuing.card",
      "brand": "Visa",
      "cancellation_reason": null,
      "cardholder": {
        "id": "{{CARDHOLDER_ID}}",
        "object": "issuing.cardholder",
        "billing": {
          "address": {
            "city": "San Francisco",
            "country": "US",
            "line1": "510 Townsend Street",
            "line2": null,
            "postal_code": "94111",
            "state": "CA"
          }
        },
        "company": null,
        "created": 1656537695,
        "email": "jenny.rosen@example.com",
        "individual": null,
        "livemode": false,
        "metadata": {},
        "name": "Jenny Rosen",
        "phone_number": "+18008675309",
        "requirements": {
          "disabled_reason": null,
          "past_due": []
        },
        "spending_controls": {
          "allowed_categories": [],
          "blocked_categories": [],
          "spending_limits": [],
          "spending_limits_currency": null
        },
        "status": "active",
        "type": "individual"
      },
      "created": 1656537950,
      "currency": "usd",
      "exp_month": 5,
      "exp_year": 2025,
      "last4": "0021",
      "livemode": false,
      "metadata": {},
      "pin": null,
      "replaced_by": null,
      "replacement_for": null,
      "replacement_reason": null,
      "shipping": null,
      "spending_controls": {
        "allowed_categories": [
          "car_rental_agencies"
        ],
        "blocked_categories": null,
        "spending_limits": [
          {
            "amount": 8000,
            "categories": [],
            "interval": "per_authorization"
          }
        ],
        "spending_limits_currency": "usd"
      },
      "status": "active",
      "type": "virtual",
      "wallets": {
        "apple_pay": {
          "eligible": true,
          "ineligible_reason": null
        },
        "google_pay": {
          "eligible": true,
          "ineligible_reason": null
        },
        "primary_account_identifier": null
      }
    },
    {
      "id": "{{CARD_ID}}",
      "object": "issuing.card",
      "brand": "Visa",
      "cancellation_reason": null,
      "cardholder": {
        "id": "{{CARDHOLDER_ID}}",
        "object": "issuing.cardholder",
        "billing": {
          "address": {
            "city": "San Francisco",
            "country": "US",
            "line1": "510 Townsend Street",
            "line2": null,
            "postal_code": "94111",
            "state": "CA"
          }
        },
        "company": null,
        "created": 1656537695,
        "email": "jenny.rosen@example.com",
        "individual": null,
        "livemode": false,
        "metadata": {},
        "name": "Jenny Rosen",
        "phone_number": "+18008675309",
        "requirements": {
          "disabled_reason": null,
          "past_due": []
        },
        "spending_controls": {
          "allowed_categories": [],
          "blocked_categories": [],
          "spending_limits": [],
          "spending_limits_currency": null
        },
        "status": "active",
        "type": "individual"
      },
      "created": 1656537947,
      "currency": "usd",
      "exp_month": 5,
      "exp_year": 2025,
      "last4": "0013",
      "livemode": false,
      "metadata": {},
      "pin": null,
      "replaced_by": null,
      "replacement_for": null,
      "replacement_reason": null,
      "shipping": null,
      "spending_controls": {
        "allowed_categories": null,
        "blocked_categories": null,
        "spending_limits": [
          {
            "amount": 50000,
            "categories": [],
            "interval": "daily"
          }
        ],
        "spending_limits_currency": "usd"
      },
      "status": "active",
      "type": "virtual",
      "wallets": {
        "apple_pay": {
          "eligible": true,
          "ineligible_reason": null
        },
        "google_pay": {
          "eligible": true,
          "ineligible_reason": null
        },
        "primary_account_identifier": null
      }
    }
  ],
  "has_more": false,
  "url": "/v1/issuing/cards"
}
```

Sie können eine Liste der einem/einer bestimmten Karteninhaber/in zugeordneten Karten anzeigen, indem Sie den Parameter `cardholder` in Ihre [Cards API](https://docs.stripe.com/api/issuing/cards/list.md)-GET-Anfrage aufnehmen. Übergeben Sie das spezifische `Stripe-Account` in den Header und die Karteninhaber-ID in den Parameter `cardholder`.

```curl
curl -G https://api.stripe.com/v1/issuing/cards \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "cardholder={{ISSUINGCARDHOLDER_ID}}"
```