Utiliser des portefeuilles électroniques avec Issuing

Stripe fournit un wrapper SDK autour d’une bibliothèque Google privée pour la mise en service de type push. Pour distribuer votre application sur le Google Pay Store avec la mise en service de type push, vous devez effectuer les actions suivantes :

• Demander un accès à Google Pay. Une fois le formulaire rempli, votre demande devrait être approuvée sous quelques heures ou une journée au plus tard.
• Après avoir reçu l’approbation, téléchargez le SDK privé TapAndPay de Google. La version 18 est la dernière version testée en date du SDK TapAndPay.
• Demandez un accès à l’API de mise en service de type push pour votre application. Vous devrez fournir votre ID d’application pour l’ajouter à la liste des adresses autorisées de Google. Pour en savoir plus sur ce processus, consultez la documentation de Google. Quand le processus est terminé, Google accorde des droits de mise en service de type push.
• Une fois que Google a accordé les droits de mise en service de type push, contactez Stripe en indiquant le nom et l’ID de votre application, le réseau de cartes et le nom de la carte pour effectuer cette étape.

• Importez le SDK privé de Google.
• Importez le SDK de Stripe.

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

Pour plus de contexte, consultez à chaque étape les extraits de code proposés et les renvois vers l’application test. Pour cette étape, observez comment l’application test importe ces SDK.

• Préparez votre back-end pour qu’il crée des clés éphémères pour vos cartes. Voir la section ci-dessous.
• Créez un EphemeralKeyProvider qui étend PushProvisioningEphemeralKeyProvider. Puisque le fournisseur de clés éphémères sera transmis à une autre activité, il doit également implémenter un attribut Parcelable (voir Parcelable). Pour plus de contexte, observez comment l’application test définit son EphemeralKeyProvider.
• Implémentez le bouton Ajouter à Google Pay selon les spécifications de Google. L’application test fournit un exemple de bouton respectant les directives relatives à l’image de marque.

Pour vérifier l’état des cartes de vos utilisateurs, utilisez listTokens() afin de récupérer la liste de toutes les cartes déjà présentes sur l’appareil. Comparez la valeur de getFpanLastFour() de chaque objet renvoyé avec la propriété Stripe last4 de l’objet Issued Card pour la carte que vous voulez ajouter. Éliminez de la liste tous les objets qui ne correspondent pas.

• Si la liste résultante est vide, cela signifie que la carte que vous souhaitez ajouter n’est pas encore présente sur l’appareil. Vous pouvez poursuivre la procédure décrite ci-dessous pour afficher le bouton.
• Si la liste résultante contient un objet TokenInfo, vérifiez son TokenState en appelant getTokenState().
  • Si cet état est TOKEN_STATE_NEEDS_IDENTITY_VERIFICATION, cela signifie que l’utilisateur a déjà essayé d’ajouter manuellement la carte en question sur son appareil. Affichez le bouton Ajouter à Google Pay, mais liez l’écouteur onActivityResult à la méthode tokenize() en suivant les instructions fournies dans la documentation de Google, afin que l’utilisateur puisse facilement régler le problème.
  • Tout autre état indique que la carte figure déjà sur l’appareil. N’affichez pas le bouton Google Pay.

Veillez à fournir votre ID d’application à Stripe avant de commencer les tests internes. La configuration peut prendre plus d’une semaine et une configuration incomplète aura notamment pour conséquence la réception de réponses incohérentes pour ces deux méthodes. La configuration par Stripe est terminée lorsque listTokens() donne pour résultat only contains cards added after.

• Lorsqu’un utilisateur touche le bouton, lancez la PushProvisioningActivity de Stripe à l’aide du PushProvisioningActivityStarter.

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();

Pour plus de contexte, observez comment l’application test lance PushProvisioningActivity.

Cela prépare la mise en service de type push et lance l’interface utilisateur permettant l’ajout de la carte au portefeuille. Implémentez le rappel dans votre 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);
    }
  }
}

Pour plus de contexte, observez comment l’application test implémenteonActivityResult.

Si la mise en service a abouti, vous recevrez un PushProvisioningActivityStarter.Result contenant un cardTokenId, qui est l’ID Google pour la carte dans le portefeuille actif. Vous pouvez utiliser les autres fonctions du portefeuille avec cet ID.

Si une erreur est survenue lors de la mise en service, une PushProvisioningActivityStarter.Error sera renvoyée avec un code et un message. Le message est un texte destiné au développeur expliquant l’erreur. Le code peut prendre les valeurs suivantes :

L’implémentation de la mise en service de type push expose des méthodes qui requièrent que vous communiquiez avec votre back-end pour créer une clé éphémère Stripe et renvoyer un JSON de celle-ci à votre application. Cette clé est un identifiant éphémère de l’API que vous pouvez utiliser pour récupérer les informations de carte chiffrées d’une instance unique d’un objet Card.

Pour garantir que l’objet renvoyé par l’API Stripe est compatible avec la version du SDK iOS ou Android que vous utilisez, le SDK Stripe vous indique quelle version d’API il privilégie. Vous devez explicitement transmettre cette version d’API à notre API lorsque vous créez la clé.

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

Pour plus de contexte, observez comment l’exemple de backend créée une clé Stripe éphémère.

Tous les tests doivent être réalisés en mode production, avec des cartes réelles et sur des appareils physiques.