# Deep-Links hinzufügen

Erstellen Sie Deep-Links, über die Nutzer/innen zu Ihrer Stripe-App gelangen.

Bei einem Deep Link handelt es sich um eine URL, die die Anzahl der Navigationsschritte zum Öffnen Ihrer App im Dashboard reduziert. Sie können Deep Links in Nutzeroberflächen wie E-Mails oder Websites freigeben und sie beim [Erstellen von OAuth-Autorisierungs-Workflows](https://docs.stripe.com/stripe-apps/pkce-oauth-flow.md) verwenden.

## Before you begin

Um eine Dashboard-Seite mit Ihrer App zu erstellen, benötigen Sie eine App mit [Nutzeroberflächenfunktion](https://docs.stripe.com/stripe-apps/build-ui.md).

## Deep-Link-URL erstellen

Zum Erstellen der URL des Deep Link müssen Sie Folgendes verwenden:

- Die ID des Stripe-Kontos, auf dem Ihre App installiert ist. Weitere Informationen finden Sie unter [Nutzerkontext](https://docs.stripe.com/stripe-apps/reference/extensions-sdk-api.md#user-context).
- Die URL einer Dashboard-Seite, auf der Sie eine *Ansicht* (A view is a React component that creates UI extensions in the Stripe Dashboard) definiert haben.
- Der `Apps`-Parameter, um Ihre App anzugeben und festzulegen, wo sie geöffnet werden soll.
- Ihr Anmeldeformular, das im [`ID`-Feld Ihrer `stripe-app.json`-Manifestdatei](https://docs.stripe.com/stripe-apps/reference/app-manifest.md#schema) angegeben ist.

> Ein älteres Format mit dem `open_drawer_app`-Parameter funktioniert weiterhin für die Abwärtskompatibilität, aber das moderne `Apps`-Parameterformat wird empfohlen.

### Deep-Link-Format

Die Struktur einer Deep-Link-URL ist:

```
https://dashboard.stripe.com/<ACCOUNT_ID>/<MODE>/<PAGE>?apps[<APP_ID>][TARGET]=VIEWPORT_ID
```

Hier gilt:

- **KONTO\_ID**: Die ID des Stripe-Kontos (beginnt mit `acct_`)
- **MODUS**: Verwenden Sie `test` für *Test-Modus* (Test mode is another way to test changes to your integration without affecting production. A sandbox is the default and recommended way to test integrations. All Stripe features are available in test mode but you can't create live charges unless you're in live mode) oder lassen Sie den Wert aus für den für Live-Modus
- **SEITE**: Die anzuzeigende Dashboard-Seite (z.&nbsp;B. `Kundinnen und Kunden`, `Rechnungen` oder `Dashboard`)
- **APP\_ID**: Ihre Anwendungs-ID aus Ihrer Manifestdatei
- **ZIEL**: Wo Sie Ihre App öffnen, z. B. `drawer` (wenn Sie Drawer verwenden) oder `modal` (zum Öffnen des Onboarding)
- **VIEWPORT\_ID**: In Ihrer Manifestdatei konfigurierte Darstellungsfeld-IDs (z.&nbsp;B. `stripe.dashboard.payment.list`)

### Beispiele

Wenn Sie auf der Kundenseite im Dashboard (`https://dashboard.stripe.com/test/customers?`) eine *Ansicht* (A view is a React component that creates UI extensions in the Stripe Dashboard) definieren und Ihr Anwendungs-ID `com.example.my-app` lautet:

- Der Deep Link für den *Test-Modus* (Test mode is another way to test changes to your integration without affecting production. A sandbox is the default and recommended way to test integrations. All Stripe features are available in test mode but you can't create live charges unless you're in live mode) und die *Sandbox* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes) lautet:

  ```
    <a href="https://dashboard.stripe.com/acct_id/test/customers?apps[com.example.my-app][drawer]=">Deep Link</a>
  ```

- Der Deep Link für den Live-Modus lautet:

  ```
  <a href="https://dashboard.stripe.com/acct_id/customers?apps[com.example.my-app][drawer]=">Deep Link</a>
  ```

Sie können Ihre App auf jeder Dashboard-Seite öffnen, auf der Sie eine Ansicht definiert haben. Um sie beispielsweise auf der Dashboard-Startseite zu öffnen:

```
 <a href="https://dashboard.stripe.com/acct_id/test/dashboard?apps[com.example.my-app][drawer]=">Deep Link</a>
```

Um einen Deep-Link zu Ihrem Onboarding-Modal zu erstellen, verwenden Sie `Modal` anstelle von `Drawer`:

```
<a href="https://dashboard.stripe.com/acct_id/dashboard?apps[com.example.my-app][modal]=">Open in Modal</a>
```

## Deep Link teilen

Verwenden Sie unbedingt die URL für den Live-Modus, wenn Sie den Deep Link mit Ihren Nutzer/innen teilen. Sie können den Link überall für Nutzer/innen teilen, die Ihre App installiert haben. Wenn die Nutzer/innen ihre App nicht installiert haben, bevor sie auf den Deep Link klicken, leitet Stripe sie zu einer geschlossenen App, die nicht im Dashboard geöffnet werden kann.

## Deep Link testen

1. Melden Sie sich beim Dashboard als Nutzer/in an, der/die die App installiert hat.

1. Klicken Sie auf den Deep Link.

   Sollten Sie zu einer Anwendung weitergeleitet werden, die sich nicht öffnen lässt, überprüfen Sie bitte Folgendes:

   - Der Parameter `Apps` verwendet die korrekte Anwendungs-ID aus Ihrem Manifest
   - Die Konto-ID im URL-Pfad ist korrekt (Format: `acct_` gefolgt von alphanumerischen Zeichen)
   - Die Nutzerin bzw. der Nutzer hat die App für dieses Konto installiert
   - Die Dashboard-Seite in der URL verfügt über eine für Ihre App definierte Ansicht

## See also

- [Dokumentation zum App-Manifest](https://docs.stripe.com/stripe-apps/reference/app-manifest.md)
- [Versionen und Releases](https://docs.stripe.com/stripe-apps/versions-and-releases.md)