# Virtuelle Karten erstellen Erstellen Sie eine/n Karteninhaber/in und stellen Sie eine virtuelle Karte aus. Sie können das Dashboard oder den [Endpoint](https://dashboard.stripe.com/issuing/cards) [Karte erstellen](https://docs.stripe.com/api/issuing/cards.md) verwenden, um virtuelle Karten an Karteninhaber/innen auszustellen. Karteninhaber/innen können virtuelle Karten sofort nach der Erstellung verwenden. ## Karteninhaber/in erstellen Sie können das [Dashboard](https://dashboard.stripe.com/issuing/cardholders) oder die [Cardholders API](https://docs.stripe.com/api/issuing/cardholders.md) verwenden, um eine/n Karteninhaber/in zu erstellen. > Bei Stablecoin-gestützten Verbraucherkartenprogrammen kümmert sich Bridge um die Erstellung und Identitätsprüfung von Karteninhaberinnen und -inhabern. Weitere Informationen finden Sie in der [Bridge-Dokumentation](https://apidocs.bridge.xyz/platform/cards/overview/kyc). # Dashboard > This is a Dashboard for when testing-method is without-code. View the full page at https://docs.stripe.com/issuing/cards/virtual/issue-cards?testing-method=without-code. 1. Rufen Sie die Registerkarte [Karteninhaber/innen](https://dashboard.stripe.com/issuing/cardholders) im Issuing-Dashboard auf. ![Seite für Karteninhaber/innen in Issuing](https://b.stripecdn.com/docs-statics-srv/assets/cardholders-page.636c014a4cc28707df5118006f76eb6c.png) 1. Klicken Sie oben rechts auf **Karteninhaber/in erstellen**. 1. Karteninhabertyp auswählen: Einzelperson oder Unternehmen. Alle gültigen Zeichen für den Namen der Karteninhaberin/des Karteninhabers und des Unternehmensnamens sind alphanumerische Zeichen und `/ -&:().'`. Es gibt ein Limit von 24 Zeichen. ![Felder für Typ und Name im Formular für Karteninhaber/innen in Issuing](https://b.stripecdn.com/docs-statics-srv/assets/cardholder-form-type-name.580d1c848e5cd8c4cf4af9d50fac3d27.png) 1. Rechnungsadresse hinzufügen. ![Adressfelder im Formular für Karteninhaber/innen in Issuing](https://b.stripecdn.com/docs-statics-srv/assets/cardholder-form-billing-address.889782c18b84111b57f0fd8152ebb4ad.png) 1. Wenn Sie eine Firmenkarte erstellen, fügen Sie die Steueridentifikationsnummer hinzu. 1. Fügen Sie Kontaktinformationen hinzu, die für bestimmte Funktionen wie digitale Wallets erforderlich sind. ![Felder für Kontaktinformationen im Formular für Karteninhaber/innen in Issuing](https://b.stripecdn.com/docs-statics-srv/assets/cardholder-form-contact-information.389c419fa3ab62f8df53ed06084b20ff.png) 1. Klicken Sie auf **Karteninhaber/in erstellen**. ### Individuelle Anforderungen an Karteninhaber/innen Wenn Sie den individuellen Karteninhabertyp auswählen, müssen Sie den rechtsgültigen Vor- und Nachnamen sowie das [Geburtsdatum](https://docs.stripe.com/api/issuing/cardholders/create.md#create_issuing_cardholder-individual-dob) der Karteninhaberin/des Karteninhabers hinzufügen. Sie sollten einen [behördlich ausgestellten Ausweis](https://docs.stripe.com/api/issuing/cardholders/create.md#create_issuing_cardholder-individual-verification) hochladen, um die [Prüfungen anhand von Überwachungslisten](https://support.stripe.com/questions/issuing-watchlist-reviews) zu reduzieren. ![Felder zur Identitätsprüfung im Formular für Karteninhaber/innen in Issuing](https://b.stripecdn.com/docs-statics-srv/assets/cardholder-form-identity-fields.ac65dc239b5c14e3eb85e550d23b8f34.png) Wenn Sie Karten an Einzelpersonen für Programme ausgeben, die von der Cross River Bank oder der Fifth Third Bank unterstützt werden, müssen Sie die Zustimmung zu den geltenden Konditionen für autorisierte Nutzer/innen erfassen, bevor Sie eine Karte für diese Karteninhaberin/diesen Karteninhaber [aktivieren](https://docs.stripe.com/issuing/cards/physical/issue-cards.md?testing-method=without-code#activate-the-card). - [Konditionen für autorisierte Nutzer/innen der Cross River Bank](https://stripe.com/legal/issuing/crb-authorized-user-terms) - [Konditionen für autorisierte Nutzer/innen der Fifth Third Bank](https://stripe.com/legal/issuing/fifth-third-authorized-user-terms). Weitere Informationen darüber, welche Vereinbarungen Sie den Inhaber/innen von Konten und Karten vorlegen müssen, finden Sie unter [Erforderliche Vereinbarungen für Issuing und Treasury for platforms](https://docs.stripe.com/issuing/compliance-us.md). ### Anforderungen an Karteninhaber/innen des Typs „Unternehmen“ Wenn Sie einen Firmennamen hinzufügen, achten Sie darauf, dass er mindestens zwei Wörter enthält, zum Beispiel: Stripe Inc. ## Karte erstellen Sie können das [Dashboard](https://dashboard.stripe.com/issuing/cards) verwenden, um eine neue Karte zu erstellen. 1. Rufen Sie die Registerkarte [Karten](https://dashboard.stripe.com/issuing/cards) im Issuing-Dashboard auf. ![Seite „Karten ausstellen“](https://b.stripecdn.com/docs-statics-srv/assets/cards-page.e8e9728de4c5cbf6bf3b557dc634ed56.png) 1. Klicken Sie oben rechts auf **Karte erstellen**. 1. Suchen Sie unter [Karteninhaber/in erstellen](https://docs.stripe.com/issuing/cards/virtual/issue-cards.md#create-cardholder) nach dem/der Karteninhaber/in, den/die Sie erstellt haben. 1. Wählen Sie **Virtual** als Typ aus. 1. Wählen Sie **Karte aktivieren** aus. ![Virtuelle Kartenschublade erstellen](https://b.stripecdn.com/docs-statics-srv/assets/create-virtual-card.c049ecd7b3aa31853fb43d870c9680ad.png) 1. Klicken Sie auf **Erstellen**. # API > This is a API for when testing-method is with-code. View the full page at https://docs.stripe.com/issuing/cards/virtual/issue-cards?testing-method=with-code. Das [Cardholder-Objekt](https://docs.stripe.com/api/.md#issuing_cardholder_object) stellt eine Einzelperson oder ein Unternehmen dar, an das Sie Karten ausstellen können. Erstellen Sie eine/n `Cardholder` mit einem [Namen](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-name), der auf den Karten und der [Rechnungsadresse](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-billing) angezeigt werden soll. Die Rechnungsadresse wird häufig abgefragt, wenn der/die Karteninhaber/in Online-Einkäufe tätigt. Dabei handelt es sich in der Regel um die Geschäftsadresse des verbundenen Kontos oder Ihrer Plattform. Wenn Sie eine/n Karteninhaber/in erstellen oder später aktualisieren, können Sie zusätzliche Informationen wie eine `phone_number` oder `email` angeben, die für einige Funktionen wie [Digital Wallets](https://docs.stripe.com/issuing/cards/digital-wallets.md) erforderlich sind. Sie können auch [preferred_locales](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-preferred_locales) angeben, um die Sprache des Karteninhabers/der Karteninhaberin für Funktionen wie [3D Secure](https://docs.stripe.com/issuing/3d-secure.md) anzupassen. #### Curl ```bash curl https://api.stripe.com/v1/issuing/cardholders \ -u <>: \ -d "name"="Jenny Rosen" \ -d "email"="jenny.rosen@example.com" \ -d "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]"="123 Main Street" \ -d "billing[address][city]"="San Francisco" \ -d "billing[address][state]"="CA" \ -d "billing[address][postal_code]"="94111" \ -d "billing[address][country]"="US" ``` Stripe gibt ein `Cardholder`-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. ### Individuelle Anforderungen an Karteninhaber/innen Der [Typ](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-type) des Karteninhabers/der Karteninhaberin ist standardmäßig auf `individual` eingestellt. Wahlweise können Sie den Typ aber auch auf `company` [festlegen](https://docs.stripe.com/issuing/other/choose-cardholder.md). Sie müssen Werte für die Vornamen und [Nachnamen](https://docs.stripe.com/api/issuing/cardholders/create.md#create_issuing_cardholder-individual-last_name) der einzelnen Karteninhaber/innen angeben. Stripe überprüft diese in Übereinstimmung mit den gesetzlichen Richtlinien. Ziehen Sie auch die Angabe des [Geburtsdatums](https://docs.stripe.com/api/issuing/cardholders/create.md#create_issuing_cardholder-individual-dob) in Erwägung, was die [Prüfungen der Überwachungslisten](https://support.stripe.com/questions/issuing-watchlist-reviews) senken könnte. ### Nutzungsbedingungen für autorisierte Nutzer/innen akzeptieren Wenn Sie Karten an Einzelpersonen für Programme ausstellen, die von der Celtic Bank unterstützt werden, müssen Sie die Annahme der Bedingungen für [autorisierte Nutzer/innen der Celtic Bank](https://stripe.com/legal/issuing/celtic-authorized-user-terms) vor der [Aktivierung](https://docs.stripe.com/issuing/cards/virtual/issue-cards.md#activate-the-card) einer Karte für diese/n Karteninhaber/in aufzeichnen. Siehe die[Erforderlichen Vereinbarungen für Issuing und Finanzkonten für Plattformen](https://docs.stripe.com/issuing/compliance-us.md#issuing-terms) für weitere Informationen darüber, welche Vereinbarungen Sie Kontoinhabern und Karteninhabern vorlegen müssen. Falls zutreffend, weist Stripe Sie in der Eigenschaft `requirements` des Objekts `Cardholder` auf diese Anforderung hin: ```json { "id": "{{CARDHOLDER_ID}}", "name": "Jenny Rosen", ... "requirements": { "disabled_reason": "requirements.past_due", "past_due": [ "individual.card_issuing.user_terms_acceptance.date", "individual.card_issuing.user_terms_acceptance.ip" ] } ... } ``` Sie können die Bedingungen im Namen des/der `Cardholder` akzeptieren, indem Sie den Unix-Zeitstempel des Zeitpunkts, an dem der/die Karteninhaber/in seine/ihre Bedingungen akzeptiert hat, sowie die IP-Adresse übergeben. ```curl curl https://api.stripe.com/v1/issuing/cardholders/{{ISSUINGCARDHOLDER_ID}} \ -u "<>:" \ -d "individual[card_issuing][user_terms_acceptance][date]=1470266163" \ -d "individual[card_issuing][user_terms_acceptance][ip]=91.121.146.224" ``` Wenn Sie die Voraussetzungen für die Kartenaktivierung erfüllt haben (z. B. Vor- und Nachname sowie Nachweis der Zustimmung zu den Nutzungsbedingungen), können Sie die Karten für sie aktivieren. ## Karte erstellen Erstellen Sie eine [Karte](https://docs.stripe.com/api.md#issuing_card_object) und weisen Sie sie dem/der Karteninhaber/in zu. Diese Anfrage enthält die ID des `Cardholder`-Objekts, `currency` und `virtual` für den Kartentyp. #### Nur Issuing ```curl curl https://api.stripe.com/v1/issuing/cards \ -u "<>:" \ -d "cardholder={{ISSUINGCARDHOLDER_ID}}" \ -d currency=usd \ -d type=virtual ``` #### Issuing mit Treasury for platforms Um eine Karte zu erstellen, die Geldmittel von einem[Finanzkonto](https://docs.stripe.com/api/treasury/financial_accounts.md) abhebt, übergeben Sie in der Anfrage `financial_account`. ```curl curl https://api.stripe.com/v1/issuing/cards \ -u "<>:" \ -d "cardholder={{ISSUINGCARDHOLDER_ID}}" \ -d financial_account=fa_1KsZDkACgxNDEoMCVZko5z5F \ -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`. ### Ablaufdatum Das Ablaufdatum virtueller Karten liegt standardmäßig 3 Jahre in der Zukunft, aus Sicherheitsgründen bis zu 3 Monate randomisiert. Das Ablaufdatum kann zwischen 2 Jahren und 9 Monaten und 3 Jahren und 3 Monaten nach der Ausstellung liegen. > Wenn Sie eine [Ersatzkarte](https://docs.stripe.com/issuing/cards/replacements.md) ausstellen, legen wir ein anderes Ablaufdatum fest, damit es nicht zwei identische Karten gibt. #### Legen Sie ein individuelles Ablaufdatum fest Legen Sie beim Erstellen der Karte ein Ablaufjahr ([exp_year](https://docs.stripe.com/api/issuing/cards/create.md#create_issuing_card-exp_year)) und einen Ablaufmonat ([exp_month](https://docs.stripe.com/api/issuing/cards/create.md#create_issuing_card-exp_month)) fest, fest, um das Ablaufdatum der Karte zu kontrollieren. Das Ablaufdatum muss mindestens einen Monat und weniger als 5 Jahre in der Zukunft liegen. Im April 2024 wären zum Beispiel Mai 2024 bis einschließlich März 2029 als Ablaufdatum möglich. > Wenn Sie eine [Ersatzkarte](https://docs.stripe.com/issuing/cards/replacements.md) ausstellen, müssen Sie das gewünschte Ablaufdatum erneut angeben, da die neue Karte sonst möglicherweise auf das Standard-Ablaufdatum zurückgesetzt wird. ## Karte aktivieren Damit [Autorisierungen](https://docs.stripe.com/issuing/purchases/authorizations.md) für eine Karte genehmigt werden können, muss ihr `status` auf `active` gesetzt werden. Überfällige [Anforderungen](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-requirements-past_due) blockieren die Kartenaktivierung. ### Bei Erstellung aktivieren Sie können die Karte bei der Erstellung über das Dashboard oder die API aktivieren. Klicken Sie im Dashboard beim Erstellen einer Karte auf **Karte aktivieren**. Setzen Sie mit der API den `status` auf `active`, wenn Sie den Endpoint zum [Erstellen einer Karte](https://docs.stripe.com/api/.md#create_issuing_card) verwenden. ### Nach Erstellung aktivieren Alternativ können Sie eine inaktive Karte nach dem Erstellen über das Dashboard oder die API aktivieren. Wählen Sie zur Aktivierung über das Dashboard die zu aktivierende Karte aus und klicken Sie anschließend auf **Karte aktivieren**. Zur Aktivierung mit der API verwenden Sie den Endpoint zum [Aktualisieren einer Karte](https://docs.stripe.com/api.md#update_issuing_card), um den `status` auf `active` festzulegen. ```curl curl https://api.stripe.com/v1/issuing/cards/{{ISSUINGCARD_ID}} \ -u "<>:" \ -d status=active ``` ### Nach Sperrung erneut aktivieren In einigen Fällen wird eine Karte durch mehrere falsche PIN-Versuche bei einer Transaktion deaktiviert, wodurch weitere Autorisierungen verhindert werden. Um die Karte zu reaktivieren, verwenden Sie das Dashboard oder die API zum [Aktualisieren der Karte](https://docs.stripe.com/api.md#update_issuing_card), um den `status` der Karte auf `active` zu setzen.