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_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d destination_balance=issuing \
  -d amount=2000 \
  -d currency=usd \
  -d description="Top-up for Issuing, 21. Dezember 2024" \
  -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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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"
}

Sie müssen Karten aktivieren, bevor Nutzer/innen diese verwenden können. Virtuelle Karten können Sie in demselben API-Aufruf erstellen und aktiveren. Physische Karten müssen hingegen getrennt aktiviert werden. Wenn Sie die Karte freigeben möchten, aktivieren Sie diese, indem Sie den status auf active setzen:

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

Generieren Sie eine Testautorisierung, um zu erfahren, wie sich die Kartenaktivität auf den zugehörigen Saldo auswirkt. Diese können Sie für das verbundene Konto auf der Issuing-Seite im Dashboard generieren oder indem Sie den folgenden Aufruf der Authorization API durchführen:

curl https://api.stripe.com/v1/test_helpers/issuing/authorizations \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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_4eC39HqLyjWDarjtT1zdp7dc
:"

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