# Nur-Abwickler-Modell von Issuing integrieren

Richten Sie eine Integration für das Nur-Abwickler-Modell von Issuing ein.

Bevor Sie mit dem [Nur-Abwickler-Modell](https://docs.stripe.com/issuing/processor-only-issuing.md) fortfahren können, müssen Sie eine KYC-Prüfung (Know Your Customer) für Karteninhaber/innen durchführen. In diesem Modell stellt ein [Cardholder-Objekt](https://docs.stripe.com/api/issuing/cardholders.md) jeden Endkunden/jede Endkundin dar.

## Karteninhaber-Objekt erstellen

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](https://docs.stripe.com/api/issuing/cardholders/object.md?lang=ruby#issuing_cardholder_object-id) für den/die Karteninhaber/in.

```curl
curl https://api.stripe.com/v1/issuing/cardholders \
  -u "<<YOUR_SECRET_KEY>>:" \
  -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"
```

## Karte ausstellen

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](https://docs.stripe.com/api/issuing/cards/create.md?lang=ruby#create_issuing_card-currency) und den [Typ](https://docs.stripe.com/api/issuing/cards/object.md?lang=ruby#issuing_card_object-type) der Karte (`physical` oder `virtual`) angeben. Im folgenden Beispiel beziehen wir auch die [Versandinformationen](https://docs.stripe.com/api/issuing/cards/create.md?lang=ruby#create_issuing_card-shipping) der Karteninhaberin/des Karteninhabers ein.

```curl
curl https://api.stripe.com/v1/issuing/cards \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d currency=usd \
  -d type=physical \
  -d "cardholder={{ISSUINGCARDHOLDER_ID}}" \
  -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"
```

## Karte nachverfolgen

Verwenden Sie die Attribute [tracking_url](https://docs.stripe.com/api/issuing/cards/object.md#issuing_card_object-shipping-tracking_url) oder [tracking_number](https://docs.stripe.com/api/issuing/cards/object.md#issuing_card_object-shipping-tracking_number), um den Versandstatus der Karte nachzuverfolgen. Sie können auch den Webhook `issuing_card.updated` auf Aktualisierungen des [shipping.status](https://docs.stripe.com/api/issuing/cards/object.md#issuing_card_object-shipping-status) überwachen. Damit Sie Updates erhalten, muss der Versanddienstleister die Sendungsverfolgung unterstützen.

## Karte aktivieren

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
curl https://api.stripe.com/v1/issuing/cards/{{ISSUINGCARD_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d status=active
```

## Benachrichtigungen zu Autorisierungen einrichten

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](https://docs.stripe.com/issuing/controls/real-time-authorizations.md).

## Autorisierungsaktualisierungen abonnieren

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.

## Transaktionsaktualisierungen abonnieren

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](https://docs.stripe.com/issuing/purchases/transactions.md?issuing-capture-type=force_capture)). Außerdem muss der Transaktionsbetrag nicht mit dem Betrag aus einer verknüpften Autorisierung übereinstimmen (im Falle einer [partial_capture](https://docs.stripe.com/issuing/purchases/transactions.md?issuing-capture-type=partial_capture) oder [over_capture](https://docs.stripe.com/issuing/purchases/transactions.md?issuing-capture-type=over_capture)).

## See also

- [Berichterstattung](https://docs.stripe.com/stripe-reports.md)
- [Zahlungsanfechtungen](https://docs.stripe.com/issuing/purchases/disputes.md)
- [Tokenisierung](https://docs.stripe.com/issuing/cards/digital-wallets.md)
- [3D Secure (3DS)](https://docs.stripe.com/issuing/3d-secure.md)
- [Programmmanagement](https://docs.stripe.com/issuing/program-management.md)