Table of Contents

Pourquoi Apple Pay compte pour votre application iOS E-Commerce

Apple Pay est devenu une attente standard parmi les utilisateurs iOS, avec des millions de personnes l'utilisant quotidiennement sur les applications et les sites Web. En intégrant Apple Pay dans votre application e-commerce, vous utilisez une méthode de paiement que les utilisateurs font déjà confiance et préfèrent. Le résultat est un processus de transaction sans friction qui peut réduire les taux d'abandon des chariots et augmenter les valeurs moyennes de commande. Pour les commerçants utilisant un CMS sans tête comme Directus, l'intégration Apple Pay devient encore plus puissante lorsqu'elle est combinée avec une architecture de backend flexible qui peut gérer des flux de paiement complexes.

Avantages essentiels de l'intégration Apple Pay

Friction de départ réduite

La commande mobile moyenne prend presque une minute pour terminer lorsque les utilisateurs doivent saisir manuellement les détails de la carte, les adresses de facturation et les informations d'expédition. Apple Pay réduit cette durée à quelques secondes. Les utilisateurs authentifient avec Face ID ou Touch ID, et le jeton de paiement est transmis instantanément. Cette vitesse est directement corrélée avec des taux de conversion plus élevés. La documentation officielle d'Apple indique que les entreprises voient une augmentation moyenne de conversion de 30 à 40% après la mise en œuvre d'Apple Pay.

Sécurité qui renforce la confiance

Apple Pay utilise la tokenisation pour remplacer les numéros de carte par des numéros de compte uniques. Chaque transaction est autorisée par un code de sécurité dynamique unique. Les détails de la carte ne sont jamais stockés sur l'appareil ou transmis au serveur du marchand. Cette architecture réduit considérablement le risque de violation des données et de fraude.

Valeurs moyennes de commande plus élevées

Lorsque le processus de paiement est sans effort, les utilisateurs sont plus susceptibles de réaliser des achats plus importants. Les données de plusieurs plateformes de commerce électronique indiquent que les utilisateurs d'Apple Pay ont tendance à dépenser plus par transaction que les utilisateurs qui optent pour les méthodes de paiement traditionnelles.

Adoption et attentes de l'utilisateur

Apple Pay est pris en charge sur plus d'un milliard d'appareils dans le monde entier. Les utilisateurs qui ont activé Apple Pay sur leurs appareils s'attendent à l'utiliser partout où ils magasinent. Ne pas offrir Apple Pay dans votre application iOS peut être un désavantage concurrentiel, surtout si vos concurrents déjà le support.

Planification de votre intégration Apple Pay

Prérequis et exigences techniques

Avant d'écrire un code, vous devez vous assurer que votre environnement de développement et votre configuration d'entreprise répondent aux exigences d'Apple. Vous devez avoir un abonnement au programme Apple Developer actif, qui coûte 99 $ par année. Vous avez également besoin d'un identifiant de marchand enregistré auprès d'Apple, qui identifie votre entreprise dans l'écosystème Apple Pay. De plus, vous avez besoin d'un processeur de paiement qui prend en charge Apple Pay.

Comprendre le flux de paiement

Le flux de transaction Apple Pay comporte plusieurs étapes qui se produisent dans les coulisses. Lorsqu'un utilisateur touche le bouton Apple Pay, le système présente une feuille de paiement indiquant le résumé de commande, les options d'expédition et la carte par défaut de l'utilisateur. Après authentification, Apple crée un jeton de paiement qui inclut des données de transaction chiffrées. Votre application envoie ce jeton à votre moteur de paiement, qui le transmet à votre processeur de paiement. Le processeur déchiffre le jeton et traite la charge.

Votre moteur de paiement confirme ensuite l'état de la transaction et met à jour l'état de commande.

Directus et Apple Pay : une combinaison pratique

Directus fournit une couche de données flexible pour votre application e-commerce. Vous pouvez stocker des informations sur les produits, des profils d'utilisateurs, des antécédents de commande et des métadonnées de paiement dans Directus tout en gardant la logique de traitement de paiement dans votre application iOS et votre backend. Cette séparation de préoccupations vous permet de mettre à jour les prix, les descriptions et la disponibilité des produits via Directus sans toucher le code de paiement. Par exemple, lorsqu'un utilisateur sélectionne des produits et passe à la commande, votre application récupère les dernières données de produit de Directus, calcule les totaux, puis lance le flux Apple Pay.

Guide d'intégration étape par étape

Étape 1: Configurer votre compte Apple Developer

Connectez-vous au Portail Apple Developer et naviguez vers les certificats, les identifiants & Profiles. Sous Identificateurs, enregistrez un nouvel ID marchand. Cet identifiant représente votre entreprise unique pour les transactions Apple Pay. Vous aurez besoin de cet ID marchand lors de la configuration de votre application dans Xcode et lors de la génération du certificat de traitement de paiement.

Étape 2 : Générer des certificats et des clés

Dans le portail Apple Developer, créez un certificat de traitement des paiements pour votre identifiant marchand. Ce certificat valide votre identité lors du traitement des paiements. Téléchargez le certificat et téléchargez-le dans le tableau de bord de votre processeur de paiement. La plupart des processeurs fournissent une zone dédiée aux identifiants Apple Pay où vous pouvez coller le contenu du certificat. Certains processeurs exigent également un certificat d'identité marchand pour le chiffrement des données de paiement sur l'appareil.

Le guide de configuration d'environnement d'Apple passe en détail dans chaque type de certificat.

Étape 3: Activer la capacité de paiement d'Apple dans Xcode

Ouvrez votre projet dans Xcode et naviguez vers l'onglet Signing & Capabilités. Cliquez sur le bouton plus pour ajouter une nouvelle capacité et sélectionnez Apple Pay. Xcode mettra automatiquement à jour votre fichier de droits pour inclure le droit Apple Pay. Ajoutez votre identifiant marchand dans la section Apple Pay des paramètres de capacité. Si vous avez plusieurs identifiants marchands pour différentes entités commerciales, vous pouvez les lister tous, mais votre code devrait renvoyer le bon pour chaque demande de paiement.

Étape 4: Importer PassKit et créer une demande de paiement

Le cadre PassKit fournit toutes les classes nécessaires à l'intégration Apple Pay. Importez PassKit dans votre controller de vue de caisse. Créez un objet PKPaymentRequest et configurez ses propriétés. Définissez l'identificateur de marchand pour correspondre à celui enregistré dans le Portail de développement. Spécifiez les réseaux de paiement supportés tels que Visa, Mastercard, Amex et Discover. Définissez les capacités de marchand; au minimum, incluez .capability3DS pour supporter l'authentification sécurisée à trois domaines.

Ajoutez des éléments de résumé de paiement qui représentent les éléments de ligne dans la commande, y compris le sous-total, l'expédition, la taxe et le total final.

Voici un exemple pratique de configuration d'une demande de paiement :

import PassKit

let paymentRequest = PKPaymentRequest()
paymentRequest.merchantIdentifier = "merchant.com.yourcompany.app"
paymentRequest.supportedNetworks = [.amex, .masterCard, .visa, .discover]
paymentRequest.merchantCapabilities = [.capability3DS, .capabilityEMV]
paymentRequest.countryCode = "US"
paymentRequest.currencyCode = "USD"

let item1 = PKPaymentSummaryItem(label: "Product Name", amount: NSDecimalNumber(string: "49.99"))
let tax = PKPaymentSummaryItem(label: "Tax", amount: NSDecimalNumber(string: "4.50"))
let shipping = PKPaymentSummaryItem(label: "Shipping", amount: NSDecimalNumber(string: "5.99"))
let total = PKPaymentSummaryItem(label: "Your Store Name", amount: NSDecimalNumber(string: "60.48"))
paymentRequest.paymentSummaryItems = [item1, tax, shipping, total]

Étape 5 : Présentez le feuillet de paiement de la paye Apple

Après avoir configuré la demande de paiement, vérifiez si l'appareil de l'utilisateur supporte Apple Pay et s'il a des cartes admissibles. Utilisez PKPaymentAutorisationViewController pour présenter la feuille de paiement. Il s'agit d'une interface utilisateur fournie par le système qui maintient l'apparence et la sensation d'Apple Pay. Présentez-la de façon modulable sur votre écran de caisse. Le contrôleur de vue gère la sélection de la carte, l'entrée d'adresse d'expédition et l'authentification biométrique en votre nom.

Vous n'avez pas besoin de construire vous-même cette interface utilisateur.

Pour vérifier le support du dispositif et présenter la feuille:

if PKPaymentAuthorizationViewController.canMakePayments(usingNetworks: paymentRequest.supportedNetworks) {
 let authorizationVC = PKPaymentAuthorizationViewController(paymentRequest: paymentRequest)
 authorizationVC?.delegate = self
 present(authorizationVC, animated: true, completion: nil)
} else {
 // Fallback to manual card entry or show a message
}

Étape 6 : Gérer l'autorisation de paiement

Implémenter les méthodes PKPaymentAuthorizationViewControllerDelegate pour gérer le résultat de paiement. Le délégué reçoit un jeton de paiement après l'autorisation réussie. Extraire les données de jeton et les envoyer à votre serveur de backend. Votre serveur transmet ensuite le jeton à votre processeur de paiement pour la création de charge. Après la confirmation de la charge, rejettez la feuille de paiement et mettez à jour l'interface utilisateur de votre application pour afficher la confirmation de commande.

Mise en œuvre de la méthode de délégation clé:

func paymentAuthorizationViewController(_ controller: PKPaymentAuthorizationViewController, didAuthorizePayment payment: PKPayment, handler completion: @escaping (PKPaymentAuthorizationResult) -> Void) {
 let token = payment.token
 // Send token to your backend for processing
 // On success, call completion with .success
 // On failure, call completion with .failure
 completion(PKPaymentAuthorizationResult(status: .success, errors: nil))
}

Étape 7 : Configurer les options de transport et de facturation

Apple Pay prend en charge la sélection dynamique des adresses d'expédition et les mises à jour des méthodes d'expédition. Vous pouvez configurer les méthodes d'expédition dans la demande de paiement et mettre en œuvre des méthodes de délégation qui recalculent les totaux lorsque l'utilisateur change son adresse d'expédition ou choisit une autre option d'expédition. Cela fournit une expérience de paiement en temps réel sans exiger de l'utilisateur de quitter la feuille Apple Pay.

Étape 8: Test avec l'environnement de la boîte à sable

Apple fournit un environnement de sandbox pour tester Apple Pay sans argent réel. Créez un compte de test sandbox dans le portail Apple Developer. Utilisez les numéros de carte de test fournis par Apple pour simuler différents types de cartes et scénarios. Installez votre application construite avec un certificat de développement sur un appareil physique. Vérifiez que la feuille de paiement apparaît correctement, que toutes les options réseau sont affichées, que les calculs d'expédition fonctionnent, et que l'autorisation réussit.

Intégration avec votre moteur et Directus

Envoi de jetons de paiement à votre serveur

Après avoir reçu le jeton de paiement d'Apple Pay, votre application iOS doit le transmettre à votre serveur de sauvegarde en toute sécurité. Utilisez HTTPS avec une authentification appropriée. Le jeton contient un objet opaque de données de paiement que votre processeur de paiement déchiffre. Votre serveur doit valider le jeton, créer une charge en utilisant le SDK de votre processeur, et retourner une réponse de succès ou d'échec.

Stocker les données de commande dans Directus

Directus vous permet de définir des collections personnalisées qui correspondent à votre modèle de données de commerce électronique. Créez des collections pour les commandes, les commandes et les paiements. Lorsqu'une transaction est terminée, votre moteur de recherche écrit les données de commande à Directus via son API REST ou GraphQL. Vous pouvez stocker des métadonnées spécifiques à Apple Pay telles que le réseau de paiement utilisé, les quatre derniers chiffres du numéro de compte de l'appareil et l'ID de la transaction.

Traitement des Webhooks à partir des processeurs de paiement

La plupart des processeurs de paiement envoient des webhooks pour informer votre moteur de paiement des événements tels que les succès de charge, les échecs et les remboursements. Votre moteur de paiement doit gérer ces webhooks et mettre à jour les enregistrements de commande correspondants dans Directus. Par exemple, lorsqu'un frais est remboursé, votre gestionnaire webhook met à jour l'état de commande à rembourser dans Directus. Cela maintient votre système synchronisé avec l'état du processeur de paiement.

Considérations avancées

Soutien à plusieurs devises et localités

Si votre application e-commerce fonctionne dans plusieurs pays, configurez la demande de paiement avec le code pays et le code monnaie appropriés en fonction de l'emplacement de l'utilisateur ou de la configuration du magasin. Apple Pay prend en charge plus de 60 pays et régions. Assurez-vous que votre processeur de paiement peut gérer les devises que vous envisagez d'accepter.

Mise à jour des prix des produits en temps réel

Les prix des produits peuvent changer en raison de promotions, de fluctuations de devises ou de ajustements de stocks. Depuis Directus sert de source de contenu et de données, votre application récupère les prix actuels des produits avant de présenter la feuille Apple Pay. Cela empêche l'utilisateur de voir un prix dans le catalogue de produits et un prix différent à la caisse. Implémentez un mécanisme de rafraîchissement qui synchronise le dernier panier total chaque fois que l'utilisateur atteint l'écran de caisse.

Gestion des erreurs et rétroaction de l'utilisateur

Les erreurs de paiement peuvent se produire pour de nombreuses raisons : problèmes de réseau, déclin de carte, pannes de processeur ou jetons invalides. Fournissez des messages d'erreur clairs et actionnables dans votre application. Évitez le jargon technique. Si un paiement échoue, laissez l'utilisateur réessayer Apple Pay ou revenir à l'entrée manuelle de la carte.

Stratégie d'essai pour la préparation à la production

Essais de boîtes à sable

Utilisez la boîte de sable Apple Pay pour simuler des transactions sans risque financier. Testez avec différents types de cartes, dont Visa, Mastercard et Amex. Vérifiez que la feuille de paiement affiche les totaux corrects et les options d'expédition. Testez avec différents appareils Apple et versions iOS. Confirmez que vos méthodes de délégation traitent correctement l'autorisation, l'annulation et les erreurs.

Répétez les tests après avoir modifié votre configuration ou code de paiement.

Essais bêta internes

Avant de sortir à la production, exécutez des tests bêta internes avec les utilisateurs réels d'Apple Pay. Utilisez TestFlight pour distribuer l'application à un petit groupe de testeurs. Recueillez vos commentaires sur le flux de caisse et surveillez les taux de réussite des transactions. Vérifiez que les données de l'ordre se peuplent correctement dans Directus. Vérifiez que les événements webhook mettent à jour l'état de l'ordre correctement.

Surveillance de la production

Après avoir lancé Apple Pay, surveillez les paramètres de transaction dans votre tableau de bord du processeur de paiement et dans Directus. Suivez le nombre de transactions Apple Pay, la valeur moyenne de transaction, les taux de défaillance et les codes d'erreur.

Pièges courants et comment les éviter

Configuration de l'ID de marchand manquant

Un problème fréquent est un identifiant marchand incorrect ou manquant dans le fichier de droits ou dans le code de demande de paiement. Vérifiez que la chaîne d'identifiants marchand correspond exactement à ce que vous avez enregistré dans le Portail développeur. Vérifiez que la capacité Apple Pay est activée pour toutes les cibles de l'application qui l'utilisent.

Mise en œuvre incomplète du délégué au paiement

Si vos méthodes de délégation ne sont pas entièrement mises en œuvre, la feuille de paiement peut ne pas être correctement rejetée ou l'autorisation peut être suspendue. Implémentez à la fois le gestionnaire d'autorisation et la méthode de délégation de congé.

Problèmes de configuration du réseau

Apple Pay nécessite un accès réseau pour vérifier les informations de la carte de l'appareil et pour traiter les transactions. Si votre application utilise un pare-feu ou une configuration de réseau personnalisée, assurez-vous qu'Apple Pay ne bloque pas le trafic. Testez sur différents types de réseau, y compris le Wi-Fi et le cellulaire pour confirmer un fonctionnement fiable.

Examens finaux

L'intégration d'Apple Pay dans votre application iOS e-commerce est l'une des améliorations les plus importantes que vous pouvez apporter aux taux de conversion mobiles. La combinaison de vitesse, sécurité et confiance des utilisateurs crée une expérience de paiement que les utilisateurs apprécient et reviennent à. Lorsque jumelé à un moteur flexible comme Directus, vous gardez le contrôle total de votre produit et de vos données de commande tout en fournissant un flux de paiement de classe mondiale. Commencez par les étapes décrites dans ce guide, testez soigneusement et itérer sur la base du comportement réel de l'utilisateur.