Virtuelle Karten erstellen

Das Cardholder-Objekt stellt eine Einzelperson oder ein Unternehmen dar, an das Sie Karten ausstellen können. Erstellen Sie eine/n Cardholder mit einem Namen, der auf den Karten und der Rechnungsadresse 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 erforderlich sind. Sie können auch preferred_locales angeben, um die Sprache des Karteninhabers/der Karteninhaberin für Funktionen wie 3D Secure anzupassen.

curl https://api.stripe.com/v1/issuing/cardholders \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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, müssen Sie die Zustimmung zu den Nutzungsbedingungen für autorisierte Nutzer/innen der Celtic Bank erfassen, bevor Sie eine Karte für diese/n Karteninhaber/in aktivieren. Weitere Informationen darüber, welche Vereinbarungen Sie gegenüber Kontoinhabern/-inhaberinnen und Karteninhabern/-inhaberinnen 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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 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.

curl https://api.stripe.com/v1/issuing/cards \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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.