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 erstellen
Um einen Cardholder zu erstellen, verwenden Sie die Cardholders API und geben die erforderlichen Informationen an. Für die Nutzung von digitalen Wallets sind eine gültige Telefonnummer und E-Mail-Adresse erforderlich, für physische Karten ist dies jedoch optional.
Notiz
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. |
| Telefonnummer | phone_ | 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 |
Stripe gibt ein Karteninhaber-Objekt zurück, das die von Ihnen angegebenen Informationen enthält und das Webhook-Ereignis issuing_ sendet.
Stripe muss die Identitätsangaben von Karteninhaber/innen überprüfen, um behördlichen und gesetzlichen Vorschriften zu entsprechen. Dadurch können Autorisierungen basierend auf Karteninhaberattributen blockiert werden. Erfahren Sie mehr über Prüfungen anhand von Überwachungslisten.
Nachdem Sie einen Cardholder (Karteninhaber) erstellt haben, rufen Sie den Endpoint Karteninhaber-Update mit den zu ändernden Parametern auf. Ein erfolgreicher Aufruf gibt ein aktualisiertes Cardholder-Objekt zurück.
Karteninhaber/innen haben standardmäßig den Status active. Das bedeutet, dass alle Karten, die mit den Karteninhaber/innen verknüpft sind, Autorisierungen genehmigen können. Sie können den status auf inactive abändern, indem Sie den/die Karteninhaber/in aktualisieren. Ein inaktiver Status für eine/n Karteninhaber/in bedeutet, dass alle Autorisierungen für alle verknüpften Karten mit dem Grund cardholder_ abgelehnt werden.
Karten erstellen
Nachdem Sie einen Cardholder erstellt haben, stellen Sie ihm/ihr mit der Cards API eine Karte aus.
Ein Karten-Objekt stellt eine physische Karte oder virtuelle Karte dar. Zum Erstellen einer physischen Karte ist eine Versandadresse erforderlich. Sie können zusätzliche Argumente 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:
Stripe gibt bei der Erstellung ein Card-Objekt zurück und übermittelt das Webhook-Ereignis issuing_.
Karten aktivieren
Karten müssen aktiviert werden, bevor Autorisierungen 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 geändert wird.
So aktivieren Sie eine Karte:
Karten deaktivieren
Sie können Karten deaktivieren, indem Sie den status mit dem Endpoint Karten-Update 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.
Weitere Informationen zum Verwalten von Autorisierungen.
Karten kündigen
Sie können eine Karte stornieren, indem Sie den Status mit dem Endpoint Karten-Update 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.
Karteninhaber/innen auflisten
Karteninhaber/innen, die einem verbundenen Konto zugeordnet sind, finden Sie, indem Sie eine GET-Anfrage über die Cardholders API stellen und den spezifischen Stripe-Account-Parameter in den Header übergeben.
Bei erfolgreicher Prüfung enthält die Antwort eine Liste der Karteninhaber/innen:
{ "object": "list", "data": [ { "id": "ich_1234a", "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": "ich_1234b", "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" }
Karten auflisten
Sie können auch eine Liste der für ein verbundenes Konto erstellten Karten anzeigen, indem Sie eine GET-Anfrage über die Cards API durchführen und das spezifische Stripe-Account in den Header übergeben.
Bei erfolgreicher Durchführung erhalten Sie eine Liste der Karten:
{ "object": "list", "data": [ { "id": "ic_1234a", "object": "issuing.card", "brand": "Visa", "cancellation_reason": null, "cardholder": { "id": "ich_1234a", "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": "ic_1234b", "object": "issuing.card", "brand": "Visa", "cancellation_reason": null, "cardholder": { "id": "ich_1234a", "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-GET-Anfrage aufnehmen. Übergeben Sie das spezifische Stripe-Account in den Header und die Karteninhaber-ID in den Parameter cardholder.