# Domains für Zahlungsmethoden registrieren

Registrieren Sie Domains, um Zahlungsmethoden (einschließlich Link, Apple Pay und Google Pay) in Elements oder dem einbettbaren Zahlungsformular von Checkout zu verwenden.

Bei bestimmten Zahlungsmethoden müssen Sie jede Web-Domain registrieren, auf der die Zahlungsmethode angezeigt wird, wenn Ihre Integration *Elements* (A set of UI components for building a web checkout flow. They adapt to your customer's locale, validate input, and use tokenization, keeping sensitive customer data from touching your server) oder [die einbettbare Zahlungsseite von Checkout](https://docs.stripe.com/payments/checkout/how-checkout-works.md?payment-ui=embedded-page) verwendet. Dazu gehört die Registrierung von Top-Level-Domains und Subdomains. Wenn Sie beispielsweise die Domain **example.com** und Subdomains wie **shop.example.com** und **www.example.com** haben, erfahren Sie in diesem Leitfaden, wie Sie diese registrieren.

Nachdem Sie eine Domain registriert haben, kann diese Domain mit anderen Zahlungsmethoden verwendet werden, die Sie möglicherweise in der Zukunft aktivieren.

Registrieren Sie Ihre Domains für die folgenden Zahlungsmethoden:

- [Apple Pay](https://docs.stripe.com/apple-pay.md) (Required)
- [Amazon Pay](https://docs.stripe.com/payments/amazon-pay.md)
- [Google Pay](https://docs.stripe.com/google-pay.md)
- [Klarna](https://docs.stripe.com/payments/klarna.md)
- [Link](https://docs.stripe.com/payments/wallets/link.md)
- [PayPal](https://docs.stripe.com/payments/paypal.md)

> #### Apple Pay und Händlervalidierung
> 
> In der Dokumentation zu Apple Pay wird das Verfahren der „Händlervalidierung“ beschrieben, das Stripe im Hintergrund für Sie übernimmt. Sie müssen keine Apple-Händler-ID, CSR usw. erstellen. Befolgen Sie stattdessen die Schritte in diesem Leitfaden.

## Testen

Sie müssen auch Domains zum Testen registrieren. Bei lokalen Tests können Sie ein Tool wie [ngrok](https://ngrok.com/) verwenden, um eine HTTPS-Domain zu erhalten. Sie können sich entweder in einer *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) registrieren oder sich im Live-Modus registrieren. Die Domain wird dann ebenfalls automatisch in den Sandboxes registriert. Denken Sie daran, Ihre Domains vor dem Go-Live im Live-Modus zu registrieren.

# Dashboard

> This is a Dashboard for when dashboard-or-api is dashboard. View the full page at https://docs.stripe.com/payments/payment-methods/pmd-registration?dashboard-or-api=dashboard.

Sie können Domains im Dashboard auf der Seite [Zahlungsmethoden-Domains](https://dashboard.stripe.com/settings/payment_method_domains) zur Verwendung in Produktions- und Testumgebungen erstellen und verwalten.

> #### Connect
> 
> Connect-Plattformen, die Direct Charges erstellen, müssen zur Verwaltung von Domains für ihre [verbundenen Konten](https://docs.stripe.com/payments/payment-methods/pmd-registration.md#register-your-domain-while-using-connect) die API verwenden, nicht das Stripe-Dashboard.

## Ihre Domain registrieren

So registrieren Sie eine Domain:

1. Klicken Sie auf der Seite [Zahlungsmethoden-Domains](https://dashboard.stripe.com/settings/payment_method_domains) auf **Neue Domain hinzufügen**.
1. Geben Sie Ihren Domain-Namen ein.
1. Klicken Sie auf **Speichern und fortfahren**.
1. (Optional) Wiederholen Sie die Schritte 1–3 für weitere Domains, die Sie registrieren müssen.

Nachdem Sie diese Schritte ausgeführt haben, wird Ihre Domain auf der Seite „Zahlungsmethoden-Domains“ angezeigt.

### Verwendung eines iFrame

- **Verwenden eines iFrames mit [Elementen](https://docs.stripe.com/payments/elements.md)**: Bei der Verwendung eines iFrames muss dessen Ursprungsadresse mit der obersten Ursprungsadresse übereinstimmen (mit Ausnahme von Safari 17+ bei der Angabe des Attributs `allow="payment"`). Zwei Seiten haben denselben Ursprungsort, wenn das Protokoll, der Host (in diesem Fall der vollständige Domain-Name) und der Port (falls angegeben) für beide Seiten identisch sind.
- **Oberste Domain und iframe-Domain**: Wenn sich die oberste Domain von der iframe-Domain unterscheidet, müssen sowohl die oberste Domain als auch die Quell-Domain des Iframes als Zahlungsmethode auf dem zugehörigen Konto registriert sein.

## Ihre Domain verwalten

Im Dashboard können Sie eine Liste aller Domains einsehen.

Um eine Domain zu deaktivieren, klicken Sie auf die Zeilenaktion und dann auf **Deaktivieren**. Wenn eine Domain deaktiviert ist, werden die Zahlungsmethoden nicht mehr im einbettbaren Zahlungsformular von Elements oder Checkout auf dieser Domain angezeigt.

Um eine deaktivierte Domain zu aktivieren, klicken Sie auf die Zeilenaktion und dann auf **Aktivieren**.


# API

> This is a API for when dashboard-or-api is api. View the full page at https://docs.stripe.com/payments/payment-methods/pmd-registration?dashboard-or-api=api.

## Ihre Domain registrieren

Gehen Sie wie folgt vor, um eine Domain zu registrieren:

```curl
curl https://api.stripe.com/v1/payment_method_domains \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "domain_name=example.com"
```

Wiederholen Sie diesen Vorgang für alle Domains, die Sie registrieren müssen.

### Verwendung eines iFrame

- Wenn Sie einen iFrame verwenden, muss sein Ursprung mit dem Ursprung der obersten Ebene übereinstimmen (mit Ausnahme von Safari 17+). Zwei Seiten haben denselben Ursprung, wenn Protokoll, Host (vollständiger Domain-Name) und Port (falls angegeben) für beide Seiten gleich sind.
- Wenn Sie einen ursprungsübergreifenden iframe in Safari 17+ verwenden, müssen Sie das Attribut `allow=“payment”` angeben. Um Apple Pay zu aktivieren, müssen Sie auch die Quelldomain registrieren, die der iFrame lädt.

## Ihre Domain verwalten

Mit der [PaymentMethodDomain API](https://docs.stripe.com/api/payment_method_domains/object.md) können Sie Folgendes tun:

- Eine Domain abrufen.
- Eine Liste all Ihrer Domain anzeigen.
- Eine Domain aktivieren oder deaktivieren. Wenn eine Domain deaktiviert ist, werden die Zahlungsmethoden nicht mehr im einbettbaren Zahlungsformular von Elements oder Checkout auf dieser Domain angezeigt.

Dieses Beispiel zeigt, wie Sie eine Domain deaktivieren:

```curl
curl https://api.stripe.com/v1/payment_method_domains/{{PAYMENT_METHOD_DOMAIN_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d enabled=false
```


## Registrieren Sie Ihre Domain, während Sie Connect nutzen

Connect-Plattformen müssen alle Domains registrieren, bei denen das einbettbare Zahlungsformular von Elements oder Checkout die oben aufgeführten Zahlungsmethoden anzeigt. Die Domain, unter der die Zahlung ausgeführt wird, muss für den/die Nutzer/in registriert sein, der/die die Zahlung ausführt.

Wenn die Plattform [Direct Charges](https://docs.stripe.com/connect/direct-charges.md) erstellt, verwenden Sie den Geheimschlüssel Ihrer Plattform, um die Anfrage zu authentifizieren, und legen den Stripe-Account-Header auf die Stripe-ID Ihres verbundenen Kontos fest.

Wenn die Plattform [Destination Charges](https://docs.stripe.com/connect/destination-charges.md) oder [separate Zahlungen und Überweisungen](https://docs.stripe.com/connect/separate-charges-and-transfers.md) erstellt, verwenden Sie den Geheimschlüssel Ihrer Plattform, um die Anfrage zu authentifizieren, und lassen den Stripe-Account-Header weg.

Erfahren Sie mehr über die [Durchführung von API-Aufrufen für verbundene Konten](https://docs.stripe.com/connect/authentication.md).

```curl
curl https://api.stripe.com/v1/payment_method_domains \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "domain_name=example.com"
```