Apple Pay-Funktionen in Xamarin.iOS

Um Funktionen zu einer Anwendung hinzuzufügen, ist oft eine zusätzliche Bereitstellungseinrichtung erforderlich. In diesem Leitfaden werden die erforderlichen Einstellungen für die Apple Pay-Funktionen erläutert.

Apple Pay ermöglicht Benutzern das Bezahlen physischer Güter über das iOS-Gerät. Dieser Abschnitt beschreibt, wie alle erforderlichen Komponenten für Apple Pay in Apple Developer Center erstellt werden.

Bei der Bereitstellung einer neuen Anwendung über das Developer Center gibt es drei Schritte, die ausgeführt werden müssen:

1. Erstellen Sie eine Händler-ID.
2. Erstellen Sie eine App-ID mithilfe der Apply Pay-Funktion, und fügen Sie den Händler hinzu.
3. Generieren Sie ein Zertifikat für die Händler-ID.

Die folgenden Schritte führen Sie durch die Erstellung der oben genannten Elemente:

Erstellen der Händler-ID

Eine Händler-ID wird verwendet, um Apple Pay wissen zu lassen, dass Sie Zahlungen akzeptieren können. Sie wird an PassKits PaymentRequest-Methode übergeben und in der Apple Pay-Berechtigung verwendet:

1. Navigieren Sie zum Apple Developer Center und dann zum Abschnitt „Certificates, Identifier, and Profiles“ (Zertifikate, Bezeichner und Profile):

   

2. Wählen Sie unter Bezeichner die Händler-IDs aus, und wählen Sie dann + aus, um eine neue Händler-ID zu erstellen:

3. Füllen Sie das Formular, wie unten angegeben, mit einer neuen Beschreibung und einem Bezeichner aus. Durch die Beschreibung kann die ID von Ihnen identifiziert und später geändert werden. Der Bezeichner muss für Sie eindeutig sein, und er muss mit der Zeichenfolge merchant beginnen. Apple empfiehlt, dass der Bezeichner im folgenden Format dargestellt wird: merchant.com.[Your-App-Name]:

   

4. Bestätigen Sie die Details, und Registrieren Sie Ihre ID:

   

Erstellen einer App-ID mit der Apple Pay-Funktion, die die Händler-ID enthält

1. Klicken Sie im Developer Center auf die App-IDs unter Bezeichner:

   

2. Klicken Sie zum Hinzufügen einer neuen App-ID auf die Schaltfläche + :

   

3. Geben Sie einen Namen für die App-ID und eine explizite App-ID an:

   

4. Wählen Sie unter App-Dienste Apple Pay aus:

   

5. Klicken Sie auf Continue (Weiter) und dann auf Registrieren. Beachten Sie, dass Apple Pay auf dem Bestätigungsbildschirm als konfigurierbar aktiviert ist und ein gelbes Symbol angezeigt wird:

   

6. Wechseln Sie zurück zur Liste der App-IDs, und wählen Sie diejenige aus, die Sie gerade erstellt haben:

   

7. Führen Sie einen Bildlauf zum unteren Rand dieses erweiterten Abschnitts aus, und klicken Sie auf Bearbeiten.

8. Scrollen Sie nach unten zu Apple Pay, und klicken Sie auf die Schaltfläche Bearbeiten:

   

9. Wählen Sie die Händler-ID aus, die mit dieser App-ID verwendet wird, und klicken Sie auf Fortfahren:

   

10. Bestätigen Sie die Zuweisungen der Händler-ID, und klicken Sie auf Zuweisen:

    

Diese App-ID kann jetzt zum Generieren oder erneuten Generieren eines neuen Bereitstellungsprofils verwendet werden (siehe die Erläuterung in der Anleitung Arbeiten mit Funktionen).

Erstellen eines Zertifikats für die Händler-ID

Apple erfordert ein Zertifikat zum Verschlüsseln vertraulicher Daten, die der Transaktion zugeordnet sind. Jede erstellte Händler-ID muss über ein eigenes Zertifikat verfügen.

Führen Sie die folgenden Schritte aus, um ein Zertifikat zu erstellen:

1. Wählen Sie die Händler-ID aus, die oben erstellt wurde, und drücken Sie Bearbeiten:

   

2. Klicken Sie auf dem iOS-Bildschirm der Einstellungen der Händler-ID auf Zertifikat erstellen:

   

3. Beantworten Sie die folgende Frage:

   

4. An diesem Punkt werden Sie aufgefordert, eine Zertifikatsignieranforderung zu erstellen:

   

   Wichtig

   Bei Verwendung eines Zahlungsanbieters für Apple Pay, wie JudoPay oder Stripe, können Sie eine ordnungsgemäß formatierte CSR anfordern, die Sie an diesem Punkt verwenden können. Informationen zu dieser Anforderung finden Sie auf der Stripe-Website. Führen Sie die Schritte 5 bis 8 unten aus, um Ihre eigene CSR zu erstellen. Sobald Sie über eine CSR verfügen, fahren Sie mit Schritt 9 fort.

5. Öffnen Sie die Keychain Access-Anwendung, und navigieren Sie zu Keychain Access > Certificate Assistant > Anfordern eines Zertifikats von einer Zertifizierungsstelle:

   

6. Geben Sie Ihre E-Mail-Adresse und einen Namen für den privaten Schlüssel ein, lassen Sie die CA-E-Mail-Adresse leer, wählen Sie die Option Auf Datenträger speichern aus, und wählen Sie Let me specify key pair information (Schlüsselpaarinformationen angeben) aus:

   

7. Speichern Sie die CSR an einem geeigneten Speicherort:

   

8. Legen Sie im Informationsbildschirm „Schlüsselpaar“ die Schlüsselgröße auf 256 Bits und den Algorithmus auf ECC fest, und klicken Sie auf Fortfahren:

   

9. Klicken Sie im Developer Center auf Fortfahren, um die CSR hochzuladen:

   

10. Klicken Sie auf Datei auswählen, um die CSR auszuwählen, und drücken Sie Weiter , um sie in das Entwicklerportal hochzuladen:

    

11. Sobald das Zertifikat generiert wurde, laden Sie es herunter. Klicken Sie zweimal darauf, um es auf Ihrer Keychain zu installieren.

Weitere Informationen zur Verwendung von Apple Pay finden Sie im folgenden Handbuch:

• Introduction to Apple Pay (Einführung in Apple Pay)

Nächste Schritte

In der folgenden Liste werden mögliche weitere Schritte aufgeführt:

• Verwenden des Framework-Namespaces in Ihrer App
• Hinzufügen der erforderlichen Berechtigungen zu Ihrer App Informationen zu den erforderlichen Berechtigungen und wie sie hinzugefügt werden finden Sie im Leitfaden Arbeiten mit Berechtigungen.
• Stellen Sie im Bereich iOS-Bündelsignierung der App sicher, dass Benutzerdefinierte Berechtigungen auf Entitlements.plist festgelegt ist. Hierbei handelt es sich nicht um die Standardeinstellung für Debug- und iOS-Simulatorbuilds.

Wenn Probleme mit App-Diensten auftreten, konsultieren Sie den Abschnitt Problembehandlung in der Hauptanleitung.