Virtuelle Karten mit der API erstellen

Das Karteninhaber-Objekt stellt eine Einzelperson oder ein Unternehmen dar, der bzw. dem Sie Karten ausstellen können. Erstellen Sie eine/n Cardholder mit einem Namen, der auf den Karten angezeigt werden soll, und der Rechnungsadresse, die häufig abgefragt wird, wenn der/die Karteninhaber/in Online-Einkäufe tätigt. Bei dieser 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 eine email angeben, die für einige Funktionen wie Digital Wallets erforderlich sind. Sie können auch preferred_locales angeben, um die Sprache der Karteninhaberin/des Karteninhabers für Funktionen wie 3D Secure anzupassen.

curl https://api.stripe.com/v1/issuing/cardholders \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -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-Ereignis issuing_cardholder.created sendet.

Individuelle Anforderungen an Karteninhaber/innen

Der Typ des Karteninhabers/der Karteninhaberin ist standardmäßig auf individual eingestellt. Wahlweise können Sie den Typ aber auch auf company festlegen.

Sie müssen Werte für die Vornamen und Nachnamen der einzelnen Karteninhaber/innen angeben. Stripe überprüft diese in Übereinstimmung mit den gesetzlichen Richtlinien. Ziehen Sie auch die Angabe des Geburtsdatums in Erwägung, was die Prüfungen der Überwachungslisten senken könnte.

Nutzungsbedingungen für autorisierte Nutzer/innen akzeptieren

Wenn Sie Karten an Einzelpersonen für von der Celtic Bank unterstützte Programme ausstellen (nicht erforderlich für Karteninhaber/innen vom Typ company), müssen Sie die Zustimmung zu den Nutzungsbedingungen für autorisierte Nutzer/innen der Celtic Bank erfassen, bevor Sie eine Karte für diesen/diese Karteninhaber/in aktivieren. Weitere Informationen darüber, welche Vereinbarungen Sie Kontoinhabern und Kontoinhaberinnen bwz. Karteninhabern und Karteninhaberinnen vorlegen müssen, finden Sie unter Erforderliche Vereinbarungen für Issuing und Treasury.

Falls zutreffend, weist Stripe Sie in der Eigenschaft requirements des Objekts Cardholder auf diese Anforderung hin:

{
  "id": "ich_1MGlTC2eZvKYlo2CJnowP9Z5",
  "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 https://api.stripe.com/v1/issuing/cardholders/ich_1MGlTC2eZvKYlo2CJnowP9Z5 \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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.

Erstellen Sie eine Karte und weisen Sie sie dem/der Karteninhaber/in zu. Diese Anfrage enthält die ID des Cardholder-Objekts, die currency und virtual als type.

curl https://api.stripe.com/v1/issuing/cards \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d cardholder=ich_1MGlTC2eZvKYlo2CJnowP9Z5 \
  -d currency=usd \
  -d type=virtual

Stripe gibt bei der Erstellung ein Card-Objekt zurück und übermittelt das Webhook-Ereignis issuing_card.created.

Damit Autorisierungen für eine Karte genehmigt werden können, muss ihr status auf active gesetzt werden. Beachten Sie, dass überfällige Anforderungen die Kartenaktivierung blockieren.

Bei Erstellung aktivieren

Die Karte kann bei der Erstellung über das Dashboard oder die API aktiviert werden. Im Dashboard klicken Sie bei der Erstellung einer Karte auf Karte aktivieren. Über die API legen Sie den status auf active fest, wenn Sie den Endpoint zum Erstellen einer Karte verwenden.

Nach Erstellung aktivieren

Alternativ kann die Karte nach dem Erstellen einer inaktiven Karte auch über das Dashboard oder die API aktiviert werden. Wählen Sie zur Aktivierung über das Dashboard die zu aktivierende Karte aus und klicken Sie anschließend auf Karte aktivieren. Zur Aktivierung über die API verwenden Sie den Endpoint zum Aktualisieren von Karten, um den status auf active festzulegen.

curl https://api.stripe.com/v1/issuing/cards/ic_1Cm3paIyNTgGDVfzBqq1uqxR \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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 von Karten und setzen den status der Karte auf active.