Domains für Zahlungsmethoden registrieren
Um bestimmte Zahlungsmethoden mit Elements oder dem einbettbaren Zahlungsformular von Checkout zu verwenden, müssen Sie jede Webdomain registrieren, die die Zahlungsmethode anzeigt. 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
- 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.
- If you’re setting up Apple Pay, follow the steps to verify your domain.
- (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
- 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.
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 attempts to request your domain association file, so it needs to be publicly available to Apple’s servers.
- Laden Sie die Domain-Zuordnungsdatei herunter.
- Hosten Sie die Datei unter
/.well-known/apple-developer-merchantid-domain-association
. Beispiel: Wenn Siehttps://yourdomain.com
registrieren, stellen Sie die Datei unterhttps://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 in Elements 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 die Elements die oben aufgeführten Zahlungsmethoden anzeigen. 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 geheimen Schlüssel Ihrer Plattform, um die Anfrage zu authentifizieren, und legen Sie 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 geheimen Schlüssel Ihrer Plattform, um die Anfrage zu authentifizieren, und lassen Sie den Stripe-Account-Header weg.
Erfahren Sie mehr über die Durchführung von API-Aufrufen für verbundene Konten.