Intégrer Apple Pay sur mobile

Prérequis

Pour intégrer Apple Pay via notre SDK mobile, vous devez :

• Souscrire à l'offre Scellius incluant Apple Pay. Contactez votre interlocuteur commercial.
• Paramétrer votre contrat Apple Pay. Consultez le guide d'intégration Apple Pay.
• Appliquer les prérequis sur l'intégration du SDK mobile.

Principe de fonctionnement

Activer la fonctionnalité Apple Pay dans votre application

Avant l’initialisation du SDK mobile, vous devez activer la fonctionnalité (capability) Apple Pay dans votre application et l’associer à l’identifiant marchand Apple Pay.

1. Choisissez la cible (target) de l’application dans Xcode.
2. Cliquez sur l'onglet Signing & Capabilities dans l’éditeur de projet.
3. Dans la barre d’outils, cliquez sur le bouton Library (+) pour ouvrir la bibliothèque de Capabilities.
4. Sélectionnez la fonctionnalité Apple Pay.
5. Dans la fonction Apple Pay, cliquez sur le bouton d’actualisation pour synchroniser vos identifiants de marchand à partir du site Apple Developer.
6. Une fois la synchronisation faite, sélectionnez le numéro Apple Merchant Identifier à utiliser avec votre application.

Initialiser le SDK mobile pour intégrer Apple Pay

1. Importez le framework import LyraPaymentSDK.
2. Appelez la méthode initialize avec ces paramètres :

   Il est nécessaire d'effectuer l'initialisation du SDK mobile au lancement de votre application, dans la méthode didFinishLaunchingWithOptions de votre AppDelegate.

   Paramètre	Format	Description	Exemple
   publicKey	String	2e clé du tableau des clés API REST.	42229744:testpublickey_tPXxrUVsoGkggk9LuO8o0PBRdWg8jWUhWmYMURwCbc8ap
   configurationOptions	[String: Any]	Dictionnaire qui définit le comportement du SDK mobile.	Voir étape suivante.

3. Configurez le dictionnaire configurationOptions avec ces paramètres :

   Clés	Format	Description	Exemple
   apiServerName	String	1e donnée du tableau des clés API REST. Obligatoire	https://api.scelliuspaiement.labanquepostale.fr
   applePayMerchantName	String	Nom de la boutique à afficher sur la fenêtre modale Apple Pay au dessus du montant. Obligatoire.	MERCHANT_NAME
   applePayMerchantId	String	Numéro de contrat Apple Pay. Obligatoire.	APPLE_MERCHANT_ID
   cardScanningEnabled	Bool	Active/Désactive la fonctionnalité de scan de la carte. Voir : Fonctions du scan de la carte ou du NFC. Facultatif.	True

Choisir dans le SDK mobile comment afficher le bouton Apple Pay

• Si vous avez déjà intégré des moyens de paiement via notre SDK mobile iOS avec l'option PaymentMethodType valorisée à LyraPaymentMethods.ALL, Apple Pay s'affiche automatiquement dans le parcours d'achat lorsque l'acheteur clique sur Payer.

  LyraPaymentMethods.ALL est la valeur par défaut. Elle permet l'ouverture du sélecteur de moyen de paiement avec tous les moyens de paiement disponibles. Voir : guide d'intégration iOS.

• Si vous souhaitez remplacer le bouton Payer dans votre application par le bouton de paiement Apple Pay, vous devez valoriser l'option PaymentMethodType à LyraPaymentMethods.applePay.

  Lorsque l'utilisateur clique sur le bouton Apple Pay, le SDK mobile déclenche automatiquement l'affichage de la page de paiement Apple Pay.