Intégrer Apple Pay sur mobile

Prérequis

Pour intégrer Apple Pay via notre SDK de paiement, 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 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

Nous vous recommandons de faire l'initialisation du SDK dès le lancement de vote application. Cela vous permet de configurer le SDK avec vos données.

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 du marchand à afficher sur la modale Apple Pay au niveau du label "Payer"	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 en valorisant l'option PaymentMethodType par LyraPaymentMethods.ALL, le moyen de paiement Apple Pay s'affiche directement 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 par LyraPaymentMethods.applePay. Lorsque l'utilisateur va cliquer sur le bouton Apple Pay, le SDK va déclencher directement l'affichage de Apple Pay.

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

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