Intégrer Apple Pay sur mobile

Prérequis

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

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

Principe de fonctionnement

Activer la fonctionnalité Apple Pay dans votre application

Avant l’initialisation du SDK, 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 pour intégrer Apple Pay

1. Importez le framework import LyraPaymentSDK dans votre application.
2. Appelez la méthode initialize avec les paramètres suivants :

Paramètre	Format	Description
publicKey	string	Renseignez votre clé publique (2 ème clé du tableau des clés API REST)
configurationOptions	[String: Any]	Dictionnaire pour configurer le comportement du SDK.

Pour le dictionnaire configurationOptions, utilisez ces paramètres :

Clés	Format	Description	Requis
apiServerName	String	Valeur attendue : nom du serveur de l’API REST (1 ère donnée du tableau des clés API REST)	oui
applePayMerchantName	String	Valeur attendue : MERCHANT_NAME. Nom de la boutique à afficher sur la fenêtre modale Apple Pay au dessus du montant.	oui
applePayMerchantId	String	Valeur attendue : APPLE_MERCHANT_ID. Il s'agit de votre numéro de contrat Apple Pay.	oui
cardScanningEnabled	Bool	Active/Désactive la fonctionnalité de scan de la carte. Exemple : true	non

Choisir dans le SDK comment afficher le bouton Apple Pay

• Si vous avez déjà intégré des moyens de paiement via notre SDK 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 déclenche automatiquement l'affichage de la page de paiement Apple Pay.

Consulter le guide d'intégration Apple Pay depuis la plateforme Lyra

Pour obtenir des informations sur le paramétrage d'un contrat Apple Pay depuis la plateforme Lyra ou sur la façon de récupérer les informations de livraison de l'acheteur, voir : Guide d'intégration de Apple Pay.