Nur-Abwickler-Modell von Issuing integrieren

Erstellen Sie ein Cardholder-Objekt, um die Geschäftseinheit oder die Einzelperson darzustellen, die zur Verwendung der Karte berechtigt ist. Die Antwort enthält eine eindeutige ID für den/die Karteninhaber/in.

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

Stellen Sie die Karte an den/die Cardholder aus, indem Sie die id aus dem vorherigen Schritt übergeben. Sie müssen auch die Währung und den Typ der Karte (physical oder virtual) angeben. Im folgenden Beispiel beziehen wir auch die Versandinformationen der Karteninhaberin/des Karteninhabers ein.

curl https://api.stripe.com/v1/issuing/cards \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d currency=usd \
  -d type=physical \
  -d cardholder=ich_123 \
  -d "shipping[name]"="Jenny Rosen" \
  -d "shipping[address][line1]"="123 Main St" \
  -d "shipping[address][city]"="San Francisco" \
  -d "shipping[address][state]"=CA \
  -d "shipping[address][postal_code]"=94111 \
  -d "shipping[address][country]"=US

Verwenden Sie die Attribute tracking_url oder tracking_number, um den Versandstatus der Karte nachzuverfolgen. Sie können auch den Webhook issuing_card.updated auf Aktualisierungen des shipping.status überwachen. Damit Sie Updates erhalten, muss der Versanddienstleister die Sendungsverfolgung unterstützen.

Wenn Sie einen Webhook erhalten, der angibt, dass shipping.status gleich delivered ist, aktivieren Sie die Karte, indem Sie ihren Status aktualisieren. (Sie können diese API auch verwenden, um die Karte vorübergehend zu deaktivieren.) Standardmäßig sind Karten inaktiv, wenn sie erstellt werden.

curl https://api.stripe.com/v1/issuing/cards/ic_123 \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d status=active

Richten Sie den Webhook issuing_authorization.request ein, um sofort benachrichtigt zu werden, wenn jemand eine Autorisierungsanfrage für eine ausgestellte Karte stellt. Auf diese Weise können Sie die Autorisierung sofort genehmigen oder ablehnen und steuern, ob eine Transaktion zugelassen oder blockiert werden soll, bevor sie abgeschlossen ist. Weitere Informationen finden Sie unter Autorisierungen in Echtzeit mit Issuing.

Abonnieren Sie Webhook-Ereignisse des Typs issuing_authorization.create. Mit diesem Webhook werden Sie benachrichtigt, wenn jemand eine neue Autorisierung für eine ausgestellte Karte erstellt. Er enthält Details zum Ergebnis der Autorisierung, einschließlich der Angabe, ob diese genehmigt oder abgelehnt wurde. Auf diese Weise können Sie Autorisierungen nachverfolgen, Grenzfälle bearbeiten (z. B. Netzwerkablehnungen nach der Genehmigung) und das Guthaben des Karteninhabers/der Karteninhaberin zurückhalten, wenn eine Autorisierung durchgeführt wird.

Abonnieren Sie Webhook-Ereignisse des Typs issuing_transaction.create. Mit diesem Webhook werden Sie benachrichtigt, wenn eine neue Transaktion für eine ausgestellte Karte erstellt wird. Dies geschieht, wenn Stripe den Clearing-Datensatz für eine Autorisierung erhält. Sie können den Clearing-Datensatz nicht ablehnen, aber Sie können die Transaktion bei Bedarf anfechten. Verwenden Sie diesen Webhook, um finalisierte Ausgaben nachzuverfolgen und den Saldo der Karteninhaber/innen entsprechend zu aktualisieren.

Eine Transaktion muss nicht unbedingt mit einer Autorisierung verknüpft sein (im Falle einer erzwungenen Erfassung). Außerdem muss der Transaktionsbetrag nicht mit dem Betrag aus einer verknüpften Autorisierung übereinstimmen (im Falle einer partial_capture oder over_capture).

Abonnieren Sie den Webhook issuing_settlement, um Ihren täglichen Zahlungsabwicklungsbetrag beim Kartennetzwerk zu ermitteln. Mit diesem Webhook können Sie auch überprüfen, ob der Betrag mit den Transaktionen des Tages übereinstimmt.

Das Ereignis issuing_settlement.created gibt an, welchen Betrag Sie an einem bestimmten Tag mit dem Kartennetzwerk abrechnen müssen. Sie können dies mit dem Betrag abgleichen, der von Ihrem Bankkonto abgebucht wird. Stripe verknüpft Issuing-Transaktionen und Zahlungsanfechtungen mit dem Settlement-Objekt. Wenn wir alle Transaktionen gefunden haben, kennzeichnen wir den Zahlungsabwicklungsstatus als completed. Weitere Informationen finden Sie unter Settlement API.

Um die Auswirkungen auf den Saldo für eine/n bestimmte/n Karteninhaber/in zu verstehen und zu verfolgen, summieren Sie die mit der Zahlungsabwicklung verknüpften Objekte transaction und Details zur Anfechtung der Zahlungsabwicklung.