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.
Ihre Domain registrieren
Gehen Sie wie folgt vor, um eine Domain zu registrieren:
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.
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.
- Laden Sie die Domain-Zuordnungsdatei herunter.
- Hosten Sie die Datei unter
/.well-known/apple-developer-merchantid-domain-association
auf Ihrer Seite. Beispiel: Wenn Siehttps://yourdomain.com
registrieren, stellen Sie die Datei unterhttps://yourdomain.com/.well-known/apple-developer-merchantid-domain-association
zur Verfügung.
Stripe führt eine anfängliche Domain-Verifizierung durch, wobei die Anfragen von einer unserer Webhook-IPs stammen.
Ihre Domain verwalten
Mit der PaymentMethodDomain API 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 in Elements dieser Domain angezeigt.
Dieses Beispiel zeigt, wie Sie eine Domain deaktivieren:
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.