Mit Stripe Issuing-Karten arbeiten

Fordern Sie die Kontofunktion card_issuing für die verbundenen Konten auf Ihrer Plattform an und geben Sie die erforderlichen Informationen für das Onboarding an.

curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "capabilities[treasury][requested]"=true \
  -d "capabilities[card_issuing][requested]"=true \
  -d "capabilities[transfers][requested]"=true

Bei Erfolg gibt die Antwort das Account-Objekt des verbundenen Kontos mit dem capabilities-Hash zurück, der die angeforderten Funktionen als active auflistet.

Sofern noch nicht geschehen, fordern Sie auch den Zugriff auf die Funktion card_issuing für das Finanzkonto an.

curl https://api.stripe.com/v1/treasury/financial_accounts/
{{FINANCIAL_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "treasury[access][requested]"=true \
  -d "card_issuing[access][requested]"=true

Bei Erfolg gibt die Antwort das Finanzkonto-Objekt mit den Funktionen zurück, die im active_features- oder pending_features-Array aufgeführt sind.

Nachdem die Funktion card_issuing aktiviert wurde, können die Verkäufer/innen und Dienstleister/innen, die Inhaber/innen der verbundenen Konten Ihrer Plattform sind, Karteninhaber/innen und Karten erstellen. Sie können Karten nur über die API ausgeben.

Ein Karteninhaber-Objekt stellt eine Einzelperson oder eine Geschäftseinheit dar, an die Sie Karten ausstellen können. Erstellen Sie zunächst eine/n Cardholder mit dem Namen, den Abrechnungsinformationen und der Angabe, ob es sich um eine individual oder eine company handelt.

curl https://api.stripe.com/v1/issuing/cardholders \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d name="Jenny Rosen" \
  --data-urlencode email="jenny.rosen@example.com" \
  --data-urlencode phone_number="+18008675309" \
  -d status=active \
  -d type=individual \
  -d "individual[first_name]"=Jenny \
  -d "individual[last_name]"=Rosen \
  -d "individual[dob][day]"=1 \
  -d "individual[dob][month]"=11 \
  -d "individual[dob][year]"=1981 \
  -d "billing[address][line1]"="1234 Main Street" \
  -d "billing[address][city]"="San Francisco" \
  -d "billing[address][state]"=CA \
  -d "billing[address][postal_code]"=94111 \
  -d "billing[address][country]"=US

Bei Erfolg gibt die Antwort die neu erstellte Cardholder-Objekt zurück.

Erstellen Sie eine Karte und weisen Sie sie sowohl dem soeben erstellten Cardholder als auch einem Finanzkonto zu. Um den/die Karteninhaber/in und das Finanzkonto zuzuweisen, geben Sie die ID der Karteninhaberin/des Karteninhabers im Parameter cardholder und die ID des Finanzkontos im Parameter financial_account der Anfrage /v1/issuing/cards an.

curl https://api.stripe.com/v1/issuing/cards \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d cardholder={{CARDHOLDER_ID}} \
  -d financial_account=
"{{FINANCIAL_ACCOUNT_ID}}" \
  -d currency=usd \
  -d type=virtual \
  -d status=active

Bei Erfolg gibt die Antwort die neu erstellte Card-Objekt zurück.

Lesen Sie den Leitfaden zu Autorisierungen in Issuing, um Autorisierungen korrekt zu verarbeiten.

Test-Autorisierungen erstellen

Sie können die Karten, die Sie gerade ausgestellt haben, testen, indem Sie die Schritte unter Issuing testen befolgen, um Einkäufe zu simulieren.

Wenn für das Finanzkonto, das mit der ausgestellten Karte verknüpft ist, die Einschränkung outbound_flows gilt, sind Autorisierungen für die Karte nicht zulässig.

Im Leitfaden Transaktionen in Issuing finden Sie Informationen zu verschiedenen Transaktionstypen, welche Sie testen können.

Im Leitfaden Transaktionen in Issuing erfahren Sie, wie Sie Rückerstattungen und Erfassungen handhaben.

Im Leitfaden Anfechtungen in Issuing erfahren Sie, wie Sie korrekt mit Zahlungsanfechtungen umgehen.