Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden

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.

Ihre Domain registrieren

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

Command Line
curl https://api.stripe.com/v1/payment_method_domains \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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.

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.

  1. Laden Sie die Domain-Zuordnungsdatei herunter.
  2. Hosten Sie die Datei unter /.well-known/apple-developer-merchantid-domain-association auf Ihrer Seite. 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.
Command Line
curl -X POST https://api.stripe.com/v1/payment_method_domains/{{PAYMENT_METHOD_DOMAIN_ID}}/validate \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

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 im einbettbaren Zahlungsformular von Elements oder Checkout auf dieser Domain angezeigt.

Dieses Beispiel zeigt, wie Sie eine Domain deaktivieren:

Command Line
curl https://api.stripe.com/v1/payment_method_domains/{{PAYMENT_METHOD_DOMAIN_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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 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.

Command Line
curl https://api.stripe.com/v1/payment_method_domains \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d domain_name="example.com"
War diese Seite hilfreich?
JaNein
Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unseren Produkt-Changelog an.
Fragen? Sales-Team kontaktieren.
Unterstützt von Markdoc