Verwendung digitaler Geldbörsen mit Issuing

Stripe stellt einen SDK-Wrapper für eine private Google-Bibliothek für das Push-Provisioning bereit. Gehen Sie wie folgt vor, um Ihre App im Google Pay Store mithilfe von Push-Provisioning bereitstellen zu können:

• Zugriff auf Google Pay anfordern. Nach Ausfüllen des Formulars können Sie innerhalb weniger Stunden bis zu einem Tag mit der Genehmigung rechnen.
• Laden Sie nach Erhalt der Genehmigung das private TapAndPay SDK von Google herunter. Die zuletzt getestete Version des TapAndPay SDK ist Version 18.
• Fordern Sie Zugriff auf die Push-Provisioning API für Ihre App an. Sie müssen Ihre App-ID angeben, um zur Zulassungsliste von Google hinzugefügt zu werden. Einzelheiten zu diesem Vorgang finden Sie in der Dokumentation von Google. Nachdem der Vorgang abgeschlossen ist, gewährt Google Push-Bereitstellungsberechtigungen.
• Nachdem Google die Push-Bereitstellungsberechtigungen gewährt hat, kontaktieren Sie Stripe und geben Sie Ihren Anwendungsnamen, Ihre Anwendungs-ID, Ihr Kartennetzwerk und Ihren Kartennamen an, um diesen Schritt abzuschließen.

• Importieren Sie das private SDK von Google.
• Importieren Sie das SDK von Stripe.

dependencies {
  [... your dependencies]
  implementation 'com.stripe:stripe-android-issuing-push-provisioning:1.2.2'
}

Mehr Kontext finden Sie in den Code-Snippets und Verweisen auf die Beispiel-App bei jedem Schritt. Sehen Sie sich für diesen Schritt an, wie die Beispiel-App diese SDKs importiert.

• Bereiten Sie Ihr Backend für die Erstellung von temporären Schlüsseln für Ihre Karten vor. Weitere Informationen finden Sie im Abschnitt unten.
• Erstellen Sie einen EphemeralKeyProvider, der PushProvisioningEphemeralKeyProvider erweitert. Da der Anbieter eines temporären Schlüssels an eine andere Aktivität übergeben werden soll, muss dieser auch Parcelable implementieren (siehe Parcelable). Schauen Sie sich für zusätzlichen Kontext an, wie die Beispiel-App ihren EphemeralKeyProvider definiert.
• Implementieren Sie die Schaltfläche Zu Google Pay hinzufügen gemäß den Spezifikationen von Google. Die Beispiel-App enthält ein Beispiel für die Einhaltung der Branding-Richtlinien durch die Schaltfläche.

Um den Status der Karten Ihrer Nutzer/innen zu überprüfen, verwenden Sie listTokens(), um eine Liste aller Ihrer bereits auf dem Gerät vorhandenen Karten abzurufen. Vergleichen Sie den Wert von getFpanLastFour() für jedes zurückgegebene Objekt mit der Stripe-Eigenschaft last4) des Issued Card-Objekts für die Karte, die Sie hinzufügen möchten. Verwerfen Sie alle nicht übereinstimmenden Objekte aus der Antwortliste.

• Wenn die Ergebnisliste leer ist, bedeutet dies, dass die Karte, die Sie hinzufügen möchten, noch nicht auf dem Gerät vorhanden ist, Sie können mit der Anzeige der Schaltfläche wie unten beschrieben fortfahren.
• Wenn die Ergebnisliste ein TokenInfo-Objekt enthält, prüfen Sie seinen TokenState durch Aufruf von getTokenState().
  • Wenn der Status TOKEN_STATE_NEEDS_IDENTITY_VERIFICATION ist, hat Ihr/e Nutzer/in bereits versucht, die angegebenen Karte zu seinem/ihrem Gerät hinzuzufügen. Zeigen Sie die Schaltfläche Zu Google Pay hinzufügen an. Helfen Sie den Nutzer/innen jedoch dabei, diese Situation zu beheben, indem Sie den Listener onActivityResult mit der Methode tokenize() verbinden, wie in der Dokumentation von Google beschrieben.
  • Bei einem anderen Status ist die Karte bereits auf dem Gerät vorhanden. Zeigen Sie keine Google Pay-Schaltfläche an.

Stellen Sie Stripe unbedingt Ihre Anwendungs-ID zur Verfügung, bevor Sie mit den internen Tests beginnen. Die Einrichtung kann mehr als eine Woche dauern, und die Folgen einer unvollständigen Einrichtung sind unter anderem inkonsistente Antworten auf diese beiden Methoden. Das Ergebnis von listTokens() enthält nur Karten, die hinzugefügt wurden, nachdem Stripe die Einrichtung abgeschlossen hat.

• Wenn ein/e Nutzer/in auf die Schaltfläche klickt, wird die PushProvisioningActivity von Stripe mit dem PushProvisioningActivityStarter gestartet.

new PushProvisioningActivityStarter(
  this, // The Activity or Fragment you are initiating the push provisioning from
  new PushProvisioningActivityStarter.Args(
  "Stripe Card", // The name that will appear on the push provisioning UI
  ephemeralKeyProvider, // Your instance of EphemeralKeyProvider
  false // If you want to enable logs or not
)).startForResult();

Schauen Sie sich für zusätzlichen Kontext an, wie die Beispiel-App PushProvisioningActivity einführt.

Dadurch wird das Push-Provisioning vorbereitet und die Nutzeroberfläche aufgerufen, um die Karte der Geldbörse hinzuzufügen. Implementieren Sie den Callback in Ihrem onActivityResult.

protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
  if (requestCode == PushProvisioningActivityStarter.REQUEST_CODE) {
    if (resultCode == PushProvisioningActivity.RESULT_OK) {
      PushProvisioningActivityStarter.Result success = PushProvisioningActivityStarter.Result.fromIntent(data);
    } else if (resultCode == PushProvisioningActivity.RESULT_ERROR) {
      PushProvisioningActivityStarter.Error error = PushProvisioningActivityStarter.Error.fromIntent(data);
    }
  }
}

Schauen Sie sich für zusätzlichen Kontext an, wie die Beispiel-App onActivityResult implementiert.

Wenn die Bereitstellung erfolgreich war, erhalten Sie ein PushProvisioningActivityStarter.Result mit einer cardTokenId, der ID von Google für die Karte in der aktiven Geldbörse. Mit dieser ID können Sie auch die anderen Funktionen der Geldbörse nutzen.

Wenn bei der Bereitstellung ein Fehler auftritt, wird ein PushProvisioningActivityStarter.Error mit einem code und einer message zurückgegeben. Bei der message handelt es sich um eine entwicklerfreundliche Erläuterung des Fehlers. Der code kann die folgenden Werte haben:

Die Implementierung von Push-Provisioning sieht Methoden vor, bei denen Sie mit Ihrem eigenen Backend kommunizieren müssen, um einen temporären Stripe-Schlüssel zu erstellen und einen JSON-Code davon an Ihre App zurückzugeben. Bei diesen Schlüsseln handelt es sich um kurzlebige API-Zugangsdaten, die Sie zum Abrufen der verschlüsselten Kartendaten für eine einzelne Instanz eines Kartenobjekts verwenden können.

Um sicherzustellen, dass das von der Stripe-API zurückgegebene Objekt mit der von Ihnen verwendeten Version des iOS oder Android SDK kompatibel ist, informiert Sie das Stripe SDK über seine bevorzugte API-Version. Sie müssen diese API-Version bei der Erstellung des Schlüssels explizit an unsere API übergeben.

curl https://api.stripe.com/v1/ephemeral_keys \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "issuing_card"="{{ISSUING_CARD_ID}}" \
  -H "Stripe-Version: {{API_VERSION}}"

{
    "id": "ephkey_1G4V6eEEs6YsaMZ2P1diLWdj",
    "object": "ephemeral_key",
    "associated_objects": [
        {
            "id": "ic_1GWQp6EESaYspYZ9uSEZOcq9",
            "type": "issuing.card"
        }
    ],
    "created": 1586556828,
    "expires": 1586560428,
    "livemode": false,
    "secret": "ek_test_YWNjdF8xRmdlTjZFRHelWWxwWVo5LEtLWFk0amJ2N0JOa0htU1JzEZkd2RpYkpJdnM_00z2ftxCGG"
}

Schauen Sie sich für zusätzlichen Kontext an, wie das Beispiel-Backend einen temporären Stripe-Schlüssel erstellt.

Alle Tests müssen im Live-Modus mit Live-Karten und auf physischen Geräten durchgeführt werden.