Domains für Zahlungsmethoden registrieren

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

Für bestimmte Zahlungsmethoden müssen Sie jede Webdomain registrieren, die die Zahlungsmethode anzeigt, wenn Ihre Integration Elements oder das einbettbare Zahlungsformular von Checkout verwendet. Dazu gehört die Registrierung von Top-Level-Domains und Subdomains. Wenn Sie beispielsweise die Domain yourdomain.com und Subdomains wie shop.yourdomain.com und www.yourdomain.com haben, wird in dieser Anleitung erläutert, 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.

Für die folgenden Zahlungsmethoden ist eine Registrierung erforderlich:

Google Pay
Link
PayPal
Amazon Pay
Apple Pay (zusätzlicher Verifizierungsschritt erforderlich)

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 außerdem Domains für die Tests registrieren. Bei lokalen Tests können Sie ein Tool wie z. B. ngrok verwenden, um eine HTTPS-Domain zu erlangen. Sie können sich entweder im Testmodus oder im Live-Modus registrieren. Die Domain wird jedoch automatisch im Testmodus registriert. Registrieren Sie Ihre Domains vor dem Go-Live unbedingt auch im Live-Modus.

Sie können Domains im Dashboard auf der Seite Zahlungsmethoden-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 die API verwenden, nicht das Stripe-Dashboard.

Ihre Domain registrieren

So registrieren Sie eine Domain:

Klicken Sie auf der Seite Zahlungsmethoden-Domains auf Neue Domain hinzufügen.
Geben Sie Ihren Domain-Namen ein.
Klicken Sie auf Speichern und fortfahren.
Wenn Sie Apple Pay einrichten, verifizieren Sie die Inhaberschaft Ihrer Domain bei Apple, indem Sie die weiter unten auf dieser Seite beschriebenen Schritte ausführen.
(Optional) Wiederholen Sie die Schritte 1 bis 4 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: 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.

Die Inhaberschaft Ihrer Domain bei Apple Pay verifizieren

Während der Registrierung versucht Stripe automatisch, die Inhaberschaft Ihrer Domain bei Apple zu verifizieren. Falls die Domain nicht bereits verifiziert ist, registrieren Sie Ihre Domain und befolgen Sie dann diese Schritte, um Ihre registrierte Domain mit Apple Pay zu verifizieren.

Häufiger Fehler

Apple versucht, Ihre Domain-Zuordnungsdatei anzufordern, daher muss sie für die Server von Apple öffentlich zugänglich sein.

Laden Sie die Domain-Zuordnungsdatei herunter.
Hosten Sie die Datei unter /.well-known/apple-developer-merchantid-domain-association. Beispiel: Wenn Sie https://yourdomain.com registrieren, stellen Sie die Datei unter https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association zur Verfügung.
Klicken Sie auf Verifizieren.

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.

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 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 oder separate Zahlungen und Überweisungen 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.