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.
- Choisissez la cible (target) de l’application dans Xcode.
- Cliquez sur l'onglet Signing & Capabilities dans l’éditeur de projet.
- Dans la barre d’outils, cliquez sur le bouton Library (+) pour ouvrir la bibliothèque de Capabilities.
- Sélectionnez la fonctionnalité Apple Pay.
- Dans la fonction Apple Pay, cliquez sur le bouton d’actualisation pour synchroniser vos identifiants de marchand à partir du site Apple Developer.
- 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
- Importez le framework
import LyraPaymentSDK
dans votre application. - 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 Scellius
Pour obtenir des informations sur le paramétrage d'un contrat Apple Pay depuis la plateforme