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 hinzufügen.

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"
}

Sie müssen die Karte aktivieren, bevor ein/e Nutzer/in sie verwenden kann. Während Sie virtuelle Karten in demselben API-Aufruf aktivieren können, mit dem Sie sie erstellt haben, müssen Sie physische Karten separat aktivieren. Wenn Sie bereit sind, aktivieren Sie die Karte, indem Sie den status auf active festlegen:

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:

• Virtuelle Karten
• Physische Karten
• Verwenden Sie das Dashboard für Issuing mit Connect
• Karten mit der API erstellen

Autorisierung erstellen

Generieren Sie eine Testautorisierung, um zu erfahren, wie sich die Kartenaktivität auf den zugehörigen Saldo auswirkt. Sie können dies auf der Issuing-Seite des Dashboards oder durch den folgenden Aufruf der Authorization API durchführen:

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.