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

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

1. Fügen Sie Ihrer Domain eine apple-app-site-association-Datei hinzu.
2. Fügen Sie Ihrer App eine Berechtigung für die zugewiesenen Domains (“Associated Domains”) hinzu.
3. 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.

{
  "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"
               }
             ]
           }
       ]
   }
}

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.

1. Öffnen Sie den Bereich Signierung & Kapazitäten der Zielanwendung Ihrer App.
2. Klicken Sie auf + Funktion und wählen Sie dann Zugewiesene Domains aus.
3. 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.

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

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 und client_reference_id , um den Bezahlvorgang zu optimieren und Ihren Abgleich zu erleichtern.

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

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

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

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:

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