Apple Pay

Apple Pay permet aux clients de finaliser leurs achats via les publicités Shoppable Ads en utilisant Apple Pay directement dans le placement Rokt. Le SDK Rokt gère la création de session Apple Pay, la présentation de la feuille de paiement et le traitement du paiement. La marque du catalogue Rokt est le marchand enregistré (MoR).

Apple Pay est pris en charge sur le web et iOS, avec un support supplémentaire pour d'autres plateformes prévu.

Aperçu de la séquence

1. Chargement du placement. Après que le client a terminé sa transaction, le placement Rokt Shoppable Ads s'affiche sur la page de confirmation.
2. Vérification de l'éligibilité. Le SDK Rokt détermine si Apple Pay est disponible sur l'appareil du client. Si ce n'est pas pris en charge, le placement revient à d'autres méthodes de paiement éligibles (par exemple, transfert de carte).
3. Offre affichée. Le placement affiche l'offre avec l'appel à l'action de paiement approprié en fonction des méthodes de paiement disponibles.
4. Le client appuie sur "Payer avec Apple Pay". La feuille de paiement Apple Pay est présentée, montrant les détails de l'article, le prix (y compris les taxes et l'expédition), et le nom du marchand de la marque.
5. Autorisation du client. Le client s'authentifie via Face ID, Touch ID ou le code d'accès de l'appareil.
6. Paiement traité. Rokt traite le paiement avec la marque en tant que MoR. Un écran de confirmation s'affiche dans le placement.
7. Fermeture du placement. Le flux post-confirmation standard du partenaire continue.

REMARQUE : Si aucune offre éligible n'est disponible ou si aucune méthode de paiement prise en charge n'est détectée, le placement se ferme sans afficher d'offre.

Attributs requis

Apple Pay utilise les attributs standard passés lors de l'initialisation du SDK. Pour la liste complète, voir les attributs recommandés dans le Guide d'intégration du SDK.

L'attribut suivant est utilisé pour la sélection de la méthode de paiement Apple Pay :

Attribut	Type	Requis	Description
payment_type	chaîne	Oui	La méthode de paiement que le client a utilisée pour sa transaction initiale (par exemple, visa, mastercard, amex, apple_pay, paypal). Rokt utilise cela pour déterminer la priorité de la méthode de paiement. Si le client a payé avec Apple Pay, cela est affiché comme l'appel à l'action principal.

REMARQUE : Si votre plateforme ne dispose pas des détails de l'adresse de livraison disponibles (par exemple, achats de billets ou de biens numériques), transmettez les détails de l'adresse de facturation à la place. Rokt fournira une interface utilisateur pour que le client confirme ou modifie son adresse de livraison avant de finaliser l'achat.

Configuration Web

Rokt gère l'enregistrement de domaine, la configuration des marchands et le traitement des paiements pour Apple Pay de bout en bout. Les partenaires utilisant SDK+ n'ont besoin d'aucune configuration supplémentaire. Les partenaires utilisant l'ancien SDK doivent activer l'extension Apple Pay comme décrit ci-dessous.

Extensions SDK (Ancien SDK uniquement)

Si vous utilisez l'ancien Rokt Web SDK (launcher.js), ajoutez payments-stripe-applepay au paramètre de requête extensions lors du chargement du script SDK. Si vous utilisez également le transfert de carte, incluez les deux extensions :

script.src = "https://apps.rokt.com/wsdk/integrations/launcher.js?extensions=instant-purchase,payments-stripe-applepay";

• payments-stripe-applepay - active Apple Pay comme méthode de paiement sur les emplacements Shoppable Ads.
• instant-purchase - active le transfert de carte comme méthode de paiement sur les emplacements Shoppable Ads.

REMARQUE : Si vous utilisez SDK+ (versions après 2.5926.0), les extensions sont activées automatiquement et aucune modification de script n'est requise.

Compatibilité des navigateurs et des appareils

Navigateur	Plateforme	Support Apple Pay	Remarques
Safari 17+	iOS 17+, macOS 12+	Pris en charge	Apple Pay natif.
Safari (plus ancien)	iOS, macOS	Limité	Même origine uniquement.
Chrome	iOS	Pris en charge	Apple Pay est basé sur l'appareil sur iOS. Fonctionne de la même manière que Safari.
Chrome	Bureau (macOS)	Non pris en charge	Rokt se rabat sur d'autres méthodes de paiement.
Chrome / Firefox	Windows, Android	Non pris en charge	Rokt se rabat sur d'autres méthodes de paiement.

Rokt détecte automatiquement la compatibilité des navigateurs et des appareils et n'affichera le bouton Apple Pay que là où il est pris en charge. Aucune logique de filtrage supplémentaire n'est requise de la part du partenaire.

REMARQUE : Les emplacements Shoppable Ads sont généralement rendus directement sur la page, et non dans une iframe. Cela est nécessaire pour qu'Apple Pay fonctionne correctement. Si votre intégration rend l'emplacement Rokt à l'intérieur d'une iframe, contactez votre gestionnaire de compte Rokt pour discuter des exigences de configuration supplémentaires.

Configuration iOS

Les étapes ci-dessous configurent Apple Pay pour toute intégration basée sur iOS (iOS natif, React Native, Flutter, etc.). Après avoir terminé ces étapes, retournez à votre guide d'intégration SDK pour enregistrer l'extension de paiement.

Créer un identifiant de marchand

1. Connectez-vous au Portail des développeurs Apple.
2. Sous Identifiants, sélectionnez Identifiants de marchand dans le menu déroulant.
3. Cliquez sur le bouton + pour enregistrer un nouvel identifiant de marchand.
4. Entrez une description (par exemple, "Rokt Apple Pay") et un identifiant unique dédié à Rokt (par exemple, merchant.com.yourapp.rokt).
5. Cliquez sur Continuer, puis sur Enregistrer.

remarque

Créez un nouvel identifiant de marchand dédié à Rokt. Si votre application utilise déjà Apple Pay pour son propre paiement, ne réutilisez pas cet identifiant de marchand — chaque identifiant de marchand ne prend en charge qu'un seul certificat de traitement des paiements, et le téléchargement du CSR de Rokt écraserait votre certificat existant.

Pour plus de détails, consultez le guide d'Apple Configuration d'Apple Pay.

Activer Apple Pay dans Xcode

1. Ouvrez votre projet dans Xcode et sélectionnez la cible de votre application.
2. Allez à l'onglet Signing & Capabilities.
3. Cliquez sur + Capability et ajoutez Apple Pay.
4. Sélectionnez l'ID marchand que vous avez créé (par exemple, merchant.com.yourapp.rokt) dans la liste.

Si l'ID marchand n'apparaît pas, assurez-vous que votre compte Apple Developer est lié dans Xcode sous Settings > Accounts.

Générer un certificat de traitement des paiements

1. Demandez une requête de signature de certificat (CSR) à Rokt — votre gestionnaire de compte Rokt vous fournira un CSR généré par Stripe.
2. Dans le Portail des développeurs Apple, sélectionnez votre ID marchand.
3. Sous Certificat de traitement des paiements Apple Pay, cliquez sur Créer un certificat.
4. Téléchargez le fichier CSR fourni par Rokt.
5. Téléchargez le fichier généré .cer et partagez-le avec votre gestionnaire de compte Rokt.

attention

Le certificat de traitement des paiements expire tous les 25 mois. Apple enverra des rappels d'expiration à l'adresse e-mail de votre compte Apple Developer. Lors du renouvellement, demandez un nouveau CSR à votre gestionnaire de compte Rokt et répétez les étapes ci-dessus.

Liste de contrôle

Web

• Si vous utilisez le SDK hérité : payments-stripe-applepay ajouté au paramètre de requête extensions
• Attribut payment_type passé à chaque lancement d'expérience Rokt
• Tests de bout en bout complétés sur Safari 17+ (iOS ou macOS)

iOS

• ID marchand créé dans le Portail des développeurs Apple
• Capacité Apple Pay ajoutée dans Xcode avec le bon ID marchand
• Certificat de traitement des paiements généré et partagé avec Rokt
• Extension de paiement enregistrée dans votre intégration SDK (voir votre guide SDK : iOS | React Native)
• Tests de bout en bout complétés sur un appareil iOS physique