Integrationsleitfaden für B2B-Zahlungen

Um Gelder für Kartenausgaben verfügbar zu machen, fügen Sie in Ihrem Konto zu Ihrem Guthaben in Issuing Gelder hinzu. Dieses Guthaben stellt für Issuing zurückgestellte Gelder dar und wird sicher von Ihren Einnahmen, Auszahlungen und Geldern aus anderen Stripe-Produkten getrennt.

Sie können Gelder über Ihr Dashboard oder den Endpoint zum Erstellen von Aufstockungen hinzufügen.

curl https://api.stripe.com/v1/topups \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d destination_balance=issuing \
  -d amount=2000 \
  -d currency=usd \
  -d description="Top-up for Issuing, 31. März 2025" \
  -d statement_descriptor=Top-up

Karteninhaber/in erstellen

Der/die Karteninhaber/in stellt eine Einzelperson oder ein Unternehmen dar, die bzw. das berechtigt ist, die Kartenfinanzierung über das Issuing-Guthaben zu nutzen. Das Cardholder-Objekt enthält relevante Details wie einen Namen, der auf Karten angezeigt wird, und eine Rechnungsadresse, die in der Regel die Geschäftsadresse ist.

Mit dem folgenden API-Aufruf wird ein neuer Cardholder erstellt:

curl https://api.stripe.com/v1/issuing/cardholders \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d name="Company Card" \
  --data-urlencode email="company@example.com" \
  --data-urlencode phone_number="+18008675309" \
  -d status=active \
  -d type=company \
  -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.

Karte erstellen

Erstellen Sie eine Karte und ordnen Sie diese der/dem Cardholder zu, die autorisierte Nutzerin bzw. der autorisierter Nutzer der Karte werden soll.

In den folgenden Beispielen zeigen wir Ihnen, wie Sie eine virtuelle Karte erstellen. Im Live-Modus können Sie dann auch physische Karten erstellen und an die Karteninhaber/innen versenden.

curl https://api.stripe.com/v1/issuing/cards \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d type=virtual \
  -d cardholder=
{{CARDHOLDER_ID}}

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

{
  "id": "ic_1NvPjF2SSJdH5vn2OVbE7r0b",
  "object": "issuing.card",
  "brand": "Visa",
  ...
  "status": "inactive",
  "type": "virtual"
}

You need to activate the card before a user can use it. While you can activate virtual cards in the same API call you used to create it, you must activate physical cards separately. When ready, activate the card by marking the status as active:

curl https://api.stripe.com/v1/issuing/cards/ic_1NvPjF2SSJdH5vn2OVbE7r0b \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d status=active

Zu diesem Zeitpunkt ist der Karteninhaberin/dem Karteninhaber eine aktive Karte zugeordnet. Auf der Issuing-Seite können Sie Informationen zu der Karte und der Karteninhaberin/dem Karteninhaber einsehen.

{
  "id": "ic_1NvPjF2SSJdH5vn2OVbE7r0b",
  "object": "issuing.card",
  "brand": "Visa",
  ...
  "status": "active",
  "type": "virtual",
}

Weitere Informationen finden Sie unter:

• Virtual cards
• Physische Karten
• Use the Dashboard for Issuing with Connect
• Create cards with the API

Autorisierung erstellen

To observe the impact of card activity on the associated balance, generate a test authorization. You can do this in the Issuing page of the Dashboard, or with the following call to the Authorization API:

curl https://api.stripe.com/v1/test_helpers/issuing/authorizations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d card=
{{CARD_ID}} \
  -d amount=1000 \
  -d authorization_method=chip \
  -d "merchant_data[category]"=taxicabs_limousines \
  -d "merchant_data[city]"="San Francisco" \
  -d "merchant_data[country]"=US \
  -d "merchant_data[name]"="Rocket Rides" \
  -d "merchant_data[network_id]"=1234567890 \
  -d "merchant_data[postal_code]"=94107 \
  -d "merchant_data[state]"=CA

Nach der Genehmigung erstellt Stripe eine Authorization im Status pending, während auf die Erfassung gewartet wird. Notieren Sie die Autorisierungs-id, die Sie zur Erfassung der Gelder verwenden:

{
  "id": "iauth_1NvPyY2SSJdH5vn2xZQE8C7k",
  "object": "issuing.authorization",
  "amount": 1000,
  ...
  "status": "pending",
  "transactions": [],
}

Gelder erfassen

Erfassen Sie die Gelder mit dem folgenden Code:

curl -X POST https://api.stripe.com/v1/test_helpers/issuing/authorizations/
{{AUTHORIZATION_ID}}
/capture \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Nachdem die Autorisierung erfasst wurde, erstellt Stripe eine Transaktion in Issuing, deren status auf closed gesetzt wird.