Karten mit der API erstellen
Sie können virtuelle und physische Karten für Mastercard oder Visa (oder beide) mit der Cards API erstellen. Karteninhaber/innen können virtuelle Karten sofort nach der Erstellung verwenden. Physische Karten sendet Stripe Ihnen per Post.
Außerdem können Sie virtuelle und physische Karten über das Dashboard erstellen.
Karteninhaber/in 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 digitale Wallets erforderlich sind. Sie können auch preferred_locales
angeben, um die Sprache des Karteninhabers/der Karteninhaberin für Funktionen wie 3D Secure anzupassen.
Stripe gibt ein Cardholder
-Objekt zurück, das die von Ihnen angegebenen Informationen enthält, und übermittelt das Webhook-Ereignis issuing_cardholder.created
.
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 gegenüber 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.
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, die currency
und den type
(entweder virtual
oder physical
) der Karte.
Zum Erstellen einer physischen Karte ist eine Lieferadresse erforderlich, und Sie können zusätzliche Argumente hinzufügen, um die Verpackung und den Zustellungsdienst anzugeben.
Stripe gibt bei der Erstellung ein Card
-Objekt zurück und übermittelt das Webhook-Ereignis issuing_card.created
.
Karte aktivieren
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.
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
.