Zahlungen für digitale Waren in iOS mit Payment Links akzeptieren

Verlinken Sie von Ihrer App aus auf eine von Stripe gehostete Bezahlseite, um digitale Waren oder Abonnements zu verkaufen.

Für digitale Produkte, Inhalte und Abos, die in den Vereinigten Staaten oder im Europäischen Wirtschaftsraum (EWR) verkauft werden, kann Ihre iOS-App Apple Pay über Payment Links akzeptieren.

In anderen Regionen kann Ihre App Apple Pay für digitale Produkte, Inhalte oder Abos nicht akzeptieren.

In diesem Leitfaden wird beschrieben, wie Sie digitale Waren und Dienstleistungen in Ihrer App verkaufen, indem Sie Ihre Kundinnen und Kunden über Payment Links auf eine von Stripe gehostete Zahlungsseite weiterleiten.

Verwenden Sie Payment Links, wenn Sie eine begrenzte Anzahl von Produkten und Preisen haben und keinen Server betreiben möchten. Verwenden Sie Stripe Checkout oder Elements für einen dynamischeren Warenkorb oder um eine Kundin/einen Kunden an die Checkout-Sitzung zu binden.

Dieser Leitfaden beschreibt nur den Prozess für den Verkauf digitaler Güter in der App. Wenn Sie eines der folgenden Produkte verkaufen, verwenden Sie stattdessen den Leitfaden für native iOS-Zahlungen:

Physische Waren
Waren und Dienste zum Verbrauch außerhalb Ihrer App
Echtzeit-Dienste von Person zu Person

Sie werden Folgendes entwickeln

Dieser Leitfaden bietet Informationen zu den folgenden Vorgehensweisen:

Modellieren Sie Ihre digitalen Waren oder Abonnements mit Produkten und den zugehörigen Preisen.
Einen Zahlungslink über das Dashboard erstellen.
Verwenden Sie universelle Links, um vom Zahlungslink direkt an Ihre App weiterzuleiten.
Überwachen Sie Webhooks, um die In-App-Abonnements Ihrer Kundinnen und Kunden zu aktualisieren.

Was nicht behandelt wird

Dieser Leitfaden erläutert, wie Sie Zahlungslinks neben Ihrem bestehenden In-App-Kaufsystem einrichten. Nicht behandelt wird:

Benutzerauthentifizierung. Falls Sie noch keinen Authentifizierungsanbieter haben, können Sie einen Drittanbieter wie Sign in with Apple oder Firebase Authentication verwenden.
Native In-App-Käufe. Um In-App-Käufe mit StoreKit umzusetzen, besuchen Sie den Leitfaden zu In-App-Käufen von Apple.

Universelle Links einrichten
Clientseitig
Serverseitig

Universelle Links ermöglichen es Zahlungslinks, nach einer erfolgreichen Zahlung einen Deep Link zu Ihrer App herzustellen. So konfigurieren Sie einen universellen Link:

Fügen Sie Ihrer Domain eine apple-app-site-association-Datei hinzu.
Fügen Sie Ihrer App eine Berechtigung für die zugewiesenen Domains (“Associated Domains”) hinzu.
Fügen Sie eine Fallbackseite für Ihre Checkout-Umleitungs-URL hinzu.

Definieren Sie die zugewiesenen Domains

Fügen Sie Ihrer Domain eine Datei unter .well-known/apple-app-site-association hinzu, um die URLs zu definieren, die Ihre App verarbeitet. Stellen Sie Ihrer App-ID die Team-ID voran, die Sie auf der Mitgliedschafts-Seite des Apple Developer Portals finden.

.well-known/apple-app-site-association
{
  "applinks": {

      "apps": [],
      "details": [
           {
             "appIDs": [ "A28BC3DEF9.com.example.MyApp1",
                         "A28BC3DEF9.com.example.MyApp1-Debug" ],
             "components": [
               {
                  "/": "/checkout_redirect*",
                  "comment": "Matches any URL whose path starts with /checkout_redirect"
               }
             ]
           }
       ]
   }
}

Achtung

Sie müssen der Datei den MIME-Typ application/json hinzufügen. Mit curl -I bestätigen Sie den Inhaltstyp.

Command Line
curl -I https://example.com/.well-known/apple-app-site-association

Auf der Seite Zugewiesene Domains unterstützen von Apple finden Sie weitere Einzelheiten hierzu.

Fügen Sie Ihrer App eine Berechtigung für die zugewiesenen Domains (“Associated Domains”) hinzu.

Öffnen Sie den Bereich Signierung & Kapazitäten der Zielanwendung Ihrer App.
Klicken Sie auf + Funktion und wählen Sie dann Zugewiesene Domains aus.
Fügen Sie der Liste der zugewiesenen Domains einen Eintrag für applinks:example.com hinzu.

Weitere Informationen zu universellen Links finden Sie auf der Seite Universelle Links von Apple.

Obgleich iOS Links an die in Ihrer apple-app-site-association-Datei definierten URLs abruft, kann es zu Situationen kommen, in denen die Umleitung Ihre App nicht öffnen kann.

Zahlungslink für Ihr Produkt oder Abonnement erstellen

Öffnen Sie im Dashboard die Seite Payment Links und klicken Sie auf +Neu (oder klicken Sie auf das Pluszeichen (+) und wählen Sie Zahlungslink aus).
(Optional) Lassen Sie Ihre Kundin oder Ihren Kunden selbst entscheiden, wie viel sie oder er zahlen möchte (z. B. um zu entscheiden, welchen Betrag an Gutschriften er/sie kaufen möchte), indem Sie Kundinnen/Kunden wählen, was sie bezahlen möchten auswählen.
Wählen Sie ein bestehendes Produkt aus oder klicken Sie auf +Neues Produkt hinzufügen.
Wenn Sie ein neues Produkt hinzufügen, füllen Sie die Produktdetails aus und klicken Sie auf Produkt hinzufügen.
Wählen Sie Nach der Zahlung die Option Bestätigungsseite nicht anzeigen aus.
Legen Sie einen universellen Link als Erfolgs-URL fest, um Ihre Kundinnen/Kunden nach Abschluss der Zahlung auf Ihre App zu leiten.
Klicken Sie auf Link erstellen

Payment Links unterstützt standardmäßig Kartenzahlungen und Apple Pay. Sie können zusätzliche Zahlungsmethoden über das Dashboard aktivieren.

Verwenden Sie URL-Parameter, um relevante Informationen anzuhängen

Mit URL-Parametern können Sie Ihrer Zahlungsseite zusätzlichen Kontext hinzufügen und den Bezahlvorgang optimieren. Sie können URL-Parameter verwenden, um die Sprache der Zahlungsseite anzupassen, eine E-Mail oder einen Aktionscode vorab auszufüllen oder relevante Metadaten anzuhängen, um den Abgleich zu erleichtern.

Wir empfehlen die Verwendung von prefilled_email (oder locked_prefilled_email) und client_reference_id , um den Bezahlvorgang zu optimieren und Ihren Abgleich zu verbessern.

Parameter Beschreibung Syntax

Parameter	Beschreibung	Syntax
`prefilled_email`	Verwenden Sie `prefilled_email`, um eine E-Mail-Adresse automatisch auf der Zahlungsseite einzugeben. Kundinnen/Kunden können dieses Feld immer noch bearbeiten, sodass die E-Mail, die Sie für den Bezahlvorgang eingeben, möglicherweise nicht dieselbe E-Mail ist, die Ihre Kundinnen/Kunden verwenden, um die Zahlung abzuschließen.	`prefilled_email` muss eine gültige E-Mail-Adresse sein. Ungültige Werte werden ignoriert und Ihre Zahlungsseite funktioniert weiterhin wie erwartet. Wir empfehlen die Codierung der E-Mail-Adressen, die Sie als URL-Parameter anhängen, um das Risiko zu senken, dass sie nicht an Ihre Zahlungsseite weitergeleitet werden.
`locked_prefilled_email`	Verwenden Sie `locked_prefilled_email`, um automatisch eine nicht editierbare E-Mail-Adresse auf der Zahlungsseite einzugeben.	`locked_prefilled_email` muss eine gültige E-Mail-Adresse sein. Ungültige Werte werden ignoriert und Ihre Zahlungsseite funktioniert weiterhin wie erwartet. Wenn sowohl `prefilled_email` und `locked_prefilled_email` übergeben werden, hat `locked_prefilled_email` Vorrang. Wir empfehlen die Codierung der E-Mail-Adressen, die Sie als URL-Parameter anhängen, um das Risiko zu senken, dass sie nicht an Ihre Zahlungsseite weitergeleitet werden.
`client_reference_id`	Verwenden Sie `client_reference_id`, um eine eindeutige Zeichenfolge Ihrer Wahl hinzuzufügen, die auf die Checkout-Sitzung verweist. Dies kann eine App-ID, eine Warenkorb-ID oder ähnliches sein und kann zum Abgleich der Sitzung mit Ihren internen Systemen verwendet werden. Dieser Wert wird dem Kunden/der Kundin während des Bezahlvorgangs nicht angezeigt, sondern nach Abschluss der Zahlung im Webhook checkout.session.completed gesendet.	`client_reference_id` kann aus alphanumerischen Zeichen, Bindestrichen oder Unterstrichen bestehen und einen beliebigen Wert von bis zu 200 Zeichen haben. Ungültige Werte werden ignoriert und Ihre Zahlungsseite funktioniert weiterhin wie erwartet.

prefilled_email

Verwenden Sie prefilled_email, um eine E-Mail-Adresse automatisch auf der Zahlungsseite einzugeben. Kundinnen/Kunden können dieses Feld immer noch bearbeiten, sodass die E-Mail, die Sie für den Bezahlvorgang eingeben, möglicherweise nicht dieselbe E-Mail ist, die Ihre Kundinnen/Kunden verwenden, um die Zahlung abzuschließen.

prefilled_email muss eine gültige E-Mail-Adresse sein. Ungültige Werte werden ignoriert und Ihre Zahlungsseite funktioniert weiterhin wie erwartet.

Wir empfehlen die Codierung der E-Mail-Adressen, die Sie als URL-Parameter anhängen, um das Risiko zu senken, dass sie nicht an Ihre Zahlungsseite weitergeleitet werden.

locked_prefilled_email

Verwenden Sie locked_prefilled_email, um automatisch eine nicht editierbare E-Mail-Adresse auf der Zahlungsseite einzugeben.

locked_prefilled_email muss eine gültige E-Mail-Adresse sein. Ungültige Werte werden ignoriert und Ihre Zahlungsseite funktioniert weiterhin wie erwartet. Wenn sowohl prefilled_email und locked_prefilled_email übergeben werden, hat locked_prefilled_email Vorrang.

Wir empfehlen die Codierung der E-Mail-Adressen, die Sie als URL-Parameter anhängen, um das Risiko zu senken, dass sie nicht an Ihre Zahlungsseite weitergeleitet werden.

client_reference_id Verwenden Sie client_reference_id, um eine eindeutige Zeichenfolge Ihrer Wahl hinzuzufügen, die auf die Checkout-Sitzung verweist. Dies kann eine App-ID, eine Warenkorb-ID oder ähnliches sein und kann zum Abgleich der Sitzung mit Ihren internen Systemen verwendet werden. Dieser Wert wird dem Kunden/der Kundin während des Bezahlvorgangs nicht angezeigt, sondern nach Abschluss der Zahlung im Webhook checkout.session.completed gesendet. client_reference_id kann aus alphanumerischen Zeichen, Bindestrichen oder Unterstrichen bestehen und einen beliebigen Wert von bis zu 200 Zeichen haben. Ungültige Werte werden ignoriert und Ihre Zahlungsseite funktioniert weiterhin wie erwartet.

Nachfolgend finden Sie ein Beispiel für einen Link mit prefilled_email und client_reference_id:

https://buy.stripe.com/test_eVa3do41l4Ye6KkcMN?prefilled_email=jenny%40example.com&client_reference_id=id_123

Link zu Ihrer App hinzufügen

Fügen Sie Ihrer App eine Checkout-Schaltfläche hinzu. Diese Schaltfläche:

Füllt Ihren Zahlungslink mit prefilled_email and client_reference_id aus.
Öffnet die von Stripe gehostete Zahlungsseite in Safari.

Umgang mit Bestellabwicklung
Serverseitig

Nach erfolgreicher Kaufabwicklung sendet Stripe Ihnen den Webhook checkout.session.completed. In der Nutzlast des Webhook-Ereignisses finden Sie das client_reference_id unter dem checkout.session object, das Sie für Ihre Geschäftslogik verwenden können, z. B. die Zuordnung der Zahlung zu einer bestimmten Bestellung oder einem bestimmten Nutzer/einer bestimmten Nutzerin in Ihrem System.

Um Ihre Integration zu testen, können Sie Ereignisse im Dashboard überwachen oder die Stripe CLI verwenden. Richten Sie in der Produktion einen Webhook-Endpoint ein und abonnieren Sie die entsprechenden Ereignistypen. Wenn Sie Ihren STRIPE_WEBHOOK_SECRET-Schlüssel nicht kennen, klicken Sie auf den Webhook im Dashboard, um ihn anzuzeigen.

Tests

So testen Sie, ob Ihre Checkout-Schaltfläche funktioniert:

Klicken Sie auf die Schaltfläche Bezahlvorgang, die Sie dann zum Checkout-Zahlungsformular von Stripe weiterleitet.
Geben Sie die Testnummer , einen dreistelligen CVC, ein Ablaufdatum und eine gültige Postleitzahl.
Tippen Sie auf Bezahlen.
Der Webhook checkout.session.completed wird ausgelöst und Stripe benachrichtigt Ihren Server über die Transaktion. Sie werden zu Ihrer App zurückgeleitet.

OptionalIn-App-Käufe mit Lemon Squeezy

Akzeptieren Sie Zahlungen mit Lemon Squeezy, das viele Geschäftsfunktionen (zum Beispiel Steuerangelegenheiten und Zahlungsanfechtungen) für Sie übernehmen kann. Erfahren Sie mehr darüber, wie Sie Lemon Squeezy als Ihren eingetragenen Händler für In-App-Käufe verwenden.